Plan Loop

计划循环

Plan Loop是一个MCP服务器，通过在磁盘上共享会话状态，在Claude Code（计划者）和Codex（审阅者）之间实现异步计划审查循环。

存储库布局

• packages/cli/src/：MCP服务器源代码（Node.js+TypeScript）
• packages/core/src/：MCP核心库（状态+工具）
• packages/vscode/：vscode扩展（仅限市场）
• .mcp.json.示例：mcp服务器配置示例（复制到 .mcp.json 使用）

快速启动

1. 安装和设置（推荐）

# Run once with npx (no install)
npx @joseph0926/plan-loop setup

# Or install globally
npm install -g @joseph0926/plan-loop
plan-loop setup

设置选项

plan-loop setup                    # Setup both Claude (project) + Codex (user)
plan-loop setup --claude           # Claude Code only (project scope)
plan-loop setup --claude --user    # Claude Code (user scope, ~/.claude.json)
plan-loop setup --codex            # Codex only (user scope)

1. 手动注册（可选）

克劳德代码 -添加到 .mcp.json （项目）或 ~/.claude.json （用户）：

{
  "mcpServers": {
    "plan-loop": {
      "command": "npx",
      "args": ["-y", "@joseph0926/plan-loop"]
    }
  }
}

法典 -添加到 ~/.codex/config.toml:

[mcp_servers.plan-loop]
command = "npx"
args = ["-y", "@joseph0926/plan-loop"]

1. 使用工具（示例）

pl_start({ goal: "Plan a login feature" })
pl_submit({ session_id: "550e8400-e29b-41d4-a716-446655440000", plan: "1. ..." })
pl_get_plan({ session_id: "550e8400-e29b-41d4-a716-446655440000" })
pl_feedback({ session_id: "550e8400-e29b-41d4-a716-446655440000", rating: "🟢", content: "LGTM" })

备注: session_id 必须是UUID v4格式。输入不区分大小写，内部标准化为小写。

工具列表

• pl_start：启动会话
• pl_submit：提交计划
• pl_get-plan：获取最新计划
• pl_feedback：提交对最新计划的反馈
• pl_get_reduction：获取最新反馈
• pl_status：获取完整会话数据
• pl_list：列出所有会话（带过滤器/排序）
• pl_delete：删除会话
• pl_force_approve：批准已耗尽的会话

代理协作

Claude Code（计划员）和Codex（审查员）合作审查计划。

快速开始

# 1. Claude-Code: Start session and submit plan
pl_start({ goal: "Implement login feature" })
pl_submit({ session_id: "...", plan: "1. DB schema..." })

# 2. Codex: Fetch plan and provide feedback
pl_get_plan({ session_id: "..." })
pl_feedback({ session_id: "...", rating: "🟡", content: "Please specify auth method" })

# 3. Claude-Code: Check feedback and revise
pl_get_feedback({ session_id: "..." })
pl_submit({ session_id: "...", plan: "Revised plan..." })

# 4. Codex: Approve
pl_feedback({ session_id: "...", rating: "🟢", content: "LGTM" })

详细代理指南

看 代理商.md 了解详细的工作流程和反馈自动完成指南。

与plan_version的乐观并发

pl_feedback 支持可选 plan_version 用于防止多代理工作流中出现竞争条件的参数：

# Without plan_version (default behavior)
pl_feedback({ session_id: "...", rating: "🟢", content: "LGTM" })

# With plan_version for race condition prevention
pl_feedback({ session_id: "...", rating: "🟢", content: "LGTM", plan_version: 1 })
# → On mismatch: "Plan version mismatch: expected=2, provided=1"

备注: plan_version 是一个从1开始的整数（第一个计划是版本=1）。

状态存储

会话文件存储在 ~/.plan-loop/sessions/.

发展

npm run dev
npm run build

示例配置

要将MCP配置添加到项目中，请执行以下操作：

cp .mcp.json.example .mcp.json

许可证

麻省理工学院

](https://lobehub.com/mcp/joseph0926-plan-loop)