字
字节笔记本
2026年5月3日
Ralph TUI - AI Agent 循环编排器
API中转
¥120
Ralph TUI 是一个 AI Agent 循环编排器，本质上是一个终端 UI 工具，用于编排 AI 编码助手自动完成任务列表。核心价值：将 AI 编码从"交互式对话"转变为"自主任务执行"。
核心组件
| 组件 | 功能 | 说明 |
|---|---|---|
| 任务跟踪器 | 管理 PRD 任务 | 支持 prd.json（简单格式）和 Beads（基于 git 的依赖管理） |
| AI Agent 集成 | 调用 AI 工具 | Claude Code, OpenCode, Factory Droid, Gemini CLI 等 |
| 执行引擎 | 自动执行任务 | 自动选择任务 → 构建提示 → 执行 Agent → 检测完成 → 循环下一个 |
| TUI 界面 | 可视化控制 | 实时显示 agent 输出、子 agent 追踪、执行控制 |
| 远程管理 | 多实例管理 | 从单一界面监控和控制多台机器上运行的 ralph-tui 实例 |
快速开始
安装
bash
bun install -g ralph-tui初始化项目
bash
cd your-project
ralph-tui setup交互式配置：
- 选择默认 agent（claude-code/opencode/等）
- 选择 tracker 类型（prd.json/beads）
- 自动生成配置文件到
.ralph-tui/config.toml
创建 PRD（产品需求文档）
方式 A：使用 AI 创建（推荐）
bash
ralph-tui create-prd --chat
# 或使用别名
ralph-tui prime方式 B：手动创建 prd.json
json
{
"title": "My Blog",
"description": "A blog system with Next.js",
"tasks": [
{
"id": "task-1",
"title": "Setup database schema",
"description": "Create users and posts tables",
"priority": "high",
"status": "todo"
},
{
"id": "task-2",
"title": "Build API endpoints",
"description": "Create REST API for CRUD operations",
"priority": "medium",
"status": "todo"
}
]
}启动自动执行
bash
ralph-tui run --prd ./prd.json会发生什么：
- TUI 界面启动
- Ralph 自动选择第一个高优先级任务
- 调用 AI agent 执行任务
- 实时显示 agent 输出
- 任务完成后自动进入下一个
任务跟踪器选择
1. JSON File Tracker（推荐新手）
特点：
- 最简单，零学习成本
- 单个文件，易于理解
- 适合个人项目
- 不支持任务依赖关系
适用场景： 快速原型开发、个人小项目、第一次使用 Ralph
2. Beads Issue Tracker（推荐团队）
特点：
- 支持任务依赖（task-2 依赖 task-1）
- 基于 git，易于版本控制
- 支持多人协作
适用场景： 中大型项目、团队协作、需要任务依赖管理
3. Beads + Beads Viewer（Smart Mode）
智能任务选择系统
- 使用 PageRank 计算任务重要性
- 使用 Critical Path 找出关键路径
- 不是按顺序执行，而是用算法计算最优执行顺序
适用场景： 大型复杂项目、任务依赖关系复杂、需要优化执行效率
TUI 快捷键
| 键 | 功能 |
|---|---|
s | 开始执行 |
p | 暂停/恢复 |
d | 切换仪表板 |
T | 切换子 agent 树面板 |
t | 循环子 agent 详细级别 |
o | 循环右侧面板视图 |
q | 退出 |
? | 显示帮助 |
1-9 | 切换到 tab 1-9 |
会话管理
查看所有会话
bash
ralph-tui resume --list恢复会话
方式 1：恢复指定会话
bash
ralph-tui resume a1e03fbb
# 或只用前几位
ralph-tui resume a1e0方式 2：恢复当前目录会话
bash
cd /path/to/project
ralph-tui resume常用命令速查
基础命令
bash
ralph-tui # 启动 TUI
ralph-tui run --prd FILE # 运行
ralph-tui resume # 恢复
ralph-tui status # 状态
ralph-tui logs # 日志配置管理
bash
ralph-tui setup # 初始化
ralph-tui config show # 查看配置
ralph-tui template show # 查看模板运行选项
bash
--agent AGENT # 指定 agent
--model MODEL # 指定 model
--iterations N # 限制迭代次数
--headless # 无 UI 模式
--sandbox # 沙箱模式
--theme THEME # 主题远程实例管理
服务器端启动
bash
ralph-tui run --listen --prd ./prd.json客户端连接
bash
# 添加远程服务器
ralph-tui remote add prod server.example.com:7890 \
--token OGQwNTcxMjM0NTY3...
# 测试连接
ralph-tui remote test prod
# 列出所有远程
ralph-tui remote list集成 Claude Code Skills
安装 Skills
bash
# 安装到所有检测到的 agents
bunx add-skill subsy/ralph-tui --all
# 安装到特定 agent
bunx add-skill subsy/ralph-tui -a claude-code -g -y在 Claude Code 中使用
text
/ralph-tui-prd # 创建 PRD
/ralph-tui-create-json # 转换为 prd.json
/ralph-tui-create-beads # 转换为 Beads issues核心价值
| 开发方式 | 时间成本 | 交互需求 |
|---|---|---|
| 手动开发 | 2-3 天 | 持续 |
| AI 对话式开发 | 1 天 | 频繁 |
| Ralph 自动开发 | 1 小时 | 最小 |
优势：
- 解放双手：AI 自动完成所有编码工作
- 可恢复：随时暂停，随时恢复
- 可追溯：每个任务自动 git commit
- 可观测：实时看到 AI 在做什么
- 可扩展：轻松添加新功能
适用场景
- MVP 快速开发
- 重复性功能实现
- 代码重构/迁移
- 多环境部署管理
- 需要长时间自主工作的场景
参考链接
- GitHub 仓库: https://github.com/subsy/ralph-tui
- 官方文档: https://ralph-tui.dev
分享: