跳到主要内容
免费开源

文档

AI 助手可以执行编程任务。本指南介绍命令行工具(CLI)、终端菜单(TUI)、保持任务运行的终端工具 tmux,以及 AI 工具之间的标准连接(MCP)。

安装

需要 macOS、Linux 或 WSL,Node 22.12 或更新版本,tmux 3.0 或更新版本,以及至少一个装好并登录过的提供方 CLI。

$ pnpm add -g reevesagents$ reevesagents doctor$ reevesagents
reevesagents doctor 会把这些逐项检查一遍。reevesagents setup 以首次运行向导的形式做同样的检查,加上 --attach 还会把 MCP 连接到每个已安装的宿主。

快速上手

启动一支团队,查看进展,随时插手,最后把它停掉。

启动团队

shell
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 可以往最近的运行里添加助手。

观察与操控

shell
reevesagents runs
reevesagents peek api -n 40
reevesagents send api "run the tests"
reevesagents key api enter
reevesagents open api

send 只粘贴文本、不提交,所以后面要跟一条 key <agent> enter。open 带你跳到 tmux 里的那个助手。

停止

shell
reevesagents stop "feature x" --yes
stop、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)把一个编程工具连接到其他工具。此功能可按需开启。连接后请重启工具。

shell
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]] 格式,第一个智能体担任负责人。选项:--name、--cwd、--prompt、--skip、--run、--auth-mode、--effort、--extra-args、--json。

add [spec...]

向最近的活跃运行添加智能体。选项:--run、--prompt、--skip、--auth-mode、--effort、--extra-args、--json。必须指定至少一个智能体。

runs

列出活跃运行。--json。

open <id>

在 tmux 中打开运行或智能体窗口。接受 ID、名称、昵称或唯一前缀。

peek <agent-id>

显示一个智能体的最近输出。-n/--lines(默认 20 行)、--json。

stop <run-id>需要 --yes

停止一次运行并关闭其 tmux 会话。-y/--yes。

kill <agent-id>需要 --yes

停止一个智能体。最后一个活跃智能体停止后,运行也随之结束。-y/--yes。

驱动助手

send <agent-id> <text...>

将文本粘贴到智能体输入区,但不提交。

key <agent-id> <key>

发送一个允许的按键:enter、escape、backspace、tab、space、up、down、left、right、ctrl-c。

interrupt <agent-id>

发送 ctrl-c。

记录与历史

agents [run-id]

列出所有活跃运行或指定运行中的智能体。--json。

providers

列出提供方、可用状态和已知模型。--models、--json。

tools

列出智能体工具的安装和登录状态。--json。

delete <agent-id>需要 --yes

删除已结束智能体的记录。-y/--yes。

delete-run <run-id>需要 --yes

删除已结束的运行。-y/--yes。

history

列出已归档的运行。--json。

delete-history <id>需要 --yes

删除一条历史记录。-y/--yes。

审批

approvals

列出待处理的审批请求。--json。

approve <approval-id> [note]

批准待处理的审批请求。

deny <approval-id> [note]

拒绝待处理的审批请求。

MCP 宿主

hosts

列出支持 MCP 的宿主 CLI 及其连接状态。--json。

attach [cli]

通过宿主的 CLI 命令或配置文件,将 MCP 连接到一个宿主 CLI 或所有已安装的宿主。--force 重写已有注册。

detach <cli>

通过宿主的 CLI 命令或配置文件,从一个宿主 CLI 移除 MCP。

mcp

通过 stdio 启动智能体控制 MCP 服务器。此命令由宿主 CLI 执行。

配置与预设

config [key] [value]

显示、读取或修改一个可编辑的配置字段。--json。

presets

列出已保存的预设。--json。

save-preset <run-id> <name> [description...]

将活跃运行保存为预设。

start-preset <name>

从预设启动运行。--name、--cwd。

delete-preset <name>需要 --yes

删除一个预设。-y/--yes。

初始化与工具

setup

首次设置时检查 tmux、Node 和已安装的 CLI。--attach 连接所有已安装的宿主。--json 显示设置状态。

doctor

检查运行环境。失败时返回非零退出码。--json。

skills [action]

为兼容的 CLI 安装、移除或检查 ReevesAgents 技能:install、remove、status(默认)。--json。

reap

停止窗口已消失或超过 max_lifetime_ms 的智能体,并关闭孤立的 tmux 会话。--json。

web

在前台启动仅监听本地回环地址的 Web 界面。--port、--no-open。

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 或 ctrl-c。

interrupt必填agent_id

向智能体发送 ctrl-c。

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

界面语言,使用十个受支持的语言代码之一。

磁盘上的状态

~/.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)。

REEVES_CONFIG

覆盖配置文件路径。

REEVES_NO_TMUX_WRAPPER=1

设为 1 时,不自动在 tmux 会话中启动 TUI。

REEVES_NO_COLOR=1

设为 1 时,关闭 TUI 颜色。

ALLOW_DESTRUCTIVE=1

设为 1 时,允许不带 --yes 执行破坏性命令。

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 内选择

  • --effort 为 Claude Code 和 Codex 设置推理强度。--auth-mode api-key 适用于 Claude Code。
  • 其他启动参数用 --extra-args 传入,比如 Claude Code 的 --remote-control。
  • 请保留权限确认。--skip 会关闭编程工具中的权限提示。

助手工具

四个辅助 CLI,助手可以在自己的 shell 中运行。它们不接受聊天任务,因此不是可启动的提供方。reevesagents tools 会列出它们,并显示安装和登录状态。

  • Perplexity CLIpplx

    Perplexity 的网页搜索和页面摘录,以 JSON 输出。

  • Google Colab CLIcolab

    Google Colab 上的 CPU、GPU 和 TPU 运行时:远程运行脚本和 notebook。

  • Hugging Face CLIhf

    下载和上传模型与数据集,在 Hugging Face Hub 上运行任务。

  • Ollamaollama

    在终端中运行本地或 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。下载量统计包的获取次数。

最后更新: