firstmate : ce que le dépôt permet réellement

Une distribution d'agents, pas une application à installer

firstmate se présente comme une distribution d'agents : un répertoire portable d'instructions, de compétences, d'outils, de politiques et de conventions d'état qui transforme un agent de codage de terminal générique en agent spécialisé. Le README dit explicitement ce que le projet n'est pas : ni un modèle, ni un harnais, ni une compétence, ni un serveur MCP, ni une CLI. Il n'y a pas d'installeur ni d'application à installer. Le clonage du dépôt donne la distribution elle-même, composée de AGENTS.md, des compétences groupées et de scripts d'aide que tout agent de codage terminal pris en charge peut suivre. Lancer un harnais vérifié dans le clone instancie votre second et fait de vous le capitaine. Le dépôt est écrit en Shell, et sa description en une phrase résume l'idée : parlez à un agent, livrez avec un équipage.

Un seul interlocuteur et un équipage visible

Le modèle d'interaction n'a qu'un point de contact. Vous ne parlez qu'au second ; il répartit le travail entre les équipiers, les supervise jusqu'à l'achèvement, ne fait remonter que les vraies décisions et rapporte des résultats simples. Chaque équipier tourne dans son propre point de session visible : une fenêtre tmux par défaut, ou un onglet expérimental herdr ou zellij, un espace de travail cmux ou un terminal Orca, que vous pouvez regarder ou dans lesquels vous pouvez taper. Le schéma du README montre le flux : le capitaine discute, firstmate lit le répertoire des projets et route les demandes, chaque équipier tourne dans sa propre session avec son propre arbre de travail git, et le travail fini arrive sous forme de PR, de fusion locale approuvée ou de rapport autonome. Le README ne chiffre pas combien d'équipiers un second peut superviser ; il présente le modèle sans nombres d'échelle.

Isolation, formes de tâches et modes de projet

Chaque tâche s'exécute dans un arbre de travail git propre fourni par un outil que le README appelle treehouse, ou dans un arbre géré par Orca lorsque le backend est réglé sur orca ; le travail parallèle sur un même dépôt n'entre donc pas en collision. Le travail prend deux formes : les tâches ship livrent des modifications autorisées, les tâches scout laissent des rapports d'investigation autonomes lorsque le contrat d'admission justifie une recherche séparée. Chaque projet déclare aussi un mode de livraison : no-mistakes, direct-PR ou local-only, avec un drapeau d'autonomie +yolo facultatif. Le README nomme ces modes mais n'en définit pas le comportement exact ; il renvoie à docs/architecture.md pour le traitement complet. La sémantique précise de chaque mode n'est donc pas établie par le seul README.

Supervision zéro token et état survivant aux redémarrages

Un watcher bash dort au-dessus de la flotte et ne réveille le second que lorsque quelque chose requiert de l'attention ; le README appelle cela la supervision zéro token. Les harnais primaires vérifiés reçoivent aussi un garde-fou de fin de tour qui bloque ou suit un arrêt aveugle lorsque du travail est en cours et que la supervision n'est pas active. Tout l'état vit sur disque et dans le backend de session actif ; tuer la session à tout moment est présenté comme sûr : la session suivante se réconcilie et continue, y compris les agents secondmates confirmés morts. Le moteur de supervision, le garde-fou et le comportement de continuité sont documentés dans docs/verification/supervision.md et docs/turnend-guard.md, que le README présente comme des enregistrements de vérification actifs des mainteneurs, non comme une garantie de disponibilité.

Harnais requis et chemin de lancement

firstmate exige un harnais d'agent primaire vérifié : Claude Code, Grok, Pi, pi-signed, Codex ou OpenCode. Git et la CLI GitHub sont requis, authentifiés via gh auth login, et il faut la CLI et les dépendances du backend d'exécution choisi, tmux étant la référence par défaut. Claude Code, Grok et Pi sont présentés comme des recommandations primaires co-équivalentes, chacun avec son propre chemin de supervision ; Codex et OpenCode sont vérifiés mais portent davantage de compromis de supervision spécifiques au harnais. Le démarrage rapide tient en trois commandes shell : authentifier GitHub, cloner le dépôt et y entrer, puis lancer un harnais primaire co-recommandé pour que AGENTS.md prenne le relais. Le README donne les commandes de lancement exactes pour Claude Code, Grok et Pi, et renvoie à la documentation de chaque harnais pour la configuration spécifique au backend. Que tous les harnais listés se comportent de façon identique en pratique n'est pas établi par le README.

Compétences intégrées et organisation de la documentation

La distribution embarque cinq compétences intégrées invocables par l'utilisateur : /afk pour la supervision en mode absence, /ahoy pour un récapitulatif des événements de session visibles depuis le dernier message du capitaine, /bearings pour un résumé de chat en quatre sections, /updatefirstmate pour la mise à jour automatique par pulls fast-forward uniquement, et /stow pour balayer la session et y capter les connaissances durables non enregistrées. Le README documente aussi une organisation à deux niveaux : les compétences internes sous .agents/skills/ portent metadata.internal: true, ce qui les cache aux outils d'installation comme skills.sh ; les compétences publiques sous skills/ sont autonomes et indépendantes de firstmate, l'exemple actuel étant skills/stow. L'index de documentation liste architecture, configuration, guides de mise en place par backend, enregistrements de vérification et guide de contribution ; le README pointe vers tout cela sans en reproduire le contenu.

Contrôle pratique de firstmate

Reproduisez le quick start propre à FirstMate, vérifiez ses fichiers de configuration et observez la sortie de la commande principale. Un essai utile doit conserver la version, les entrées et les journaux afin de distinguer un comportement documenté d’une hypothèse.

Conclusion éditoriale

Reproduisez le quick start propre à FirstMate, vérifiez ses fichiers de configuration et observez la sortie de la commande principale. Un essai utile doit conserver la version, les entrées et les journaux afin de distinguer un comportement documenté d’une hypothèse. FirstMate est un projet de l’organisation kunchenguid dont le README définit le périmètre et le mode d’installation. Les métadonnées indiquent un dépôt actif, mais les étoiles ne prouvent ni maturité ni adéquation à un environnement donné. Les fonctions absentes de la source restent indéterminées. La licence MIT autorise les usages prévus par ses termes, sans constituer une garantie de sécurité, de support ou de résultat.

Sources officielles

1. Official README
2. Project repository