Installation

Prérequis

En plus :

• Claude Code, installé et connecté à ton compte Claude, comme tu le ferais pour l’utiliser dans un terminal (voir la documentation de Claude Code). Escouade lance le claude de ta machine.
• Git : Escouade s’en sert pour les diffs, les commits, les branches et les worktrees. Si le dossier d’un projet n’est pas un dépôt, Escouade en initialise un quand tu crées le projet.
• Facultatif sous Windows : PowerShell 7 (à défaut, les terminaux intégrés utilisent Windows PowerShell) et WSL.

Où Escouade cherche Claude Code

Escouade cherche claude dans cet ordre :

1. le chemin de Réglages › Claude Code › « Chemin de l’exécutable », s’il n’est pas vide (c’est alors le seul endroit essayé) ;
2. le PATH ;
3. les endroits où les installateurs de Claude Code le mettent (tableau ci-dessous) ;
4. sous Windows, quand il n’y en a pas, un Claude Code installé dans WSL (voir plus bas).

Le chemin des réglages accepte ~ pour ton dossier personnel, et sous Windows il peut se passer de .exe ou de .cmd. Laisse le champ vide pour la détection automatique. La ligne sous le champ dit où Escouade a trouvé claude (« Trouvé : … ») ou, s’il est introuvable, les formes de chemin acceptées.

Sans Claude Code, l’écran d’accueil le dit, la conversation vide d’un agent aussi, et le Kanban ne démarre aucun ticket (« Claude Code introuvable — aucun ticket ne démarre »). Installe-le ou indique son chemin dans les réglages : quand tu enregistres un autre chemin, ces messages se mettent à jour sans redémarrer Escouade.

Installer Escouade

Les installeurs sont sur la page des releases GitHub.

Windows

1. Télécharge l’installeur .exe de la dernière release.
2. Lance-le. Il installe Escouade pour ton compte utilisateur, sans demander de droits d’administrateur, et il parle la langue du système (français ou anglais).
3. Ouvre Escouade depuis le menu Démarrer.

macOS

1. Télécharge le .dmg de la dernière release. Il est universel : le même fichier sert aux Mac Apple Silicon et Intel.
2. Ouvre-le et glisse Escouade dans le dossier Applications.
3. Lance Escouade.

L’app est signée avec un certificat Apple Developer ID et notarisée par Apple : macOS l’ouvre sans demander d’autorisation.

Linux

L’AppImage fonctionne sur toute distribution qui remplit les prérequis :

chmod +x Escouade_*.AppImage
./Escouade_*.AppImage

C’est elle que la mise à jour intégrée remplace. Sur Debian ou Ubuntu, tu peux aussi installer le paquet .deb :

sudo apt install ./Escouade_*_amd64.deb

Sous Linux, les jetons des intégrations (Jira, Trello, GitHub, Linear) sont gardés dans ~/.escouade/integrations.json, faute de trousseau du système pris en charge.

Claude Code dans WSL

Sous Windows, Escouade peut faire tourner un Claude Code installé dans WSL.

1. Installe Claude Code dans ta distribution WSL et connecte-le.
2. Ouvre Réglages › Claude Code. Dans « Chemin de l’exécutable », écris le chemin de claude sous l’une de ces formes :
   • ~/.local/bin/claude ;
   • /home/<utilisateur>/.local/bin/claude ;
   • \\wsl.localhost\<distribution>\home\<utilisateur>\.local\bin\claude.
3. Laisse le champ vide si Windows n’a pas de claude : Escouade cherche alors le sien dans WSL, aux endroits habituels (~/.local/bin/claude en premier).
4. Lis la ligne sous le champ : « Trouvé dans WSL (Ubuntu) : … » confirme que claude est trouvé, et dans quelle distribution.

La distribution utilisée est celle du chemin quand il la nomme (\\wsl.localhost\<distribution>\…), sinon celle de Réglages › Terminaux › « Distribution WSL », sinon la distribution par défaut de WSL.

Escouade lance claude par wsl.exe, dans le dossier de l’agent (vu depuis WSL sous /mnt/c/…). Ses sessions, sa connexion et son quota sont lus dans le dossier personnel Linux. Un dossier de projet que WSL n’atteint pas (un partage réseau, le dossier d’une autre distribution) est refusé.

Claude Code est lancé dans WSL sans le profil du shell : une variable posée dans ~/.profile ou ~/.bashrc ne lui parvient pas.

Le PATH sous macOS

Une app lancée depuis le Finder ou le Dock ne reçoit pas le PATH de ton terminal : sans précaution, claude ou git installés avec Homebrew resteraient introuvables. Au démarrage, Escouade demande donc son PATH à ton shell de connexion ($SHELL -ilc, avec 5 secondes pour répondre) et le réunit avec celui qu’elle a reçu : les dossiers du shell d’abord, puis ceux déjà présents, sans doublon. Elle y ajoute /opt/homebrew/bin, /usr/local/bin et ~/.local/bin s’ils n’y sont pas. Ce PATH est celui de tous les processus qu’elle lance : Claude Code, git et les commandes des agents.

Sous Linux, le même mécanisme s’applique, ce qui sert quand Escouade est lancée depuis le lanceur du bureau plutôt que depuis un terminal.

Si claude reste introuvable, indique son chemin dans Réglages › Claude Code.

Premier lancement

Tant qu’aucun projet n’existe, Escouade ouvre un écran d’accueil : son logo, la phrase « Ajoute un projet pour y lancer des agents Claude Code, suivre leurs questions et ouvrir des terminaux. » et le bouton « + Ajouter un projet ».

• Si Claude Code n’est pas trouvé, un avertissement le dit : « Claude Code est introuvable sur ce poste. Installe-le (irm https://claude.ai/install.ps1 | iex) ou indique son chemin dans les réglages. » Ouvre alors les réglages avec le bouton ⚙ de la barre d’état ou Ctrl+,, onglet Claude Code. Sous macOS, Ctrl devient ⌘.
• Clique sur « + Ajouter un projet » pour ouvrir la fenêtre « Nouveau projet ». La prise en main la décrit champ par champ et va jusqu’au premier commit.
• Escouade te demande aussi, dans une fenêtre « Aider à améliorer Escouade ? », si elle peut envoyer des statistiques d’usage anonymes : « Partager les statistiques » ou « Non merci ». Rien n’est envoyé avant ta réponse. Le détail est sur la page Confidentialité, et le choix se change dans Réglages › À propos (voir les réglages « À propos »).

La fenêtre s’ouvre en 1440 × 900 (1000 × 600 au minimum) ; Escouade retient ensuite sa taille et sa position. Tes projets, tes conversations et tes réglages sont écrits dans ~/.escouade/ : voir les données locales.

Mises à jour

Les mises à jour viennent des releases GitHub d’Escouade. L’app télécharge la nouvelle version en arrière-plan et l’installe sans fenêtre d’installeur. La barre d’état affiche alors « Mise à jour X prête · Redémarrer » : tu redémarres quand tu veux, ou Escouade redémarre d’elle-même quand aucun agent ne travaille et que tout est enregistré. Ce réglage, « Installer les mises à jour automatiquement », est activé par défaut ; il est dans Réglages › À propos, où « Rechercher une mise à jour » lance une vérification tout de suite.

Voir les mises à jour et les réglages « À propos ».