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 工具。