Comment cesser de jongler avec des agents IA dans le terminal et organiser une équipe avec Firstmate

Scène familière : vous ouvrez cinq onglets de terminal, chacun exécutant son propre agent de codage. L'un corrige un test instable, un autre réécrit des composants pour le mode sombre, un troisième lance un audit des dépendances. Dix minutes plus tard, c'est le chaos. Quel agent a terminé ? Où les tests ont-ils échoué ? Quelle branche vient d'être fusionnée ?

Le projet firstmate propose une approche différente. Au lieu de contrôler manuellement chaque agent, vous communiquez avec un assistant principal — le premier maître. Vous lui confiez des tâches, et il les distribue à des « marins » autonomes dans des environnements isolés.

Qu'est-ce qu'une distribution d'agents

Les créateurs de firstmate décrivent leur projet non pas comme un autre utilitaire CLI ou un framework, mais comme une distribution d'agents. Essentiellement, c'est un ensemble portable d'instructions au format AGENTS.md, des compétences prêtes à l'emploi, des scripts et des règles de comportement.

Vous clonez le dépôt sur votre machine, exécutez votre outil CLI familier à l'intérieur (comme Claude Code ou Grok), et il récupère dynamiquement la logique pour gérer toute l'équipe. Aucune application supplémentaire ni dépendance lourde n'a besoin d'être installée sur votre système.

Fonctionnement de l'architecture

L'idée entière repose sur la séparation des responsabilités et l'isolation des espaces de travail.

Vous donnez des commandes au premier maître via un seul chat. Par exemple : « révise le projet xyz, corrige le test d'autorisation qui échoue, et ajoute le mode sombre. »

Le premier maître clone le dépôt dans le dossier projects/ et crée des tâches.

Pour chaque tâche, une fenêtre de terminal séparée est lancée (tmux, zellij, cmux ou Orca) et un arbre de travail git isolé est créé à l'aide de l'outil treehouse.

Les marins autonomes travaillent en parallèle, sans interférer les uns avec les autres ni casser la base de code principale.

Une fois les tâches terminées, le premier maître collecte les résultats et livre une pull request prête ou un rapport de recherche.

Un détail intéressant : le processus de surveillance ne consomme pas de jetons de réseau neuronal. Un script bash en arrière-plan surveille l'état de la session. Il dort jusqu'à ce qu'un événement se produise dans l'une des fenêtres ou qu'un marin ait besoin d'une décision humaine. Ce n'est qu'alors que l'observateur réveille le premier maître et lui transmet un bref résumé.

Modes et commandes

Le projet dispose de compétences intégrées qui sont invoquées directement depuis le chat :

• /afk bascule le système en mode absent. Le processus en arrière-plan gère les messages techniques mineurs de lui-même, tandis que les questions véritablement importantes sont regroupées dans un digest et préparées pour votre retour.
• /bearings génère un bref résumé de toutes les tâches en cours et des pull requests actives.
• /ahoy vous aide à vous mettre rapidement à jour en affichant la timeline des événements et les questions nécessitant votre approbation.
• /stow traite le contexte accumulé, enregistre les connaissances importantes sur le disque et archive les données obsolètes, ce qui permet d'économiser le budget de jetons.

Au-delà du développement standard avec création de PR, firstmate dispose d'un mode recherche (scout). Si vous avez besoin d'auditer la sécurité ou d'explorer le module de quelqu'un d'autre plutôt que de modifier du code, le marin compilera un rapport détaillé dans un fichier Markdown sans modifier le dépôt.

Agents pris en charge et lancement

Le dépôt est bien préparé pour travailler avec les outils CLI populaires. Claude Code, Grok et Pi sont officiellement recommandés comme premier maître principal. Codex et OpenCode ont également été testés.

Tmux est utilisé comme backend de terminal par défaut, mais zellij, cmux et Orca sont également pris en charge.

Le démarrage rapide ressemble à ceci :

gh auth login
git clone https://github.com/kunchenguid/firstmate
cd firstmate
claude

Après le démarrage, Claude Code récupérera les instructions de AGENTS.md, et vous n'aurez qu'à le saluer avec ahoy!.

À qui s'adresse ce projet

Si vous n'utilisez les assistants IA qu'occasionnellement pour de petits refactorings d'une seule fonction, firstmate peut sembler excessif. Mais lors d'un travail actif en parallèle sur plusieurs tâches, le projet fait gagner beaucoup de temps. L'isolation via git worktree empêche les modifications d'être écrasées, et un seul chat avec le premier maître élimine le besoin de basculer constamment entre une douzaine de fenêtres.