Deux agents peuvent avancer en parallèle lorsque leurs tâches sont indépendantes et leur périmètre précis. Dans cet atelier, Claude Code prépare la documentation et Codex ajoute des tests. Vous gardez la revue et l’intégration : aucun agent ne décide seul de fusionner les changements ou de publier quoi que ce soit.
Agent Deck est une interface de terminal qui organise notamment des sessions Claude Code et Codex. Ce guide utilise la version 1.16.39, consultée le 20 novembre 2026. Les commandes restent à comparer à l’aide de la version que vous installez.
- Dépôt d’essaiCrée un worktree documentation et un worktree tests.
- Agent DeckAjoute deux sessions, chacune avec son dossier et sa CLI.
- Tableau de bordRepère les sessions actives et lis leurs demandes dans le terminal.
- GitVérifie chaque branche et intègre les résultats après relecture.
1. Comprendre session, tmux et worktree
La session Agent Deck associe un outil, un dossier et un état de travail. tmux maintient les terminaux et permet de s’y rattacher. Un worktree Git fournit un autre répertoire de travail sur une branche distincte. Deux sessions dans le même dossier continueraient à modifier les mêmes fichiers : c’est le worktree qui sépare ici les modifications.
Cette séparation ne constitue pas une sandbox : les processus gardent les accès de leur environnement. Un terminal détaché peut continuer à tourner, mais ne survit pas automatiquement à un redémarrage du serveur. Un indicateur « terminé » ne prouve ni la justesse du code ni la réussite des tests.
2. Préparer une installation d’essai contrôlée
Le guide d’installation amont annonce macOS, Linux et Windows via WSL. Nous choisissons un serveur Linux de test, avec Git, tmux, curl et Python3, où les commandes claude et codex fonctionnent déjà. Aucun compte ni secret ne sera copié dans l’exercice. Le support WSL est annoncé par le projet ; aucune recette WSL n’a été réalisée pour ce guide, et cela ne démontre pas une compatibilité Windows native.
curl -fsSL https://raw.githubusercontent.com/asheshgoplani/agent-deck/v1.16.39/install.sh -o install-agent-deck.sh
Lisez le script téléchargé avant de poursuivre : il peut installer des dépendances. Après cette revue, l’option ci-dessous évite la proposition de modification de la configuration tmux. Vérifiez ensuite les versions disponibles.
bash install-agent-deck.sh --version 1.16.39 --skip-tmux-config
agent-deck version
tmux -V
claude --version
codex --version
3. Vérifier les réglages avant le premier lancement
La référence de configuration documente des mises à jour automatiques et une gestion de minuteur activées par défaut. Pour cet atelier ponctuel, créez le fichier ~/.config/agent-deck/config.toml, ou son équivalent sous XDG_CONFIG_HOME. Sur une installation existante, modifiez les tables présentes sans les dupliquer.
[updates]
auto_update = false
auto_install = false
auto_restart = false
auto_update_remotes = false
check_enabled = false
manage_timer = false
[claude]
dangerous_mode = false
auto_mode = false
allow_dangerous_mode = false
[codex]
yolo_mode = false
[worktree]
run_repo_scripts = "never"
Ces réglages ne désinstallent pas un ancien minuteur. Les anciennes installations peuvent aussi conserver des options de contournement des permissions : vérifiez les profils, commandes personnalisées et paramètres effectifs. Gardez les protections propres à chaque agent. Cet exercice n’utilise ni orchestration planifiée ni script de préparation de worktree.
4. Créer une base commune et deux espaces de travail
Créez un dossier neuf, puis les deux fichiers indiqués. Git doit être configuré pour vos commits. Le petit module ci-dessous n’utilise aucune IA à l’exécution ; il normalise une catégorie et refuse les entrées invalides. Placez simplement « Atelier de normalisation des catégories » dans README.md. Créez aussi .gitignore contenant __pycache__/ pour ignorer les caches Python.
mkdir atelier-parallele
cd atelier-parallele
git init -b main
def normaliser_categorie(valeur):
if not isinstance(valeur, str):
raise TypeError("Une chaîne est requise")
categorie = valeur.strip().lower()
if categorie not in {"facturation", "technique", "autre"}:
raise ValueError("Catégorie inconnue")
return categorie
Enregistrez ce code dans categories.py, puis commitez la base avant de créer deux worktrees supplémentaires. Le dépôt principal reste l’endroit où vous intégrerez les résultats.
git add -- categories.py README.md .gitignore
git commit -m "Initialiser l’atelier"
git worktree add -b atelier-docs ../atelier-docs
git worktree add -b atelier-tests ../atelier-tests
git worktree list
5. Démarrer deux sessions avec deux responsabilités
La commande launch crée et démarre une session. Enregistrez les deux dossiers séparés, puis ouvrez le tableau de bord. Sélectionnez une session et appuyez sur Entrée pour vous y rattacher ; Ctrl+Q permet de revenir au tableau selon les raccourcis documentés.
agent-deck launch ../atelier-docs -t documentation -c claude
agent-deck launch ../atelier-tests -t tests -c codex
agent-deck
Session documentation — Claude Code
Lis categories.py. Modifie uniquement README.md.
Explique la fonction, les entrées acceptées, les exceptions et un exemple fictif.
La future commande de tests sera : python3 -m unittest discover -s tests -v.
Ne prétends pas l’avoir exécutée si tests/ n’existe pas dans cette branche.
Ne modifie pas le code, ne crée pas de commit et ne lance aucune autre session.
Session tests — Codex
Lis categories.py. Ajoute uniquement des fichiers dans tests/.
Utilise unittest, sans dépendance externe. Vérifie espaces et casse,
les trois catégories, une catégorie inconnue et une valeur non textuelle.
Ne modifie pas l’implémentation. Signale un défaut au lieu de le corriger ailleurs.
Ne crée pas de commit. Demande avant d’exécuter les tests.
Contrôlez les permissions à chaque demande et évitez les autorisations globales. Si les deux agents réclament une modification du même fichier, réattribuez le travail avant de poursuivre. Aucun fichier de secrets ne doit être partagé entre les worktrees.
Consulter l’activité des sessions dans Agent Deck
Dans l’atelier README/tests, le tableau de bord sert à repérer quelle session demande votre attention. Les indicateurs locaux documentés pour Agent Deck v1.16.39 indiquent l’état que le tableau de bord a observé.
- ● Running indique une activité détectée.
- ◐ Waiting correspond à un tour arrêté dont le résultat ou l’attente reste à consulter.
- ○ Idle signifie que la session est inactive et que son état a déjà été consulté.
- ✕ Error indique une anomalie à examiner. Les sous-états peuvent signaler une session tmux absente.
- ⟳ Starting indique que la session est en cours de lancement.
Le code de cette version définit aussi queued, attente d’une capacité de groupe, et stopped, arrêt volontaire.
Une session en attente peut requérir votre intervention. Le sous-état interactive-menu peut correspondre à une permission ou à une question. Consultez la demande réelle dans la session avant toute décision. Un Claude avec du travail en arrière-plan peut rester running avec background-work, même après sa réponse visible.
Pour une supervision par consultation, remplacez ID par l’identifiant relevé dans la liste.
agent-deck status -v --json
agent-deck list --json --no-archived
agent-deck session show --json ID
agent-deck session output --json ID
Ces commandes sont décrites dans la référence CLI du tag. Utilisez-les pour consulter une session avant de l’ouvrir. show précise notamment le chemin, l’outil, le statut et les sous-états disponibles. output lit la dernière réponse disponible. L’option --pane permet une capture du terminal. Pour vérifier ce qui a changé, passez au diff Git.
Conservez --json pour consulter le résultat d’une session Claude enfant tout en gardant sa notification dans la boîte de réception. Consultez les sorties sur le serveur de travail, car elles peuvent contenir du contexte privé.
Contrôlez ensuite chaque worktree en dehors de l’interface, avec son chemin réel.
git -C "/chemin/du/worktree" status --short
git -C "/chemin/du/worktree" diff --stat
git -C "/chemin/du/worktree" diff
git -C "/chemin/du/worktree" diff --cached
Vérifiez aussi les fichiers non suivis signalés par status, absents du diff ordinaire. Pour des changements déjà commités, comparez à la base de départ avec git diff BASE...HEAD, après avoir remplacé BASE. Enfin, relancez les tests prévus. list --json signale status_source: stale lorsqu’une capture tmux expire. Les sessions distantes n’exposent pas tous les sous-états locaux. Vérifiez le contenu de la session si une ancienne annonce de fin précède un nouveau tour actif.
- Suivre l’activité avec OpenTelemetry · Collecter les métriques de Codex et Claude Code sur un serveur de test.
- Vérifier le code avec Git, GitHub et CodeRabbit · Relire le diff, exécuter les tests et décider de la fusion.
Vous pouvez ajouter un tableau de bord à cette installation. Installer Agent Deck et Grafana sur un serveur.
6. Examiner puis intégrer vous-même
Quand les deux agents ont terminé, arrêtez leurs sessions. Ouvrez les nouveaux fichiers, puis indexez uniquement les chemins attendus pour voir leur diff complet : un fichier non suivi n’apparaît pas dans un diff ordinaire.
agent-deck session stop documentation
agent-deck session stop tests
git -C ../atelier-docs status --short
git -C ../atelier-tests status --short
git -C ../atelier-docs add -- README.md
git -C ../atelier-docs diff --cached
git -C ../atelier-tests add -- tests/
git -C ../atelier-tests diff --cached
Un test est du code : relisez-le avant exécution. Vérifiez d’abord les tests dans leur worktree. Un échec demande une correction et une nouvelle revue avant intégration.
cd ../atelier-tests
python3 -m unittest discover -s tests -v
cd ../atelier-parallele
Après cette validation, commitez séparément chaque contribution et fusionnez les branches une à une dans le dépôt principal. En cas de conflit, examinez les versions au lieu d’accepter automatiquement une proposition.
git -C ../atelier-docs commit -m "Documenter les catégories"
git -C ../atelier-tests commit -m "Tester les catégories"
git switch main
git merge atelier-docs
git merge atelier-tests
python3 -m unittest discover -s tests -v
git status --short
Vérifiez les tests et le README après intégration. Des tests verts ne prouvent pas l’absence de défaut ; conservez les worktrees tant que la revue reste ouverte. Le dépôt amont présente des évolutions récentes, sans garantie de maintenance future ou de fonctionnement sur votre machine. Aucune installation ni session d’agent n’a été exécutée pour rédiger ce guide.