Travailler avec les fichiers et le terminal d'un agent

Ce guide montre comment voir ce qu'un agent a produit, modifier ses instructions, supprimer un fichier et lancer des commandes dans son dossier. Il suppose que Sidekicks tourne avec une configuration qui contient des agents. Les libellés sont ceux de l'interface en anglais, sa langue par défaut.

Ouvrir le workspace d'un agent

Dans le panneau Agents, survolez l'agent et cliquez sur 📂.
Le centre affiche l'agent : son état, où il tourne (local · /chemin ou container nom · /chemin), les channels dont il est membre, et les onglets Files, Terminal, Log.
💬 Conversation ramène à la conversation directe ; cliquer sur un channel quitte aussi le workspace.

Lire et modifier un fichier

Dans Files, cliquez sur un dossier pour l'ouvrir, sur un fichier pour le lire. Les fichiers commençant par un point (.git, .mm…) et node_modules sont cachés : cochez Show hidden files pour les voir.
Modifiez le texte. ● modified apparaît ; Save (ou ⌘S) écrit le fichier, Revert remet ce qui est sur le disque.
Si l'agent modifie le fichier pendant que vous l'éditez, un bandeau le signale : Take their version le recharge (vos modifications sont perdues), Keep mine enregistre les vôtres par-dessus.

L'arbre et le fichier ouvert suivent seuls les changements de l'agent : un fichier qu'il crée apparaît en une seconde (deux dans un conteneur).

Prévisualiser un document ou une image

Les fichiers Markdown (.md), AsciiDoc (.adoc, .asciidoc, .asc) et HTML (.html, .htm) s'ouvrent sur leur Preview ; Edit montre le texte, Preview revient au rendu de ce qui est dans l'éditeur. Les images (.png, .jpg, .gif, .webp, .svg…) n'ont qu'un aperçu : cliquez sur l'image pour sa taille réelle, à nouveau pour l'ajuster.

Les images et liens relatifs au document sont cherchés dans le dossier de l'agent : un lien vers un autre fichier l'ouvre ici, un lien vers un site ouvre le navigateur.
Une page HTML est affichée dans un cadre qui n'exécute aucun script et n'atteint rien : ses images et feuilles de style du dossier y sont intégrées, ses liens ne font rien.
L'aperçu suit les changements de l'agent, comme l'éditeur.

Ouvrir un fichier dont un agent donne le lien dans sa réponse

Quand un agent écrit un document et donne un lien vers lui dans sa réponse, cliquez sur le lien : le fichier s'ouvre dans un panneau à droite de la conversation, qui reste visible.

Le panneau prévisualise le Markdown, l'AsciiDoc, le HTML et les images comme ci-dessus, et affiche tout autre fichier texte tel quel. Les liens du document vers d'autres fichiers du dossier s'ouvrent dans le même panneau.
📂 Afficher l'emplacement ouvre le Finder (macOS) ou l'Explorateur (Windows) avec le fichier sélectionné. Il n'apparaît que si le dossier de l'agent est sur cet ordinateur : un agent sur cet ordinateur, ou dans un conteneur ou une sandbox dont le dossier est monté depuis celui-ci.
Ouvrir dans les fichiers de l'agent montre le fichier dans l'onglet Files, pour le modifier. ↻ le relit après un changement de l'agent.
× ou Échap ferme le panneau ; faites glisser son bord gauche pour le redimensionner.
Chaque channel et chaque conversation directe a son propre panneau : il disparaît quand vous passez à un autre, et revient quand vous y retournez, sauf si vous l'aviez fermé.

Le lien doit mener à un fichier du dossier de l'agent : un chemin relatif au dossier (notes/plan.md), un chemin absolu à l'intérieur (tel que l'agent ou cet ordinateur le voit), ou une adresse file:// d'un tel chemin. Un lien vers un site ouvre le navigateur ; tout autre lien explique pourquoi le fichier ne peut pas être affiché, et rien n'est lu hors du dossier. Pour obtenir des liens qui s'ouvrent, dites-le à l'agent dans son AGENTS.md, par exemple « Quand tu écris un fichier, donne un lien Markdown vers lui, relatif à ton dossier ».

Créer ou supprimer un fichier

Créer : sélectionnez un dossier (ou un fichier qu'il contient), cliquez sur + New file, tapez un nom, Entrée. Le fichier s'ouvre, vide.
Supprimer : survolez l'entrée et cliquez sur 🗑 (ou Delete sous l'éditeur), puis confirmez. Sur cet ordinateur, le fichier part à la corbeille — récupérez-le depuis le Finder si besoin. Dans un conteneur, la suppression est définitive, et la confirmation le dit.

Protéger des fichiers

Certains fichiers ne doivent pas être modifiés ou supprimés par erreur. Sans rien écrire, les instructions de l'agent (AGENTS.md), ses skills (skills/ et tout ce qu'il contient), son fichier de configuration (après --config ou serve acp dans ses args) et, pour un agent en conteneur ou en sandbox, les fichiers à partir desquels il est construit (compose.yaml, Dockerfile, sbxenv.yaml cités par son runtime.lifecycle) sont protégés. Pour en protéger d'autres, listez-les sous l'agent dans Settings :

  - name: milo
    protect: [notes/plan.md, "prompts/**"]

