Travailler avec les fichiers et le terminal d'un agent

 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

# 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.

## 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)