Come smettere di gestire più agenti AI nel terminale e organizzare un team con Firstmate

Situazione familiare: apri cinque tab del terminale, ognuna con il proprio agente di codifica. Uno sistema un test flaky, un altro riscrive i componenti per la dark mode, un terzo esegue un audit delle dipendenze. Dieci minuti dopo, il caos. Quale agente ha finito? Dove sono falliti i test? Quale branch è stato appena mergiato?

Il progetto firstmate offre un approccio diverso. Invece di controllare manualmente ogni agente, comunichi con un assistente principale — il first mate. Gli affidi i task, e lui li distribuisce ai "sailor" autonomi in ambienti isolati.

Cos'è un agent distro

I creatori di firstmate descrivono il loro progetto non come un'altra utility CLI o framework, ma come un agent distro. In sostanza, è un set portatile di istruzioni in formato AGENTS.md, competenze pronte all'uso, script e regole comportamentali.

Cloni il repository sulla tua macchina, esegui il tuo solito strumento CLI al suo interno (come Claude Code o Grok), e questo recupera dinamicamente la logica per gestire l'intero team. Non servono applicazioni aggiuntive o dipendenze pesanti da installare sul sistema.

Come funziona l'architettura

L'intera idea si basa sulla separazione delle responsabilità e sull'isolamento degli spazi di lavoro.

Dai comandi al first mate attraverso una singola chat. Per esempio: "fai code review del progetto xyz, sistema il test di autorizzazione che fallisce, e aggiungi la dark mode".

Il first mate clona il repository nella cartella projects/ e crea i task.

Per ogni task, viene lanciata una finestra di terminale separata (tmux, zellij, cmux, o Orca) e viene creato un git working tree isolato usando lo strumento treehouse.

I sailor autonomi lavorano in parallelo, senza interferire tra loro o rompere il codebase principale.

Dopo il completamento dei task, il first mate raccoglie i risultati e consegna una pull request pronta o un report di ricerca.

Un dettaglio interessante: il processo di monitoraggio non consuma token della rete neurale. Uno script bash in background monitora lo stato della sessione. Rimane inattivo fino a quando non si verifica un evento in una delle finestre o un sailor ha bisogno di una decisione umana. Solo allora l'osservatore risveglia il first mate e gli passa un breve riepilogo.

Modalità e comandi

Il progetto ha competenze integrate che vengono invocate direttamente dalla chat:

• /afk attiva la modalità away. Il processo in background gestisce autonomamente i messaggi tecnici minori, mentre le domande genuinamente importanti vengono raccolte in un digest e preparate per il tuo ritorno.
• /bearings genera un breve riepilogo di tutti i task in esecuzione e delle pull request attive.
• /ahoy ti aiuta a recuperare rapidamente il contesto mostrando la timeline degli eventi e le domande che richiedono la tua approvazione.
• /stow elabora il contesto accumulato, salva le informazioni importanti su disco e archivia i dati obsoleti, risparmiando budget di token.

Oltre allo sviluppo standard con creazione di PR, firstmate ha una modalità ricerca (scout). Se hai bisogno di fare un audit della sicurezza o esplorare il modulo di qualcun altro invece di modificare il codice, il sailor compilerà un report dettagliato in un file Markdown senza modificare il repository.

Agenti supportati e avvio

Il repository è ben preparato per lavorare con i popolari strumenti CLI. Claude Code, Grok e Pi sono ufficialmente raccomandati come first mate principale. Anche Codex e OpenCode sono stati testati.

Tmux viene usato come backend terminale predefinito, ma sono supportati anche zellij, cmux e Orca.

Il quick start funziona così:

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

Dopo l'avvio, Claude Code recupererà le istruzioni da AGENTS.md, e dovrai solo salutarlo con ahoy!.

Per chi è questo progetto

Se usi assistenti AI solo occasionalmente per piccoli refactoring di una singola funzione, firstmate potrebbe sembrare eccessivo. Ma quando lavori attivamente in parallelo su più task, il progetto fa risparmiare molto tempo. L'isolamento tramite git worktree impedisce che le modifiche vengano sovrascritte, e una singola chat con il first mate elimina la necessità di passare costantemente tra una dozzina di finestre.