kunchenguid/firstmate

解決的問題

Firstmate 解決了開發者必須在不同終端會話與倉儲之間手動管理多個並行編碼任務（如修復 bug、研究、審計）的「標籤切換」問題。使用者不再需要逐一照看多個獨立的代理，而是與一個單一的「大副」代理互動，該代理負責管理一組自主工作的代理團隊，處理任務分派、監督與結果整合。

工作原理

Firstmate 作為一個「代理發行版」——一組指令、工具與策略——將通用編碼代理（如 Claude Code、Grok 或 Pi）轉變為監督者。

1. 聯絡模型：使用者與大副對話，大副隨後在隔離的會話後端（如 tmux、Zellij 或 Orca）中啟動船員代理。
2. 隔離：每個船員在獨立的乾淨 git 工作樹中執行（透過 treehouse 實現），防止並行任務發生衝突。
3. 監督：基於 bash 的零令牌監控器會持續監視整個艦隊，僅在需要人工干預或決策時喚醒大副。
4. 交付：任務分為「船」（產生 PR 或本地合併）或「偵察」（產生調查報告）。
5. 可擴展性：使用者可選擇加入「二副」（本地或遠端 SSH 主機上的持久代理）與「中繼」系統，以處理來自 X 和 Discord 的請求。

適用對象

使用 AI 編碼代理，並希望在不手動管理每個會話上下文與狀態的情況下，透過並行執行多個自主任務來提升生產力的開發者。

亮點

• 單一接觸點：與一個監督代理互動，即可管理整個代理艦隊。
• 可丟棄的工作樹：為每個任務提供獨立的隔離 git 環境，防止程式碼衝突。
• 多後端支援：相容多種終端多路複用器，包括 tmux、Herdr、Zellij、cmux 和 Orca。
• 與哈恩斯無關：支援多種主要代理哈恩斯，包括 Claude Code、Grok、Pi 和 Cursor Agent CLI。
• 重啟容錯狀態：所有狀態均持久化儲存在磁碟上，即使崩潰或重啟後也能恢復與續接會話。