Stop met het Jongleren van AI-Agents in de Terminal en Organiseer een Team met Firstmate

Herkenbaar tafereel: je opent vijf terminaltabs, elk met zijn eigen codeeragent. De ene repareert een onstabiele test, een andere herschrijft componenten voor dark mode, een derde voert een afhankelijkhedsaudit uit. Tien minuten later breekt de chaos uit. Welke agent is klaar? Waar faalden de tests? Welke branch is zojuist samengevoegd?

Het firstmate-project biedt een andere aanpak. In plaats van elke agent handmatig te besturen, communiceer je met één hoofdassistent — de first mate. Je geeft hen taken, en zij verdelen ze naar autonome "sailors" in geïsoleerde omgevingen.

Wat is een agent distro

De makers van firstmate beschrijven hun project niet als nog een CLI-hulpprogramma of framework, maar als een agent distro. In wezen is het een draagbare set instructies in AGENTS.md-formaat, kant-en-klare vaardigheden, scripts en gedragsregels.

Je kloont de repository naar je machine, voert je vertrouwde CLI-tool erin uit (zoals Claude Code of Grok), en het pikt dynamisch de logica op voor het beheren van het hele team. Er hoeven geen extra applicaties of zware afhankelijkheden op je systeem te worden geïnstalleerd.

Hoe de architectuur werkt

Het hele idee is gebouwd op verantwoordelijkheidsscheiding en isolatie van werkruimtes.

Je geeft opdrachten aan de first mate via één enkele chat. Bijvoorbeeld: "review project xyz, repareer de falende autorisatietest en voeg dark mode toe."

De first mate kloont de repository naar de projects/-map en maakt taken aan.

Voor elke taak wordt een apart terminalvenster geopend (tmux, zellij, cmux of Orca) en wordt een geïsoleerde git working tree aangemaakt met behulp van het treehouse-hulpprogramma.

Autonome sailors werken parallel, zonder elkaar te hinderen of de hoofdc codebase te breken.

Nadat taken zijn voltooid, verzamelt de first mate de resultaten en levert een kant-en-klare pull request of onderzoeksrapport op.

Een interessant detail: het monitoringsproces verbruikt geen neurale netwerktokens. Een achtergrond bash-script monitort de sessiestatus. Het slaapt totdat er een gebeurtenis optreedt in een van de vensters of een sailor een menselijke beslissing nodig heeft. Pas dan wordt de first mate gewekt en krijgt een korte samenvatting.

Modi en opdrachten

Het project heeft ingebouwde vaardigheden die rechtstreeks vanuit de chat worden aangeroepen:

• /afk schakelt het systeem over naar afwezigheidsmodus. Het achtergrondproces verwerkt kleine technische berichten zelf, terwijl echt belangrijke vragen worden verzameld in een digest en worden voorbereid voor je terugkeer.
• /bearings genereert een korte samenvatting van alle lopende taken en actieve pull requests.
• /ahoy helpt je snel bij te praten door de gebeurtenistijdlijn en vragen die je goedkeuring vereisen te tonen.
• /stow verwerkt opgehoopte context, slaat belangrijke kennis op schijf op en archiveert verouderde gegevens, waardoor tokenbudget wordt bespaard.

Naast standaardontwikkeling met PR-creatie heeft firstmate een onderzoeksmodus (scout). Als je een beveiligingsaudit moet uitvoeren of de code van iemand anders wilt verkennen in plaats van wijzigingen aan te brengen, zal de sailor een gedetailleerd rapport in een Markdown-bestand opstellen zonder de repository te wijzigen.

Ondersteunde agents en opstarten

De repository is goed voorbereid voor het werken met populaire CLI-tools. Claude Code, Grok en Pi worden officieel aanbevolen als de hoofd-first mate. Codex en OpenCode zijn ook getest.

Tmux wordt gebruikt als de standaard terminalbackend, maar zellij, cmux en Orca worden ook ondersteund.

Snel starten ziet er zo uit:

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

Na het opstarten zal Claude Code de instructies uit AGENTS.md oppikken, en hoef je alleen maar te begroeten met ahoy!.

Voor wie is dit project

Als je AI-assistenten maar af en toe gebruikt voor kleine refactoring van een enkele functie, kan firstmate overbodig lijken. Maar bij actief parallel werken aan meerdere taken bespaart het project veel tijd. Isolatie via git worktree voorkomt dat wijzigingen worden overschreven, en één chat met de first mate elimineert de noodzaak om voortdurend te schakelen tussen een dozijn vensters.