Utiliser le panneau workspace

Ce guide montre comment parcourir, prévisualiser, éditer des fichiers et lancer des commandes à côté de la conversation. Il suppose qu'Ori tourne (voir le tutoriel de premiers pas).

Étapes

Cliquez sur ⊞ Workspace dans l'entête. Le panneau droit s'ouvre avec l'arborescence du répertoire de travail de l'agent (--cwd).
Prévisualiser un fichier : cliquez dessus dans l'arborescence. Le code s'affiche avec colorisation syntaxique ; les fichiers .md et .adoc s'ouvrent en version rendue, avec une bascule Rendered / Source dans l'entête du panneau. Les images (.png, .jpg/.jpeg, .gif, .webp, .svg, .bmp, .ico, .avif — y compris les exports draw.io .drawio.svg / .drawio.png) s'affichent à leur taille naturelle sur un damier, avec leurs dimensions en pixels en dessous. Les diagrammes enregistrés en XML .drawio / .dio se rendent dans le viewer diagrams.net, le XML restant accessible par Source.
Éditer un fichier : double-cliquez dessus dans l'arborescence (ou bouton Edit de la preview). Un ● signale les modifications non sauvées ; sauvegardez avec le bouton Save ou Ctrl/Cmd+S.
Ouvrir un terminal : sélectionnez l'onglet Terminal. Un vrai shell démarre dans le répertoire de travail ; il continue de tourner quand vous changez d'onglet ou repliez le panneau.
Redimensionner l'arborescence : faites glisser le fin trait vertical entre l'arborescence et les onglets. Il se colore au survol ; la colonne suit le pointeur entre 120 px et 800 px. Un double-clic sur le trait revient à la largeur par défaut (14rem).

Variantes

Le bouton ⟳ de l'arborescence relit le répertoire de travail après que l'agent a créé ou supprimé des fichiers.
Les fichiers binaires et les fichiers de plus de 5 Mio sont refusés par la preview et l'éditeur avec un message explicite ; les images font exception, diffusées par GET /api/raw sans plafond.
Le viewer draw.io est embed.diagrams.net, chargé dans une iframe et alimenté localement en XML par son protocole postMessage (le diagramme n'est envoyé nulle part). Dans un navigateur qui ne peut pas joindre cet hôte, le panneau le signale après quelques secondes et la vue Source reste disponible. Voir l'explication de l'architecture pour l'absence de rendu hors ligne.
Le shell vient de $SHELL (repli sur bash, puis sh) ; le redimensionnement est automatique.
Le séparateur de l'arborescence se manipule aussi au clavier : donnez-lui le focus avec Tab, puis ← / → le déplacent de 16 px, Début / Fin sautent à la largeur minimale / maximale. La largeur choisie est mémorisée par navigateur (clé localStorage ori.fileTreeWidth) et survit au rechargement de la page ; effacer les données du site rétablit la valeur par défaut.

Voir aussi

Endpoints et formats d'échange : référence de l'API workspace
Pourquoi les panneaux survivent aux changements d'onglet : explication : architecture

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24


# Utiliser le panneau workspace

Ce guide montre comment parcourir, prévisualiser, éditer des fichiers et lancer des commandes à côté de la conversation. Il suppose qu'Ori tourne (voir le [tutoriel de premiers pas](../tutorials/getting-started.md)).

## Étapes

1. Cliquez sur **⊞ Workspace** dans l'entête. Le panneau droit s'ouvre avec l'arborescence du répertoire de travail de l'agent (`--cwd`).
2. **Prévisualiser un fichier** : cliquez dessus dans l'arborescence. Le code s'affiche avec colorisation syntaxique ; les fichiers `.md` et `.adoc` s'ouvrent en version rendue, avec une bascule **Rendered / Source** dans l'entête du panneau. Les images (`.png`, `.jpg`/`.jpeg`, `.gif`, `.webp`, `.svg`, `.bmp`, `.ico`, `.avif` — y compris les exports draw.io `.drawio.svg` / `.drawio.png`) s'affichent à leur taille naturelle sur un damier, avec leurs dimensions en pixels en dessous. Les diagrammes enregistrés en XML `.drawio` / `.dio` se rendent dans le viewer diagrams.net, le XML restant accessible par **Source**.
3. **Éditer un fichier** : double-cliquez dessus dans l'arborescence (ou bouton **Edit** de la preview). Un **●** signale les modifications non sauvées ; sauvegardez avec le bouton **Save** ou **Ctrl/Cmd+S**.
4. **Ouvrir un terminal** : sélectionnez l'onglet **Terminal**. Un vrai shell démarre dans le répertoire de travail ; il continue de tourner quand vous changez d'onglet ou repliez le panneau.
5. **Redimensionner l'arborescence** : faites glisser le fin trait vertical entre l'arborescence et les onglets. Il se colore au survol ; la colonne suit le pointeur entre 120 px et 800 px. Un double-clic sur le trait revient à la largeur par défaut (14rem).

## Variantes

- Le bouton **⟳** de l'arborescence relit le répertoire de travail après que l'agent a créé ou supprimé des fichiers.
- Les fichiers binaires et les fichiers de plus de 5 Mio sont refusés par la preview et l'éditeur avec un message explicite ; les images font exception, diffusées par `GET /api/raw` sans plafond.
- Le viewer draw.io est `embed.diagrams.net`, chargé dans une iframe et alimenté localement en XML par son protocole postMessage (le diagramme n'est envoyé nulle part). Dans un navigateur qui ne peut pas joindre cet hôte, le panneau le signale après quelques secondes et la vue **Source** reste disponible. Voir l'[explication de l'architecture](../explanation/architecture.md) pour l'absence de rendu hors ligne.
- Le shell vient de `$SHELL` (repli sur bash, puis sh) ; le redimensionnement est automatique.
- Le séparateur de l'arborescence se manipule aussi au clavier : donnez-lui le focus avec **Tab**, puis **←** / **→** le déplacent de 16 px, **Début** / **Fin** sautent à la largeur minimale / maximale. La largeur choisie est mémorisée par navigateur (clé localStorage `ori.fileTreeWidth`) et survit au rechargement de la page ; effacer les données du site rétablit la valeur par défaut.

## Voir aussi

- Endpoints et formats d'échange : [référence de l'API workspace](../reference/workspace-api.md)
- Pourquoi les panneaux survivent aux changements d'onglet : [explication : architecture](../explanation/architecture.md)