Un fichier protégé affiche 🔒 au lieu de 🗑 et s'ouvre en lecture seule ; un dossier qui en contient un ne peut pas être supprimé. Seule la configuration lève une protection (celles toujours appliquées ne se lèvent pas) : l'interface jamais. L'agent, le terminal et le Finder peuvent toujours modifier ces fichiers.

Lancer des commandes dans le dossier de l'agent

Cliquez sur Terminal : un shell s'ouvre dans le dossier de l'agent — le vôtre sur cet ordinateur, bash ou sh dans un conteneur. Les programmes plein écran (vim, htop) fonctionnent et suivent la taille du panneau. Le shell continue de tourner pendant que vous regardez Files ; quitter la vue de l'agent le termine, avec tout ce qu'il a lancé. Quand le shell se termine (exit), Open a new shell en ouvre un autre.

Lire le journal de l'agent

Log affiche les dernières lignes que l'agent a écrites sur sa sortie d'erreur — ce qui explique une erreur sans ouvrir de terminal.

Variantes

Agent dans un conteneur : voir Lancer un agent dans un conteneur Docker.
Agent dans une sandbox sbx : voir Lancer un agent dans une sandbox sbx ; chaque action sur les fichiers prend une à deux secondes.

Voir aussi

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71


# Travailler avec les fichiers et le terminal d'un agent

Ce guide montre comment voir ce qu'un agent a produit, modifier ses instructions, supprimer un fichier et lancer des commandes dans son dossier. Il suppose que Sidekicks tourne avec une configuration qui contient des agents. Les libellés sont ceux de l'interface en anglais, sa langue par défaut.

## Ouvrir le workspace d'un agent

1. Dans le panneau **Agents**, survolez l'agent et cliquez sur **📂**.
2. Le centre affiche l'agent : son état, où il tourne (`local · /chemin` ou `container nom · /chemin`), les channels dont il est membre, et les onglets **Files**, **Terminal**, **Log**.
3. **💬 Conversation** ramène à la conversation directe ; cliquer sur un channel quitte aussi le workspace.

## Lire et modifier un fichier

1. Dans **Files**, cliquez sur un dossier pour l'ouvrir, sur un fichier pour le lire. Les fichiers commençant par un point (`.git`, `.mm`…) et `node_modules` sont cachés : cochez **Show hidden files** pour les voir.
2. Modifiez le texte. **● modified** apparaît ; **Save** (ou ⌘S) écrit le fichier, **Revert** remet ce qui est sur le disque.
3. Si l'agent modifie le fichier pendant que vous l'éditez, un bandeau le signale : **Take their version** le recharge (vos modifications sont perdues), **Keep mine** enregistre les vôtres par-dessus.

L'arbre et le fichier ouvert suivent seuls les changements de l'agent : un fichier qu'il crée apparaît en une seconde (deux dans un conteneur).

## Prévisualiser un document ou une image

Les fichiers Markdown (`.md`), AsciiDoc (`.adoc`, `.asciidoc`, `.asc`) et HTML (`.html`, `.htm`) s'ouvrent sur leur **Preview** ; **Edit** montre le texte, **Preview** revient au rendu de ce qui est dans l'éditeur. Les images (`.png`, `.jpg`, `.gif`, `.webp`, `.svg`…) n'ont qu'un aperçu : cliquez sur l'image pour sa taille réelle, à nouveau pour l'ajuster.

- Les images et liens relatifs au document sont cherchés dans le dossier de l'agent : un lien vers un autre fichier l'ouvre ici, un lien vers un site ouvre le navigateur.
- Une page HTML est affichée dans un cadre qui n'exécute aucun script et n'atteint rien : ses images et feuilles de style du dossier y sont intégrées, ses liens ne font rien.
- L'aperçu suit les changements de l'agent, comme l'éditeur.

## Ouvrir un fichier dont un agent donne le lien dans sa réponse

