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

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

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

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