Guide complet Agent Deck 2026 : gérez tous vos agents de codage IA avec un seul TUI

Cet article est basé sur Agent Deck v1.9.57 (publié le 2026-06-12), avec plus de 1 408 PR au compteur — le projet est extrêmement actif.

1. Pourquoi avez-vous besoin d'un gestionnaire d'agents IA ?

L'écosystème des outils de codage IA a été complètement transformé en 2026. Il y a un an, un développeur se contentait de Claude Code ou d'Aider. Aujourd'hui, le flux de travail typique d'un développeur intermédiaire ou avancé ressemble à ceci :

• Claude Code pour la logique métier principale
• OpenCode pour la revue de code
• Codex pour les tests unitaires
• Gemini CLI pour le prototypage rapide
• Pi pour la génération de documentation

Faites le calcul : 5 agents IA × 3 projets = 15 onglets de terminal. Et ce, sans compter les terminaux de débogage, les clients de base de données et les visionneuses de logs ouverts manuellement.

L'enfer des onglets de terminal

Vous avez probablement vécu ces situations :

• Vous ne savez plus quel onglet correspond à quel agent, et vous faites un git checkout sur la mauvaise branche
• Claude Code attend votre réponse, mais vous n'arrivez pas à retrouver l'onglet en question
• Vous voulez copier des idées de conversation entre plusieurs sessions Claude, et vous devez le faire manuellement
• Les fichiers de configuration MCP deviennent de plus en plus chaotiques, et chaque changement de projet nécessite des modifications manuelles

Les limites des solutions existantes

Agent Deck est né pour résoudre exactement ce problème. Ce n'est pas un outil de codage IA — c'est le centre de contrôle de tous vos outils de codage IA.

2. Qu'est-ce qu'Agent Deck ?

Agent Deck (GitHub : asheshgoplani/agent-deck) est un gestionnaire de sessions terminal open source conçu spécifiquement pour les agents de codage IA. Construit sur tmux, il offre une interface TUI (Terminal User Interface) dans une seule fenêtre de terminal, vous permettant de :

• Voir d'un coup d'œil l'état de tous vos agents IA (en cours d'exécution / en attente d'entrée / inactif / en erreur)
• Basculer entre les agents en un clic
• Forker des sessions pour explorer de nouvelles pistes depuis une conversation existante
• Gérer visuellement les services MCP et les Claude Skills
• Surveiller et orchestrer à distance plusieurs agents IA (fonctionnalité Conductor)

Philosophie centrale : pas un énième outil de codage IA, mais le centre de contrôle de votre flux de travail de développement IA dans le terminal.

Données clés

3. Installation et prise en main (5 minutes)

Méthodes d'installation

Agent Deck propose trois méthodes d'installation. L'installation via Homebrew est la plus simple :

# Méthode 1 : Homebrew (recommandé, macOS / Linux)
brew install asheshgoplani/tap/agent-deck

# Méthode 2 : Script d'installation rapide
curl -fsSL https://raw.githubusercontent.com/asheshgoplani/agent-deck/main/install.sh | bash

# Méthode 3 : Go install
go install github.com/asheshgoplani/agent-deck/cmd/agent-deck@latest

Créer votre première session

Une fois installé, exécutez dans votre terminal :

# Lance le TUI Agent Deck et crée une session nommée project-alpha
agent-deck session start project-alpha

Une interface TUI basée sur tmux apparaît. Si vous n'avez encore configuré aucun agent IA, Agent Deck vous guidera dans la configuration.

Opérations de base dans le TUI

Une fois dans le TUI, voici les raccourcis de navigation essentiels :

Recherche filtrée par état (très utile) :

Navigation au sein d'un groupe (nouveaux raccourcis Alt+ depuis v1.7.60+, déplacement dans le groupe courant uniquement) :

Indicateur d'état intelligent

Agent Deck détecte en temps réel l'état de chaque agent grâce à un polling intelligent :

