umputun/ralphex

这是什么？

核心功能

• 01每个计划任务在新的 Claude Code 或 codex 会话中执行，并在每个任务后运行验证命令。
• 02多阶段审查流程，包含并行审查代理和可选的外部审查工具。
• 03根据计划文件名自动创建 git 分支，每个任务和审查修复后自动提交。
• 04支持 git worktree，可在同一仓库中并行执行多个计划。
• 05通过 --serve 参数提供实时浏览器看板。
• 06可在 Docker 容器中运行，限制自主代理可访问的范围。

适用场景

• 离开终端时，按书面计划自动完成包含多个任务的功能开发。
• 对其他工具或手动修改的分支代码运行自动化审查。
• 借助独立 worktree 同时执行多个相互独立的计划。
• 在不使用 Claude 订阅的情况下，将 codex 作为唯一执行器。

快速上手

1. 1

   使用 Go 安装 ralphex

2. 2

   在 docs/plans/ 中创建计划文件

3. 3

   对计划文件运行 ralphex

   ralphex docs/plans/my-feature.md

使用前须知

• !需要另外配置 Claude Code 或 codex 编码代理。
• !默认的 Claude 模式使用 claude --print，从 2026 年 6 月 15 日起将计入 Anthropic 的 Agent SDK 信用额度。

收录于专题

标签

常见问题

ralphex 是什么？

一个独立的 Go 命令行工具，驱动 Claude Code 或 codex 按 Markdown 实施计划自动完成任务，并进行多阶段代码审查。 ralphex 是一个在 git 仓库根目录运行的命令行工具，它调用 Claude Code 或 codex CLI，无人值守地执行实施计划。计划是一个包含任务和验证命令的 Markdown 文件。每个任务都在新的编码代理会话中执行，避免上下文随计划推进而变长导致质量下降。每个任务完成后运行验证命令，勾选任务复选框并自动提交。

ralphex 可以免费使用吗？用的什么许可证？

ralphex 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

ralphex 还在维护吗？

活跃维护中。ralphex 最近一次提交是在 2026年11月2日。

ralphex 适合用来做什么？

离开终端时，按书面计划自动完成包含多个任务的功能开发。 对其他工具或手动修改的分支代码运行自动化审查。 借助独立 worktree 同时执行多个相互独立的计划。 在不使用 Claude 订阅的情况下，将 codex 作为唯一执行器。

ralphex 怎么安装和运行？

使用 Go 安装 ralphex 在 docs/plans/ 中创建计划文件 对计划文件运行 ralphex: ralphex docs/plans/my-feature.md

在哪里获取 ralphex？

源代码和安装说明在 GitHub 上：https://github.com/umputun/ralphex