automagik-dev/genie

Wishes in, PRs out. CLI agent that interviews you, plans the work, dispatches parallel agents in isolated worktrees, and reviews code before you see it.

它解決了什麼

Genie 是一個為 AI 程式編寫代理（例如 Claude Code 與 Codex）設計的規劃與執行層，旨在透過結構化的多步驟工作流程，將模糊的想法轉化為可合併的 Pull Request。它透過強制執行嚴格的腦力激盪、設計審查、規劃與獨立實作審查序列，防止「幻覺迴圈」。

工作原理

Genie 使用結合 Git 為基礎的文件與本機 SQLite 資料庫來追蹤狀態。流程遵循特定的生命週期：

  1. Brainstorming: 將想法細化為 DESIGN.md 檔案。
  2. Wishing: 將設計轉換為具範圍的 WISH.md，其中包含執行群組。
  3. Planning: 審查並批准計畫。
  4. Work: 派遣原生角色代理以平行方式建構已批准的群組。
  5. Review: 獨立的審查代理（與工程師代理分離）根據驗收標準驗證實作。

作業狀態儲存在單一的 .genie/genie.db 檔案中，允許多個 Git worktree 共享相同的任務狀態，且不需要背景守護程序。

目標對象

使用 AI 程式編寫代理的開發者，想要更嚴謹、結構化的功能開發方式，並需要管理需要規劃與多代理平行執行的複雜任務。

重點特色

  • Git-native state: 願望與設計皆為以 Git 版本控制的純 markdown 檔案。
  • Zero-daemon architecture: 不需要背景程序或大型資料庫（如 Postgres）；使用 SQLite 檔案即可。
  • Warp Cockpit: 可將願望的已就緒群組以單一視窗的方式在 Warp 終端機中啟動，每個群組在其自己的 worktree 中佔用一個分割窗格。
  • Omni Bridge: 透過 Omni hub 與 WhatsApp 整合，以進行遠端批准與短任務。
  • MCP Server: 提供唯讀的 Model Context Protocol (MCP) 伺服器，將任務與看板狀態曝光給其他 AI 工具。