Mozzie

Mozzie 是什麼？

Mozzie 是本地優先桌面應用，能將 AI 程式代理視為受控工作團隊進行協調。不像一次只執行單一代理工作階段，您描述想建置的內容，Mozzie 會將工作拆分成項目、並行執行多個代理，並透過 git 工作流程協調輸出。

應用程式設計為將工作與協調保留在您的機器上。它為每個工作項目建立獨立的 git worktree、管理項目間相依性，並提供審核流程，讓您在合併前核准或拒絕變更。

主要功能

• 本地優先執行與離線工作流程：使用本機 SQLite 資料庫，所有內容包含代理執行工作流程皆在本機運行。
• 自然語言轉換為工作項目：協調器將您的請求轉換為工作項目、設定執行順序，並指派代理。
• 並行多代理支援：同時執行多個程式代理，內建支援 Claude Code、Gemini CLI、Codex CLI 及自訂 CLI/腳本。
• 每個工作項目的 git worktree 隔離：每個工作項目在其專屬 worktree 與分支中執行，減少代理執行間的衝突。
• 審核 + 合併工作流程：代理完成後，Mozzie 提供 diff/審核步驟；核准則推送至 origin，拒絕則將回饋納入下次嘗試。
• 相依圖與受阻項目自動啟動：工作項目可互相相依；受阻項目在相依完成時自動啟動，並包含循環偵測。
• 子工作項目（堆疊分支）與父子合併：子分支合併至父工作項目；父項目以單一 PR 推送至 origin。
• 跨工作階段持續對話：協調器脈絡會保留，讓您從中斷處繼續。
• 代理輸出即時串流：可即時觀看代理輸出，包含工具呼叫活動視覺化。

如何使用 Mozzie

1. 安裝先決條件：使用 Node >= 20、pnpm >= 9、Rust (stable)，以及平台專屬 Tauri 先決條件。確保至少安裝一個 AI 程式代理 CLI。
2. 設定應用程式：
   • 複製儲存庫並安裝相依性 (pnpm install)。
   • 啟動開發應用程式 (pnpm dev)。應用程式將自動開啟。
3. 設定提供者與代理：
   • 在 開啟設定 (齒輪圖示) 中，為您的 LLM 協調器提供者新增 API 金鑰 (OpenAI、Anthropic 或 Gemini)。
   • 新增您想執行的程式代理設定 (例如 Claude Code、Gemini CLI、Codex 或自訂)。
4. 建立並執行工作項目：
   • 建立工作項目、指向儲存庫、指派代理並啟動執行。
   • 或者，開啟命令列 (Ctrl+K)、描述想建置的內容，讓協調器建立工作項目並排程。
5. 審核與合併：
   • 工作項目到達審核時，核准以推送變更至 origin。
   • 拒絕以提供回饋；Mozzie 會將完整嘗試歷史與拒絕原因納入代理的下次提示。

使用情境

• 將功能請求拆分成多個並行程式任務：透過命令列描述較大變更；Mozzie 拆分成工作項目，並同時執行支援代理以產生可審核分支。
• 在儲存庫工作時隔離代理輸出：實驗多種方法時，每個工作項目在其專屬 git worktree 與分支中執行，避免代理互相干擾。
• 處理多步驟相依性 (例如先建構後實作)：建立具相依性的工作項目，讓受阻項目僅在先決項目完成後自動啟動，並包含循環偵測避免循環計畫。
• 失敗嘗試後以結構化回饋迭代：審核時拒絕工作項目並加入回饋；Mozzie 將完整嘗試歷史 (包含拒絕原因) 注入下次執行，減少重複錯誤。
• 單一桌面應用程式工作階段管理多專案：使用多工作區支援，在同一應用程式中執行與審核跨多個儲存庫的工作項目。

常見問題

• Mozzie 需要雲端連線才能執行嗎？ Mozzie 是本地優先的，並可完全離線運作。

• 它能執行哪些 AI 程式代理？ 儲存庫列出內建支援 Claude Code（透過 ACP/stdio 傳輸）、Gemini CLI、Codex CLI，以及自訂 CLI/腳本。

• Mozzie 如何防止代理之間的衝突？ 它為每個工作項目建立獨立的 git worktree 和分支，因此並行執行不會共用相同工作目錄。

• 如果我在審核時拒絕工作項目，會發生什麼？ Mozzie 會將完整嘗試歷史和您的拒絕理由加入代理的下一個提示中，狀態可從審核返回重新執行路徑。

• 工作項目可以互相依賴嗎？ 可以。Mozzie 支援相依圖形，依賴完成時自動啟動被阻擋項目，並包含循環偵測。

替代方案

• 單一代理 IDE 工具或聊天式程式助理：適合一次只用一個代理工作階段；它們通常不提供相同的工作項目相依協調和 git worktree 隔離。
• 本地腳本執行器，將多任務派發至 CLI：您可以並行化代理指令，但需自行建置協調、相依管理和審核流程。
• 基於 CI/CD 的程式碼生成與 PR 審核自動化：可處理審核閘道和分支，但較不適合互動式本地「單一視窗」協調流程。
• 無本地優先 git worktree 的 AI 代理工作流程/協調工具：這些可能協調代理呼叫，但可能不提供 Mozzie 所述的特定 git worktree 隔離和堆疊分支合併流程。