Les sessions en attente apparaissent directement dans la barre d'état tmux : appuyez sur Ctrl+b, relâchez, puis appuyez sur 1-6 pour accéder directement à la session en attente correspondante. La barre d'état s'affiche ainsi :

⚡ [1] frontend [2] api [3] backend

4. Fonctionnalités clés en pratique

4.1 Fork de sessions : plusieurs implémentations, sans interférence

Le fork est l'une des fonctionnalités les plus différenciantes d'Agent Deck. Imaginez ce scénario : vous avez conçu une interface API avec Claude Code, et vous souhaitez maintenant explorer deux implémentations différentes. La méthode traditionnelle consiste à ouvrir une nouvelle session et à réexpliquer toutes les exigences depuis le début. Avec le fork, il vous suffit de :

# Dans le TUI, placez le curseur sur la session à forker
# Appuyez sur f → fork rapide (nom généré automatiquement)
# Appuyez sur F → nom et groupe personnalisés après fork

La valeur ajoutée du fork :

• La nouvelle session hérite de l'historique complet de la conversation parente
• Support du fork natif de Claude / OpenCode / Pi / Codex (capacité de fork intégrée à l'outil)
• Possibilité de forker un fork, explorant autant de branches que nécessaire
• Chaque branche fonctionne indépendamment, comparaison à tout moment possible

⚠️ Attention : la fonctionnalité de fork de Codex nécessite une version du CLI codex ≥ 0.137.0.

4.2 MCP Manager : gérer les services MCP sans toucher aux fichiers de configuration

Le protocole MCP (Model Context Protocol) permet aux agents IA d'accéder à des outils externes (recherche web, automatisation du navigateur, requêtes en base de données, etc.). La gestion traditionnelle nécessite de modifier manuellement des fichiers JSON. Agent Deck transforme cela en une opération TUI visuelle :

Appuyez sur m dans le TUI pour ouvrir le MCP Manager :

Emplacement de la configuration MCP : ~/.config/agent-deck/config.toml

Exemple de configuration :

[[mcp_servers]]
name = "web-search"
command = "npx"
args = ["-y", "@anthropic/mcp-server-brave-search"]

Une fois la configuration terminée dans le TUI, Agent Deck redémarre automatiquement la session de l'agent concerné pour appliquer les modifications, sans redémarrage manuel.

4.3 Skills Manager : gérer les Claude Skills par projet

Pour les utilisateurs de Claude Code, Agent Deck intègre un Skills Manager qui permet de gérer les Claude Skills par pool de projet :

Appuyez sur s dans le TUI pour ouvrir le Skills Manager (uniquement pour les sessions Claude) :

• Gestion par pool : la liste des compétences disponibles provient uniquement du pool (~/.config/agent-deck/skills/pool), garantissant des opérations d'attachement/détachement prévisibles
• État par projet : l'état du projet est écrit dans .agent-deck/skills.toml, les fichiers de compétences sont matérialisés dans le répertoire .claude/skills
• Navigation par saisie : même interaction de saut par nom que le MCP Manager

Vous pouvez ainsi configurer des combinaisons de compétences différentes pour chaque projet :

• project-alpha : compétences web-search + code-review attachées
• project-beta : compétences api-testing + docs-generation attachées

4.4 MCP Socket Pool : économisez 85 % de RAM avec plusieurs sessions

Lorsque vous exécutez plusieurs sessions simultanément et que chacune se connecte aux mêmes services MCP, la consommation mémoire augmente de manière exponentielle. Le MCP Socket Pool d'Agent Deck permet à plusieurs sessions de partager un même processus MCP via un socket Unix :

# Activer dans config.toml
[mcp]
pool_all = true

Résultats :

• Réduction de 85 à 90 % de l'empreinte mémoire des services MCP
• En cas de crash du processus MCP, reconnexion automatique en ~3 secondes (proxy de reconnexion)
• Totalement transparent pour les agents en amont, aucun code à modifier

4.5 Configuration Claude indépendante par groupe

Lorsque vous gérez plusieurs comptes Claude sur la même machine (par exemple, un compte personnel et un compte professionnel), Agent Deck permet de configurer une authentification Claude différente pour chaque groupe :

# config.toml
[groups."conductor".claude]
config_dir = "~/.claude-work"
env_file = "~/git/work/.envrc"

Ordre de priorité de recherche : variable d'environnement > groupe > configuration (profile) > global > par défaut

Le env_file est chargé avant le lancement du volet tmux, et les export qu'il contient deviennent partie intégrante de l'environnement de la session. Cela s'avère très pratique pour les scénarios nécessitant des clés API différentes ou des répertoires de travail Claude distincts.

5. Niveau avancé : l'orchestration Conductor

Qu'est-ce que le Conductor ?

Si la gestion de sessions d'Agent Deck est le « pilote automatique », alors le Conductor est le « commandant de flotte ». Il s'agit d'une couche d'abstraction de niveau supérieur qui vous permet de surveiller et d'orchestrer à distance toutes vos sessions d'agents IA via Telegram / Slack / Discord.

Configuration de la surveillance Telegram en cinq minutes

# 1. Créez un bot Telegram via @BotFather et récupérez le token
# 2. Récupérez votre user ID via @userinfobot

# 3. Exécutez l'assistant en une commande (configure automatiquement conductor, bridge daemon et heartbeat)
agent-deck conductor setup work --description "Work fleet"

# 4. Lancez la session conductor
agent-deck session start conductor-work

# 5. Envoyez /status à votre bot dans Telegram

À partir de ce moment, toutes vos sessions Agent Deck sont supervisées par une session conductor centralisée :

• Les questions classiques sont traitées automatiquement
• Les éléments importants sont poussés sur votre téléphone
• Les travaux en attente ne « pourrissent » pas et ne sont pas oubliés

Configuration des Watchers : déclencher des agents IA depuis des événements externes

Au-delà des requêtes actives, vous pouvez configurer des Watchers pour que des événements externes (événements GitHub, Gmail, notifications ntfy, rappels de réunion, etc.) « sonnent à la porte » et réveillent le conductor. Consultez la documentation officielle Watcher pour les détails de configuration.

6. Comparaison : Agent Deck vs autres solutions

7. Conclusion

Agent Deck ne répond pas à la question « quel outil de codage IA est le meilleur » — il répond à la question « quand vous utilisez plusieurs outils IA, comment les faire collaborer sans perdre la raison ? ».

Rappel des valeurs clés :

1. Contrôle centralisé : une seule fenêtre de terminal pour tous vos agents IA, adieu l'enfer des onglets
2. Fork de sessions : explorez de nouvelles pistes depuis une conversation existante, sans tout réexpliquer
3. Gestion visuelle MCP/Skills : finies les modifications manuelles de fichiers de configuration
4. MCP Socket Pool : réduction drastique de la consommation mémoire en multi-sessions
5. Surveillance à distance Conductor : gardez le contrôle de vos agents IA à tout moment via Telegram / Slack
6. Intégration Git Worktree : développement collaboratif multi-agents sur un même dépôt, sans conflits

Si vous commencez à faire face au problème de la « prolifération d'agents IA », Agent Deck est actuellement la solution open source la plus aboutie dans ce créneau. Et avec un rythme de mise à jour ultra-rapide (v1.9.56 → v1.9.57 en seulement 4 heures) et une communauté très active (PR #1408+), il mérite une attention particulière.

Liens connexes :

• 📦 Répository GitHub Agent Deck
• 📋 Dernières versions publiées
• 📖 Guide complet de configuration Conductor
• 📖 Guide de configuration Watcher
• 💬 Communauté Discord

Articles recommandés :

• Guide complet Aider — Assistant de programmation IA en terminal Git-first
• CC Switch — Gestion multi-modèle pour le codage IA