Escouade

Le poste de pilotage de tes agents Claude Code : une application Windows et macOS pour piloter plusieurs instances de Claude Code en local, avec un onglet par projet, autant d'agents que nécessaire, des terminaux intégrés, des notifications quand Claude attend une réponse, les quotas de ton abonnement et des statistiques de consommation. Elle parle français et anglais.

Site : escouade.gagnaire.dev

Escouade s'appelait auparavant « Claude Code Manager » : la mise à jour remplace l'ancienne installation et garde tes réglages et tes conversations. Projet indépendant, non affilié à Anthropic ; Claude et Claude Code sont des marques d'Anthropic.

Fonctionnalités

Ce qui change d'une version à l'autre est dans le journal des versions.

• Français et anglais : l'interface existe dans les deux langues, celle du système par défaut, au choix dans Réglages › Application, sans redémarrer ; nombres, montants, dates et pluriels suivent la langue. Une langue à part pour les textes que Claude rédige (messages de commit, descriptions de pull request, commentaires publiés dans Jira, Trello et GitHub, consignes aux agents), car beaucoup d'équipes commitent en anglais avec une interface en français. Le site existe aussi en deux langues.
• Plusieurs comptes Claude : un compte par dossier de configuration (perso, pro…), chacun connecté depuis Escouade (« Ajouter un compte… » partage, par lien ou par copie, tes réglages, skills, agents et plugins, jamais la connexion). Chaque agent reste sur son compte ; un nouvel agent ou un ticket part sur le premier compte sous le seuil de « Pause au-delà du quota » (ou le « Compte préféré » du projet), et le pilote auto ne se met en pause que quand tous sont au seuil. Un agent arrêté par la limite d'usage peut reprendre, avec sa conversation, sur un autre compte (« Reprendre sur Pro », ou tout seul pour un agent de ticket si tu l'actives). Les statistiques se filtrent par compte. Un compte peut être « Réservé aux projets » que tu coches (ceux d'un client, par exemple) : les autres projets n'y partent jamais, ni en automatique, ni au choix, ni en reprise. Ton compte habituel devient « Principal » et se lance comme avant.
• Serveur MCP : Claude (dans un terminal, un autre outil, ou un agent d'Escouade) lit tes projets, agents et tickets, crée, modifie, déplace et lance des tickets, crée un agent, lui écrit et l'arrête, sous les mêmes garde-fous que le pilote auto. « Claude peut piloter Escouade » (Réglages › Claude Code) le déclare dans chaque compte ; il n'écoute que sur ta machine, derrière un jeton ; un projet décide si ses agents peuvent l'utiliser (désactivé par défaut) ; un journal « Activité MCP » garde les appels. Aucun outil n'accepte une permission, ne lance une commande ni ne supprime.
• Projets en onglets : compteur de modifications git non commitées, pastille quand un agent attend une réponse, couleur par projet (qui teinte toute l'interface), réordonnables par glisser-déposer.
• Agents : une conversation Claude Code par agent, nommée automatiquement d'après la première demande. Modèle (Fable, Opus, Sonnet, Haiku, toujours le plus récent que connaît Claude Code, affiché avec sa version : « Sonnet 5.5 »), effort (jusqu'à max) et mode de permission (Auto, Demander, Plan, Édits auto, Bypass) modifiables en cours de conversation. Archivage, suppression, renommage. « Dupliquer la conversation » crée une copie de l'agent qui reprend tout son contexte dans une nouvelle session (et son propre worktree), sans toucher à l'original.
• Avancée d'un plan : quand un agent exécute un plan, un bandeau « Plan » entre son en-tête et ses messages dit où il en est sans lire la conversation : tâches faites, sous-agents qui travaillent et ce que fait chacun, tâche bloquée en attente de ta réponse. La liste vient des outils de tâches de Claude Code ou d'un plan superpowers, lu en lecture seule ; une mini-barre « Plan 2/7 » le résume sur la carte de l'agent.
• Vue d'ensemble (Ctrl+Shift+A) : tous les agents de tous les projets sur une page, ceux qui attendent ta réponse en tête ; une autorisation qui s'y lit en entier s'accorde ou se refuse sur place.
• Chat natif : markdown avec coloration syntaxique, réflexion repliable, appels d'outils compacts et dépliables (diffs, sorties de commandes, sous-agents). Questions de Claude et demandes d'autorisation sous forme de cartes cliquables (ou réponse libre), auxquelles tu réponds aussi au clavier (Ctrl+Entrée, Alt+1 … Alt+9). Images (coller/glisser), autocomplétion @fichier et /commande, messages envoyés pendant que Claude travaille (il en tient compte dès sa prochaine étape, comme dans Claude Code), interruption par Échap. Le texte que tu commences est gardé d'un redémarrage à l'autre, chaque agent se rouvre là où tu l'avais laissé, et une longue conversation n'affiche que ses 80 derniers éléments (« Afficher les N précédents » pour remonter).
• Rechercher dans les conversations (Ctrl+K) : dans ce que toi et tes agents avez écrit, les commandes, les fichiers et les sorties d'outils, sans tenir compte de la casse ni des accents ; un résultat ouvre l'agent sur le message.
• Notifications : l'onglet du projet et la carte de l'agent clignotent (ambre : question, vert : terminé, rouge : erreur) jusqu'à ce que tu affiches l'agent ; carillon, notification système (Windows : cliquable), clignotement de la barre des tâches (macOS : rebond de l'icône du Dock) et badge dans la zone de notification / la barre des menus quand un agent pose une question ou termine. La notification dit de quoi il s'agit (« Autoriser Bash : npm test ? », la question, la première ligne de la réponse), et « Me prévenir pour » choisit les types qui sonnent.
• Git : panneau des fichiers non commités (par agent ou pour tout le projet, worktrees compris), visionneuse de diff (unifié / côte à côte, un choix qui s'applique aussi aux diffs de la conversation ; un long diff se déplie par tranches), commit rédigé par l'agent lui-même ou commit direct avec un message proposé par Haiku, que tu relis avant de cliquer, git graph de tout le dépôt avec la branche de l'agent mise en avant (onglet « Historique », clic sur un commit pour son diff, clic droit pour créer une branche, y passer ou la comparer). Disposition moitié / moitié au choix : la conversation à gauche, les fichiers modifiés et leur diff à droite, rafraîchis pendant que l'agent travaille. Option un worktree par agent, avec les fichiers .env* du projet copiés et des commandes de préparation (installer les dépendances…) dont tu suis la sortie en direct, puis merge (ou squash) dans la branche de base de l'agent et nettoyage.
• Branches : le bouton de branche de la barre d'état ouvre un sélecteur (recherche, locales et distantes, avance et retard « ↑2 ↓5 », récupérer, pousser) pour changer de branche sans perdre de travail (stash proposé), en créer, supprimer celles qui sont mergées ou, après confirmation, les autres, et nettoyer d'un coup les « Branches mergées ». Un agent ou un ticket peut travailler sur une branche qui existe déjà, et « Intégrer » fait entrer la base dans la branche d'un agent en lui rendant les conflits à résoudre.
• Éditeur intégré : parcourir et modifier les fichiers du projet ou du worktree d'un agent sans quitter l'app (arborescence, onglets, coloration syntaxique, recherche, lignes modifiées marquées dans la marge, Ctrl+S pour enregistrer). Il s'ouvre depuis l'en-tête d'un agent, les fichiers non commités ou les fichiers édités dans la conversation (une modification s'ouvre à sa première ligne modifiée), et prévient quand un fichier ouvert change sur le disque pendant que l'agent travaille, avec « Comparer » pour voir ce que le disque a de différent avant de choisir. Et aussi :
  • Ctrl+clic ou F12 suit un import, un lien ou un chemin, et va à la définition d'un nom, sans serveur de langage ; Alt+← revient ;
  • Ctrl+P ouvre un fichier par son nom, Ctrl+Shift+F cherche dans tous les fichiers, Shift+F12 trouve les références d'un nom ;
  • « Voir les changements » montre dans le texte ce qui a changé depuis le dernier commit, et « Annuler ce bloc » le remet ;
  • au clic droit dans l'arborescence : renommer (F2), supprimer vers la corbeille (Suppr), créer un dossier, ouvrir un terminal ici ; les fichiers .env* copiés dans les worktrees y apparaissent en grisé.
• Terminaux : vrais terminaux (ConPTY ou pty + xterm.js) PowerShell 7, Git Bash et WSL sous Windows, zsh, bash et fish sous macOS, avec l'autocomplétion native du shell. Un terminal s'ouvre aussi dans le worktree d'un agent ou dans un dossier de l'éditeur.
• Lancement du projet : par projet, une liste de commandes (nom, ligne de commande, shell, sous-dossier) à lancer une par une ou toutes ensemble. Chacune tourne dans son propre terminal, en lecture seule, et garde son log d'un lancement à l'autre. Statut en direct (en cours, arrêté, terminé, planté avec le code de sortie et une notification) ; lancer, relancer, stopper. « ✦ Remplir automatiquement » laisse Claude lire le projet (sans rien modifier) et proposer ces commandes, que tu lis en entier avant de les prendre.
• Kanban : des tickets avec leurs critères d'acceptation, que des agents prennent seuls (pilote auto, de 1 à 6 en parallèle), chacun dans son worktree, en bouclant jusqu'à les atteindre ; un ticket peut en attendre d'autres, reprendre une branche existante, s'écrire dans une grande fenêtre (Ctrl+Entrée pour l'ajouter), et le pilote auto se met en pause près de la limite de tes quotas. « ▶ Tester » lance la fonctionnalité sur des ports à part, après t'avoir montré la recette écrite par l'agent ; la validation commite, merge, ouvre une pull request ou pousse.
• Intégrations : importe tes tickets Jira, Trello ou GitHub Issues dans le Kanban, avec leurs critères ; leur statut et des commentaires suivent, et une synchro ratée est retentée. Les jetons restent dans le trousseau du système.
• Barre de statut : agents actifs, en attente et terminés, quotas du compte en cours en compact (5h … reset 3h01 | 7j … reset 4j 12h, le pourcentage au survol de la barre ; avec plusieurs comptes, un clic ouvre le détail de chacun), coût du jour. Tokens et coût montent en direct pendant que Claude travaille (estimation « ≈ » d'après les tarifs publics), puis prennent le chiffre exact de Claude Code à la fin du tour.
• Statistiques : tokens (entrée, cache, sortie) par jour, semaine ou mois, coût global, coût moyen par prompt, répartition par projet, par modèle, par agent, par ticket et par compte.
• Remote control : clic droit sur un agent → « Activer le remote control ». Sa session devient accessible depuis claude.ai et l'app Claude sur mobile ; ce que tu y envoies s'affiche aussi dans l'app, et l'agent reste joignable tant que l'app tourne (même session après un redémarrage).
• Fermer la fenêtre ne coupe pas les agents : l'app reste dans la zone de notification. Au redémarrage, chaque agent reprend sa session Claude (--resume). Les processus inactifs sont arrêtés après un délai réglable et reprennent automatiquement à la prochaine action.
• Proxy réseau configurable (processus Claude, quotas, intégrations, mises à jour, et optionnellement terminaux).
• Mises à jour silencieuses via les releases GitHub : téléchargées en arrière-plan, installées sans fenêtre d'installeur, au redémarrage que tu choisis, ou d'elles-mêmes quand aucun agent ne travaille et que tout est enregistré.

Prérequis

• Windows 10 ou 11 (WebView2, présent par défaut sur Windows 11), ou macOS 11 (Big Sur) ou plus récent, sur Mac Apple Silicon ou Intel.
• Claude Code installé et connecté (claude dans le PATH, ou chemin indiqué dans les réglages).
• Git : Git for Windows, ou sous macOS celui des outils en ligne de commande Xcode (xcode-select --install) ou de Homebrew.
• Optionnel sous Windows : PowerShell 7 (à défaut, les terminaux utilisent Windows PowerShell), WSL.

Sous macOS, une app lancée depuis le Finder ou le Dock ne reçoit pas le PATH du terminal : Escouade reprend celui de ton shell de connexion ($SHELL -ilc) au démarrage, et cherche aussi claude dans ~/.local/bin, /opt/homebrew/bin et /usr/local/bin.

Installation

Windows : télécharge l'installeur .exe de la dernière release.

macOS : télécharge le .dmg (universel, Apple Silicon et Intel) de la dernière release, ouvre-le et glisse Escouade dans Applications. Depuis la 1.5.4, l'app est signée avec un certificat Apple Developer ID et notarisée par Apple : macOS l'ouvre sans demander d'autorisation.

Les versions suivantes s'installent depuis l'application. Jusqu'à la 1.5.4, la barre de statut propose « Mise à jour disponible » ; à partir de la 1.6, la mise à jour se télécharge seule, la barre de statut affiche « Mise à jour X prête · Redémarrer », et l'app redémarre d'elle-même quand elle est au repos (réglage « Installer les mises à jour automatiquement », dans « À propos »).

Données locales

Tout est stocké dans ~/.escouade/ (anciennement ~/.claude-code-manager/, déplacé au premier lancement de la 0.1.4) :

La variable d'environnement ESCOUADE_DATA_DIR (l'ancienne CCM_DATA_DIR marche encore) permet d'utiliser un autre dossier (démonstrations, tests).

Raccourcis

Sous macOS, Ctrl devient ⌘ (sauf Ctrl+Tab, ⌘Tab changeant d'application) ; dans les terminaux, ⌘C / ⌘V copient et collent, et les touches Ctrl vont au shell.

Développement

Prérequis : Node.js 20.18+ et rustup (MSVC sous Windows ; sous macOS, les outils en ligne de commande Xcode). La version de Rust est épinglée dans src-tauri/rust-toolchain.toml (la même qu'en CI) et rustup l'installe automatiquement.

npm ci
npm run tauri dev

Pour travailler sans toucher à tes vraies données (une version de développement lancée sans dossier à part déplacerait aussi ~/.claude-code-manager/) :

$env:ESCOUADE_DATA_DIR = "$env:TEMP\escouade-sandbox"; npm run tauri dev

Sous macOS :

ESCOUADE_DATA_DIR="$TMPDIR/escouade-sandbox" npm run tauri dev

Tests

La CI (.github/workflows/ci.yml) exécute l'ensemble sur chaque push et pull request sous Windows, et sous macOS tout sauf les tests de bout en bout, plus la construction du .dmg (téléchargeable dans les artefacts du run pour tester une branche).

Publier une version

1. Une seule fois, ajoute les secrets du dépôt GitHub :

   • TAURI_SIGNING_PRIVATE_KEY : le contenu de la clé privée de signature des mises à jour (générée avec npx tauri signer generate, la clé publique correspondante est dans src-tauri/tauri.conf.json) ;
   • TAURI_SIGNING_PRIVATE_KEY_PASSWORD : son mot de passe (vide s'il n'y en a pas) ;
   • optionnel, pour signer et notariser l'app macOS (sans eux, elle est signée ad hoc et macOS demande une confirmation au premier lancement) : APPLE_CERTIFICATE (certificat Developer ID Application exporté en .p12, encodé en base64), APPLE_CERTIFICATE_PASSWORD, APPLE_SIGNING_IDENTITY (ex. Developer ID Application: Nom (TEAMID)), APPLE_ID, APPLE_PASSWORD (mot de passe d'application) et APPLE_TEAM_ID.

2. Mets à jour la version partout, committe, tague et pousse :

   npm run version:set -- 0.2.0
   git commit -am "chore: release 0.2.0"
   git tag v0.2.0
   git push origin main v0.2.0
   

   Ou crée la release depuis la page GitHub (« Draft a new release », nouveau tag v0.2.0 sur main, « Publish ») : l'app prend la version du tag, même si celle de main n'a pas été montée.

Le workflow release.yml vérifie que le tag est une version, crée la release, puis, sous Windows et sous macOS en parallèle, donne à l'app la version du tag, lance les tests, construit l'installeur (.exe NSIS ; .dmg et .app.tar.gz universels), le signe et l'ajoute à la release avec le latest.json utilisé par la mise à jour automatique, commun aux deux systèmes. La mise à jour lit le latest.json de la dernière release : si une construction échoue, la release repasse en brouillon, pour que la mise à jour retrouve la précédente. Pour réessayer, supprime ce brouillon et son tag sur GitHub, corrige, puis publie à nouveau.

Tague toujours la tête de main, et attends que la release soit créée (première minute du workflow) avant de pousser d'autres commits : une fois main plus loin que le tag, le GITHUB_TOKEN des Actions n'a plus le droit de créer la release (« Resource not accessible by integration »).

Vidéo de présentation

Le dossier video/ contient la vidéo de présentation (Remotion). Sa voix off mène tout : chaque scène dure le temps de ses phrases (src/script.ts), et l'animation se cale sur les mots prononcés. La voix et la musique viennent d'ElevenLabs (clé dans ELEVENLABS_API_KEY, jamais dans un fichier) ; elles sont versionnées, et seules les phrases modifiées sont redemandées :

cd video
npm install
$env:ELEVENLABS_API_KEY = "…"
npm run voice               # public/voice/*.mp3 et src/voice.json
npm run voice -- --check    # retranscrit chaque phrase pour vérifier qu'elle est bien prononcée
npm run music               # public/music.mp3, recomposée quand la durée des scènes change
npm run studio              # aperçu
npm run stills -- board     # images de contrôle d'une scène dans out/stills
npm run render              # bruitages + out/presentation.mp4
npm run web-video           # out/escouade-web.mp4 : son à -16 LUFS, plus léger
npm test                    # chaque fonctionnalité montrée, cues, mixage, sous-titres

Site

Le dossier website/ contient le site de présentation (Nuxt, généré en statique), publié sur GitHub Pages à chaque push qui le touche. Il demande Node 22.19 ou plus récent :

cd website
npm install
npm run dev        # aperçu
npm run generate   # site statique dans .output/public
npm test           # vérifie le site généré

Il existe en français (à la racine) et en anglais (sous /en/) ; ses textes sont dans deux catalogues de mêmes clés. Ses images, sa vidéo et ses sous-titres viennent de video/ : npm run render, npm run web-video, puis npm run site-images (captures, affiche et sous-titres dans les deux langues ; -- --lang=en pour une seule). La voix de la vidéo reste française, la page anglaise propose ses sous-titres anglais.

Architecture

• src-tauri/ : backend Rust (Tauri 2).
  • claude.rs : pilotage d'un processus claude en mode stream-json, avec son protocole de contrôle (voir docs/PROTOCOL.md).
  • agent.rs : normalisation des messages en conversation, statuts, questions et permissions, usage par tour.
  • core.rs : orchestration.
  • Modules annexes : git.rs, pty.rs, stats.rs, usage.rs (quotas par compte), accounts.rs (comptes Claude), i18n.rs (langues du backend), mcp/ (serveur MCP), notify.rs, job.rs (arbres de processus : Job Objects sous Windows, groupes de processus sous macOS), shellenv.rs (PATH du shell de connexion sous macOS).
  • tauri.macos.conf.json : ce qui change sous macOS (barre de titre native avec les boutons de fenêtre, bundle .app / .dmg).
• src/ : interface Svelte 5 ; ses textes sont dans src/lib/i18n/ (un catalogue par langue).
• design/ : maquette de référence.
• docs/SPEC.md : spécification.

Licence

MIT, voir LICENSE.