Quand un agent écrit un document et donne un lien vers lui dans sa réponse, cliquez sur le lien : le fichier s'ouvre dans un panneau à droite de la conversation, qui reste visible.

- Le panneau prévisualise le Markdown, l'AsciiDoc, le HTML et les images comme ci-dessus, et affiche tout autre fichier texte tel quel. Les liens du document vers d'autres fichiers du dossier s'ouvrent dans le même panneau.
- **📂 Afficher l'emplacement** ouvre le Finder (macOS) ou l'Explorateur (Windows) avec le fichier sélectionné. Il n'apparaît que si le dossier de l'agent est sur cet ordinateur : un agent sur cet ordinateur, ou dans un conteneur ou une sandbox dont le dossier est monté depuis celui-ci.
- **Ouvrir dans les fichiers de l'agent** montre le fichier dans l'onglet **Files**, pour le modifier. **↻** le relit après un changement de l'agent.
- **×** ou **Échap** ferme le panneau ; faites glisser son bord gauche pour le redimensionner.
- Chaque channel et chaque conversation directe a son propre panneau : il disparaît quand vous passez à un autre, et revient quand vous y retournez, sauf si vous l'aviez fermé.

Le lien doit mener à un fichier du dossier de l'agent : un chemin relatif au dossier (`notes/plan.md`), un chemin absolu à l'intérieur (tel que l'agent ou cet ordinateur le voit), ou une adresse `file://` d'un tel chemin. Un lien vers un site ouvre le navigateur ; tout autre lien explique pourquoi le fichier ne peut pas être affiché, et rien n'est lu hors du dossier. Pour obtenir des liens qui s'ouvrent, dites-le à l'agent dans son `AGENTS.md`, par exemple « Quand tu écris un fichier, donne un lien Markdown vers lui, relatif à ton dossier ».

## Créer ou supprimer un fichier

- **Créer** : sélectionnez un dossier (ou un fichier qu'il contient), cliquez sur **+ New file**, tapez un nom, Entrée. Le fichier s'ouvre, vide.
- **Supprimer** : survolez l'entrée et cliquez sur **🗑** (ou **Delete** sous l'éditeur), puis confirmez. Sur cet ordinateur, le fichier part à la corbeille — récupérez-le depuis le Finder si besoin. Dans un conteneur, la suppression est définitive, et la confirmation le dit.

## Protéger des fichiers

Certains fichiers ne doivent pas être modifiés ou supprimés par erreur. Sans rien écrire, les instructions de l'agent (`AGENTS.md`), ses skills (`skills/` et tout ce qu'il contient), son fichier de configuration (après `--config` ou `serve acp` dans ses `args`) et, pour un agent en conteneur ou en sandbox, les fichiers à partir desquels il est construit (`compose.yaml`, `Dockerfile`, `sbxenv.yaml` cités par son `runtime.lifecycle`) sont protégés. Pour en protéger d'autres, listez-les sous l'agent dans **Settings** :

```yaml
  - name: milo
    protect: [notes/plan.md, "prompts/**"]
```

Un fichier protégé affiche 🔒 au lieu de 🗑 et s'ouvre en lecture seule ; un dossier qui en contient un ne peut pas être supprimé. Seule la configuration lève une protection (celles toujours appliquées ne se lèvent pas) : l'interface jamais. L'agent, le terminal et le Finder peuvent toujours modifier ces fichiers.

## Lancer des commandes dans le dossier de l'agent

Cliquez sur **Terminal** : un shell s'ouvre dans le dossier de l'agent — le vôtre sur cet ordinateur, bash ou sh dans un conteneur. Les programmes plein écran (`vim`, `htop`) fonctionnent et suivent la taille du panneau. Le shell continue de tourner pendant que vous regardez **Files** ; quitter la vue de l'agent le termine, avec tout ce qu'il a lancé. Quand le shell se termine (`exit`), **Open a new shell** en ouvre un autre.

## Lire le journal de l'agent

**Log** affiche les dernières lignes que l'agent a écrites sur sa sortie d'erreur — ce qui explique une erreur sans ouvrir de terminal.

## Variantes

- **Agent dans un conteneur** : voir [Lancer un agent dans un conteneur Docker](lancer-un-agent-dans-docker.md).
- **Agent dans une sandbox `sbx`** : voir [Lancer un agent dans une sandbox sbx](lancer-un-agent-dans-une-sandbox.md) ; chaque action sur les fichiers prend une à deux secondes.

## Voir aussi

- [Workspaces et terminaux — explication](../explanation/workspaces-et-terminaux.md)
- [Référence : workspaces](../reference/agents-et-evenements.md#workspaces-milestone-m4)