文档
AI 助手可以执行编程任务。本指南介绍命令行工具(CLI)、终端菜单(TUI)、保持任务运行的终端工具 tmux,以及 AI 工具之间的标准连接(MCP)。
安装
需要 macOS、Linux 或 WSL,Node 22.12 或更新版本,tmux 3.0 或更新版本,以及至少一个装好并登录过的提供方 CLI。
$ pnpm add -g reevesagents$ reevesagents doctor$ reevesagentsreevesagents doctor 会把这些逐项检查一遍。reevesagents setup 以首次运行向导的形式做同样的检查,加上 --attach 还会把 MCP 连接到每个已安装的宿主。快速上手
启动一支团队,查看进展,随时插手,最后把它停掉。
启动团队
reevesagents spawn cc:lead codex:api kimi:docs \
--name "feature x" --prompt "Build feature X. The lead splits the work."每个助手写成 provider[:nickname[:model]],排在第一个的当主控。用 reevesagents add 可以往最近的运行里添加助手。
观察与操控
reevesagents runs
reevesagents peek api -n 40
reevesagents send api "run the tests"
reevesagents key api enter
reevesagents open apisend 只粘贴文本、不提交,所以后面要跟一条 key <agent> enter。open 带你跳到 tmux 里的那个助手。
停止
reevesagents stop "feature x" --yesstop、kill 和各个 delete 命令会等你给出 --yes(或 ALLOW_DESTRUCTIVE=1)才执行。终端菜单、浏览器和命令
菜单(TUI)、浏览器界面和命令行工具(CLI)共享 ~/.reeves 下的任务记录。终端工具 tmux 让助手持续运行。
- 不带参数输入
reevesagents,打开的就是 TUI。它会把自己包进一个名为reeves的 tmux 会话,设置REEVES_NO_TMUX_WRAPPER=1可以关掉这层包装。 reevesagents web在127.0.0.1上启动 Web UI,端口是 8080 或下一个空闲端口。它会拒绝非回环地址的 Host 头和跨域写入。按 Ctrl+C 停掉它,你的助手不受影响。- 每项操作也都有对应的 CLI 命令。脚本应该读取
--json,纯文本输出在不同版本之间可能会变。 - 最底层是 tmux:每次运行一个会话,每个助手一个窗口。无论你身在何处,
reevesagents open <id>都能跳到对应的窗口。
智能体控制(MCP)
通过标准协议(MCP)把一个编程工具连接到其他工具。此功能可按需开启。连接后请重启工具。
reevesagents attach cc
reevesagents hosts- 能当宿主的 CLI 有六个:Claude Code、Codex、Kimi Code、Qwen Code、Hermes 和 OpenCode。
reevesagents attach不带名字时会附加到所有已安装的宿主,reevesagents detach <cli>则把它移除。 - 宿主拿到的是一组朴素的工具:生成助手、粘贴文本、按键、读取输出、处理审批。团队具体做什么,由给宿主下提示词的人决定。
- 被生成的工作助手要等你把它们的 CLI 也附加上,才会拿到这些工具。通过 MCP 生成助手时,
max_agents(默认 100)会限制每次运行的助手数量。
命令
所有 reevesagents 子命令。不带参数时打开 TUI。
运行
spawn [spec...]启动一次运行。每个智能体使用 provider[:nickname[:model]] 格式,第一个智能体担任负责人。选项:
add [spec...]向最近的活跃运行添加智能体。选项:
runs列出活跃运行。
open <id>在 tmux 中打开运行或智能体窗口。接受 ID、名称、昵称或唯一前缀。
peek <agent-id>显示一个智能体的最近输出。
stop <run-id>需要 停止一次运行并关闭其 tmux 会话。
kill <agent-id>需要 停止一个智能体。最后一个活跃智能体停止后,运行也随之结束。
驱动助手
send <agent-id> <text...>将文本粘贴到智能体输入区,但不提交。
key <agent-id> <key>发送一个允许的按键:enter、escape、backspace、tab、space、up、down、left、right、
interrupt <agent-id>发送
记录与历史
agents [run-id]列出所有活跃运行或指定运行中的智能体。
providers列出提供方、可用状态和已知模型。
tools列出智能体工具的安装和登录状态。
delete <agent-id>需要 删除已结束智能体的记录。
delete-run <run-id>需要 删除已结束的运行。
history列出已归档的运行。
delete-history <id>需要 删除一条历史记录。
审批
approvals列出待处理的审批请求。
approve <approval-id> [note]批准待处理的审批请求。
deny <approval-id> [note]拒绝待处理的审批请求。
MCP 宿主
hosts列出支持 MCP 的宿主 CLI 及其连接状态。
attach [cli]通过宿主的 CLI 命令或配置文件,将 MCP 连接到一个宿主 CLI 或所有已安装的宿主。
detach <cli>通过宿主的 CLI 命令或配置文件,从一个宿主 CLI 移除 MCP。
mcp通过 stdio 启动智能体控制 MCP 服务器。此命令由宿主 CLI 执行。
配置与预设
config [key] [value]显示、读取或修改一个可编辑的配置字段。
presets列出已保存的预设。
save-preset <run-id> <name> [description...]将活跃运行保存为预设。
start-preset <name>从预设启动运行。
delete-preset <name>需要 删除一个预设。
初始化与工具
setup首次设置时检查 tmux、Node 和已安装的 CLI。
doctor检查运行环境。失败时返回非零退出码。
skills [action]为兼容的 CLI 安装、移除或检查 ReevesAgents 技能:install、remove、status(默认)。
reap停止窗口已消失或超过 max_lifetime_ms 的智能体,并关闭孤立的 tmux 会话。
web在前台启动仅监听本地回环地址的 Web 界面。
MCP 工具
附加了 MCP 的 CLI 可以调用的 31 个工具,按用途分组。
生成与驱动
spawn必填provider可选run_idmodeltasknicknamenameworking_dirpermissionsauth_modeeffortextra_args启动一个智能体。不传 run_id 时复用当前 MCP 会话的运行,该运行在首次调用时创建;传入 run_id 则选择其他运行。
kill必填agent_id停止一个智能体。
stop必填run_id停止整个运行并关闭其 tmux 会话。
send_text必填agent_idtext将文本粘贴到智能体输入区,但不提交。
send_key必填agent_idkey发送一个允许的按键,例如 enter、escape 或
interrupt必填agent_id向智能体发送
read必填agent_id可选lines读取终端窗格的最近输出,移除 ANSI 序列并隐藏敏感数据。 默认读取 20 行。
查看
list列出运行和智能体。
list_providers此计算机的提供方和模型目录。
list_tools此计算机的工具目录:智能体可以在自己的 shell 中运行的辅助 CLI,含安装和登录状态。
list_history已归档的运行。
list_presets已保存的运行预设。
list_hosts支持 MCP 的 CLI 及其连接状态。
get_config当前全局配置。
doctor环境检查。
审批
request_approval必填agent_idactionsummary可选detailsrisk创建审批请求。
resolve_approval必填approval_iddecision可选note批准或拒绝待处理的请求。
check_approval必填approval_id读取一条审批请求。
list_approvals可选run_idstatus列出审批请求,支持可选筛选条件。
生命周期
delete必填agent_id删除已结束智能体的记录。
delete_run必填run_id删除已结束的运行。
delete_history必填id删除一条历史记录。
open必填id将已连接的 tmux 客户端切换到指定运行或智能体。
reap立即清理窗口已消失或运行时间超限的智能体,以及孤立的 tmux 会话。
配置与预设
set_config可选peek_interval_mspeek_linesmax_depthmax_agentsready_delay_msmax_lifetime_msdefault_permissionslanguage修改一个或多个可编辑的配置字段。
save_preset必填run_idname可选description将活跃运行保存为预设。
start_preset必填name可选run_nameworking_dir从预设启动运行。
delete_preset必填name删除一个预设。
宿主与技能
attach_host可选key将 MCP 连接到一个宿主 CLI 或所有已安装的宿主。
detach_host必填key从一个宿主 CLI 移除 MCP。
install_skills可选status为兼容的 CLI 安装 ReevesAgents 技能,或显示其所在位置。
reevesagents://providers, reevesagents://guide配置
设置保存在 ~/.reeves/config.json 里,可以用 reevesagents config <key> <value> 修改,也可以在设置界面里改。界面支持十种语言,用 reevesagents config language tr 这样的命令切换。
字段
peek_interval_ms5000
保存的输出轮询间隔设置。当前界面使用固定的刷新间隔。
peek_lines10
保存的输出行数设置。当前界面和 CLI/MCP 读取使用各自的行数。
max_agents100
每次运行的活跃智能体上限,由 MCP spawn 执行。其他启动界面不执行此限制。
max_depth5
保存的递归深度设置。当前运行引擎不执行此限制。
ready_delay_ms5000
在粘贴初始文本前等待新 CLI 就绪的时间。
max_lifetime_ms0
停止运行时间超过此值的智能体。0 表示关闭此限制。
default_permissionsask
新智能体的默认权限模式:ask 或 skip。
languageen
界面语言,使用十个受支持的语言代码之一。
peek_interval_ms | 5000 | 保存的输出轮询间隔设置。当前界面使用固定的刷新间隔。 |
peek_lines | 10 | 保存的输出行数设置。当前界面和 CLI/MCP 读取使用各自的行数。 |
max_agents | 100 | 每次运行的活跃智能体上限,由 MCP spawn 执行。其他启动界面不执行此限制。 |
max_depth | 5 | 保存的递归深度设置。当前运行引擎不执行此限制。 |
ready_delay_ms | 5000 | 在粘贴初始文本前等待新 CLI 就绪的时间。 |
max_lifetime_ms | 0 | 停止运行时间超过此值的智能体。0 表示关闭此限制。 |
default_permissions | ask | 新智能体的默认权限模式:ask 或 skip。 |
language | en | 界面语言,使用十个受支持的语言代码之一。 |
磁盘上的状态
~/.reeves/
config.json
presets/<name>.json
runs/<run-id>/
run.json
agents/<agent-id>.json
approvals/<approval-id>.json
history/runs/<run-id>.json环境变量覆盖
REEVES_REGISTRY覆盖状态数据的根目录(默认
REEVES_CONFIG覆盖配置文件路径。
REEVES_NO_TMUX_WRAPPER=1设为 1 时,不自动在 tmux 会话中启动 TUI。
REEVES_NO_COLOR=1设为 1 时,关闭 TUI 颜色。
ALLOW_DESTRUCTIVE=1设为 1 时,允许不带
REEVES_DOCTOR_SKIP_PROVIDER_COMPAT=1设为 1 时,跳过 doctor 的提供方兼容性检查。
提供方
共 25 个 CLI,每个都有一个写在 spawn 规格里的短 id。模型列表只是建议,你传入的任何模型 id 都会原样交给提供方。
Claude CodeMCP 宿主
Anthropic 的终端编程助手
id
cc可执行文件claude建议模型 fable, opus, sonnet, haiku
Codex CLIMCP 宿主
OpenAI 的编程助手 CLI
id
codex可执行文件codex建议模型 gpt-5.6-sol, gpt-5.5, gpt-5.4-mini
OpenCode CLIMCP 宿主
开源的终端编程助手
id
opencode可执行文件opencode建议模型 opencode/claude-sonnet-4-6, opencode/claude-opus-4-8, opencode/gpt-5.2-codex, anthropic/claude-opus-4-8, anthropic/claude-haiku-4-5, openai/gpt-5.5
HermesMCP 宿主
Nous Research 的助手 CLI
id
hermes可执行文件hermes建议模型 anthropic:claude-opus-4-8, anthropic:claude-fable-5, openai-codex:gpt-5.5, openai-codex:gpt-5.4-mini
Kimi CodeMCP 宿主
Moonshot AI 的编程 CLI
id
kimi可执行文件kimi建议模型 kimi-code/k3, kimi-code/kimi-for-coding, kimi-code/kimi-for-coding-highspeed
DeepSeek CLI
DeepSeek 的编程 CLI
id
deepseek可执行文件deepseek建议模型 deepseek-v4-pro, deepseek-v4-flash
Pi
极简的终端编程框架
id
pi可执行文件pi建议模型 sonnet, opus, deepseek/deepseek-chat, openai/gpt-4o
Qwen CodeMCP 宿主
Alibaba 的编程助手 CLI
id
qwen可执行文件qwen建议模型 qwen3-coder-plus, qwen3-coder-flash, qwen3-coder-next
Aider
终端里的 AI 结对编程
id
aider可执行文件aider建议模型 sonnet, opus, haiku, deepseek/deepseek-chat
Gemini CLI
Google 的开源终端助手
id
gemini可执行文件gemini建议模型 gemini-3.1-pro-preview, gemini-3.5-flash, gemini-3.1-flash-lite
Cline CLI
自主运行的编程助手 CLI
id
cline可执行文件cline建议模型 anthropic/claude-sonnet-4-6, anthropic/claude-opus-4-8, google/gemini-3.1-pro
Crush
Charm 的终端编程助手
id
crush可执行文件crush建议模型 在 CLI 内选择
Goose
开源的通用 AI 助手
id
goose可执行文件goose建议模型 claude-sonnet-4-6, claude-opus-4-8, deepseek-v4-pro
Kilo Code
带 CLI 的开源编程助手
id
kilo可执行文件kilo建议模型 kilo/~anthropic/claude-sonnet-latest, kilo/~anthropic/claude-opus-latest, kilo/~google/gemini-pro-latest, kilo/~openai/gpt-sol-latest
Letta Code
带长期记忆的编程助手
id
letta可执行文件letta建议模型 zai-org/GLM-5.3-max, moonshotai/Kimi-K2-Instruct, Qwen/Qwen3-Coder-480B-A35B-Instruct
Mistral Vibe
Mistral 的编程助手 CLI
id
vibe可执行文件vibe建议模型 在 CLI 内选择
Grok Build
xAI 的编程助手 CLI
id
grok可执行文件grok建议模型 grok-4.6, grok-4.5, grok-4.7
Kiro CLI
AWS 的智能体式编程 CLI
id
kiro可执行文件kiro-cli建议模型 claude-sonnet-4.6, claude-opus-4.7, claude-opus-4.6
Factory Droid
Factory 的编程助手 CLI
id
droid可执行文件droid建议模型 在 CLI 内选择
Qoder CLI
Qoder 的智能体式编程 CLI
id
qoder可执行文件qodercli建议模型 auto, performance, lite
Warp
Warp 的终端助手
id
warp可执行文件warp建议模型 在 CLI 内选择
Junie CLI
JetBrains 的编程助手 CLI
id
junie可执行文件junie建议模型 sonnet, opus, gpt-sol
GitHub Copilot CLI
GitHub 的编程助手 CLI
id
copilot可执行文件copilot建议模型 auto, gpt-5.4, claude-opus-4.8
Cursor CLI
Cursor 的编程助手 CLI
id
cursor可执行文件cursor-agent建议模型 gpt-5, sonnet-4-thinking, claude-opus-4-8
Rovo Dev CLI
Atlassian 的编程助手 CLI
id
rovo可执行文件acli建议模型 在 CLI 内选择
| 提供方 | id | 可执行文件 | 建议模型 | MCP 宿主 |
|---|---|---|---|---|
| Claude CodeAnthropic 的终端编程助手 | cc | claude | fable, opus, sonnet, haiku | ✔ |
| Codex CLIOpenAI 的编程助手 CLI | codex | codex | gpt-5.6-sol, gpt-5.5, gpt-5.4-mini | ✔ |
| OpenCode CLI开源的终端编程助手 | opencode | opencode | opencode/claude-sonnet-4-6, opencode/claude-opus-4-8, opencode/gpt-5.2-codex, anthropic/claude-opus-4-8, anthropic/claude-haiku-4-5, openai/gpt-5.5 | ✔ |
| HermesNous Research 的助手 CLI | hermes | hermes | anthropic:claude-opus-4-8, anthropic:claude-fable-5, openai-codex:gpt-5.5, openai-codex:gpt-5.4-mini | ✔ |
| Kimi CodeMoonshot AI 的编程 CLI | kimi | kimi | kimi-code/k3, kimi-code/kimi-for-coding, kimi-code/kimi-for-coding-highspeed | ✔ |
| DeepSeek CLIDeepSeek 的编程 CLI | deepseek | deepseek | deepseek-v4-pro, deepseek-v4-flash | |
| Pi极简的终端编程框架 | pi | pi | sonnet, opus, deepseek/deepseek-chat, openai/gpt-4o | |
| Qwen CodeAlibaba 的编程助手 CLI | qwen | qwen | qwen3-coder-plus, qwen3-coder-flash, qwen3-coder-next | ✔ |
| Aider终端里的 AI 结对编程 | aider | aider | sonnet, opus, haiku, deepseek/deepseek-chat | |
| Gemini CLIGoogle 的开源终端助手 | gemini | gemini | gemini-3.1-pro-preview, gemini-3.5-flash, gemini-3.1-flash-lite | |
| Cline CLI自主运行的编程助手 CLI | cline | cline | anthropic/claude-sonnet-4-6, anthropic/claude-opus-4-8, google/gemini-3.1-pro | |
| CrushCharm 的终端编程助手 | crush | crush | 在 CLI 内选择 | |
| Goose开源的通用 AI 助手 | goose | goose | claude-sonnet-4-6, claude-opus-4-8, deepseek-v4-pro | |
| Kilo Code带 CLI 的开源编程助手 | kilo | kilo | kilo/~anthropic/claude-sonnet-latest, kilo/~anthropic/claude-opus-latest, kilo/~google/gemini-pro-latest, kilo/~openai/gpt-sol-latest | |
| Letta Code带长期记忆的编程助手 | letta | letta | zai-org/GLM-5.3-max, moonshotai/Kimi-K2-Instruct, Qwen/Qwen3-Coder-480B-A35B-Instruct | |
| Mistral VibeMistral 的编程助手 CLI | vibe | vibe | 在 CLI 内选择 | |
| Grok BuildxAI 的编程助手 CLI | grok | grok | grok-4.6, grok-4.5, grok-4.7 | |
| Kiro CLIAWS 的智能体式编程 CLI | kiro | kiro-cli | claude-sonnet-4.6, claude-opus-4.7, claude-opus-4.6 | |
| Factory DroidFactory 的编程助手 CLI | droid | droid | 在 CLI 内选择 | |
| Qoder CLIQoder 的智能体式编程 CLI | qoder | qodercli | auto, performance, lite | |
| WarpWarp 的终端助手 | warp | warp | 在 CLI 内选择 | |
| Junie CLIJetBrains 的编程助手 CLI | junie | junie | sonnet, opus, gpt-sol | |
| GitHub Copilot CLIGitHub 的编程助手 CLI | copilot | copilot | auto, gpt-5.4, claude-opus-4.8 | |
| Cursor CLICursor 的编程助手 CLI | cursor | cursor-agent | gpt-5, sonnet-4-thinking, claude-opus-4-8 | |
| Rovo Dev CLIAtlassian 的编程助手 CLI | rovo | acli | 在 CLI 内选择 |
--effort为 Claude Code 和 Codex 设置推理强度。--auth-mode api-key适用于 Claude Code。- 其他启动参数用
--extra-args传入,比如 Claude Code 的--remote-control。 - 请保留权限确认。
--skip会关闭编程工具中的权限提示。
助手工具
四个辅助 CLI,助手可以在自己的 shell 中运行。它们不接受聊天任务,因此不是可启动的提供方。reevesagents tools 会列出它们,并显示安装和登录状态。
Perplexity CLI
pplxPerplexity 的网页搜索和页面摘录,以 JSON 输出。
Google Colab CLI
colabGoogle Colab 上的 CPU、GPU 和 TPU 运行时:远程运行脚本和 notebook。
下载和上传模型与数据集,在 Hugging Face Hub 上运行任务。
Ollama
ollama在终端中运行本地或 Ollama 云端模型。
故障排查
先运行 reevesagents doctor,它通常能直接指出问题。
缺少 tmux
用 brew install tmux 或 sudo apt install tmux 安装,然后再运行一次 doctor。
某个提供方没有出现
通常是那个 CLI 没装或没登录。处理好之后,用 reevesagents providers 确认一下。
Web UI 提示缺少包
实时终端需要可选的 ws 和 @lydell/node-pty 模块。用 npm 或 pnpm 重新全局安装,就能把它们装回来。
端口 8080 被占用
Web UI 会换到下一个空闲端口,并打印出 URL。想自己指定端口,就用 reevesagents web --port 8090。
原生 Windows
完整产品请在 WSL 里运行。只需要智能体控制的话,reevesagents-win 可以作为 MCP 服务器原生运行。
可核查的数据
下载统计范围为 2025-04-14 至 2026-10-14。GitHub 和 npm 数据核查于 2026-10-15。下载量统计包的获取次数。
最后更新: