文档 · 6.4.0
rea-agents 6.4.0 的客户端矩阵
[email protected] 的 setup 可以把 REA 的本地 stdio MCP 服务器登记到 17 个客户端 ID。
表与标签 rea-agents-6.4.0 上的 docs/installation.md 一致。
skill 目录的坑仍在 MCP 客户端与 skill 路径。
钉版本与引擎
该包的 Node：^22.19.0 || ^24.11.0 || >=26.0.0。注册表标识：io.github.morluto/rea。注册表条目用 npx 和 mcp 命令启动同一个 npm 包。它不是第二份发行物。
npx -y [email protected] setup
npx -y [email protected] doctor --client codex --json
npx -y [email protected] doctor --skill --json rea setup 以多选列出这些智能体。已有的 REA 登记默认选中。新检测到的客户端可选但不预选：检测只提供上下文，不是写入新登记的许可。
显式 --client 会跳过这个问题。先批准 dry-run，再 --yes。之后重启客户端。持久登记会钉在执行 setup 的那个包版本上。
npx skills add morluto/rea --skill reverse-engineer-anything 只安装说明。它不登记 MCP，也不安装 Ghidra、JEB、IDA 或 Hopper。
受支持的 --client 值
Pi、Hermes 和 Qwen Code 在这个 npm 发行里。6.4.0 发行说明（2026-10-11）把它们的 setup 列为新增
（#1376、
#1403、
#1415）。
同一标签的安装文档里有一段写于 npm latest 仍是 6.3.0 的文字，说这三个 ID 不在那个 tarball 里。不要把 6.3.0 的句子用到 @6.4.0 钉版本上。
main 上更晚的说明（不是更新的 npm 版本）写到，已发布的 6.4.0 包接受了这 17 个 ID 的 dry-run 计划，包括 Qwen Code、Pi 和 Hermes。在你的机器上用 doctor 确认。
| 客户端 | --client | 6.4.0 接线 |
|---|---|---|
| Claude Code | claude_code | setup 写入 MCP 与捆绑 skill。确认 skill 落在该客户端实际加载的目录。 |
| Claude Desktop | claude_desktop | 按 setup 计划写入后重启桌面应用。 |
| Codex | codex | 未设置或空的 CODEX_HOME 即 ~/.codex。 |
| Cursor | cursor | IDE 的 MCP 条目。setup 后重连，让工具列表刷新。 |
| Gemini CLI | gemini_cli | 非空 GEMINI_CLI_HOME 会生效。不受信任的工作区设置不会替换用户条目。 |
| Windsurf | windsurf | IDE 的 MCP 条目。setup 后重连。 |
| Devin | devin | 非 Windows 上，配置跟随 XDG_CONFIG_HOME 下的 devin/mcp_config.json。 |
| OpenCode | opencode | 6.4.0 的 setup 会遵守 OPENCODE_CONFIG_DIR。npm 6.3.0 不会。 |
| Antigravity | antigravity | 在 setup 里勾选，或传入 --client antigravity。 |
| GitHub Copilot CLI | copilot_cli | 完整 schema 可能挡住 gpt-4.1 元数据（#1554）。文档中的变通是 compact profile。 |
| Command Code | commandcode | 4.1.0 起可由 setup 登记。在 6.4.0 上仍用 doctor 确认。 |
| Qwen Code | qwen_code | 6.4.0 新增。用户设置：~/.qwen/settings.json，或 $QWEN_HOME/settings.json。 |
| VS Code | vscode | 在 setup 里勾选，或传入 --client vscode，然后重载窗口。 |
| Grok Build | grok_build | [mcp_servers.rea] 位于 $GROK_HOME/config.toml，或 ~/.grok/config.toml。 |
| OMP | omp | 用户 mcp.json 在 ~/.omp/agent，或由 OMP_PROFILE／PI_PROFILE 选定的配置档。 |
| Pi | pi | 6.4.0 新增。严格 JSON：~/.pi/agent/mcp.json，或 PI_CODING_AGENT_DIR。 |
| Hermes | hermes | 6.4.0 新增。HERMES_HOME 下 config.yaml 的 mcp_servers.rea；会跟随活动配置档。 |
核对一个客户端
换成表中的 ID。写入之前先检查。下面的命令用 Pi；Hermes 是 hermes，Qwen Code 是 qwen_code，Copilot CLI 是 copilot_cli。
npx -y [email protected] setup --client pi --dry-run --json
npx -y [email protected] setup --client pi --yes --json
npx -y [email protected] doctor --client pi --json- Pi 把
mcp.json当成严格 JSON。注释、尾随逗号、字节顺序标记或空文件都无效。setup 会报告它们，而不是改写文件。先修成普通 JSON 再重跑。设置了PI_CODING_AGENT_DIR时跟随它。会话外改完配置后，重载已有的 Pi 会话。项目里的.pi/mcp.json可以盖住用户条目。 - Qwen Code：
~/.qwen/settings.json里的mcpServers.rea，或$QWEN_HOME/settings.json。个人 skill 在~/.agents/skills下被发现。 - Hermes：
config.yaml里的mcp_servers.rea，从HERMES_HOME或平台默认目录解析（Windows 为%LOCALAPPDATA%\hermes，其它为~/.hermes），包括HERMES_DATA_DIR_SUFFIX。setup 跟随active_profile。无效的粘滞配置档会被报告，不会悄悄写进默认主目录。 - OMP：每个配置档一份登记。对每个应加载 REA 的
OMP_PROFILE或PI_PROFILE跑一次 setup。disabledServers会藏起rea；setup 会从它编辑的文件里去掉这个名字。 - OpenCode 在 6.4.0 会遵守
OPENCODE_CONFIG_DIR。npm 6.3.0 不会。
Copilot CLI 与 schema 体积
对 GitHub Copilot CLI 1.0.95，gpt-4.1 的模型元数据可能在发出模型请求之前，就用 REA 的完整输入 schema 挡住普通聊天（compaction_static_context_blocked，#1554）。
在上游的 Linux 回环夹具里，compact profile 以完整工具清单通过了本地聊天和分析。setup 之后，把下面这项加进 Copilot mcp-config.json 里 mcpServers.rea 的 env，保留其它设置，然后重启：
"REA_MCP_INPUT_SCHEMA_PROFILE": "compact"compact 广告可以减少嵌套的 schema 约束。REA 仍按规范输入做校验。同一个环境变量也是 6.4.0 里给其它有体积上限的宿主（Kimi／Moonshot）的开关。它不是改发另一个工具的许可。
Grok Bot 不在这 17 个文件里
6.4.0 安装文档把 Grok Bot（grok_bot）写成手动的托管连接器。setup 不调用账户连接器 API，也不把 ~/.grokbot 当成已对齐。
请在 Grok Bot 对话里添加一个名为 rea、跑在 Bot 电脑上的自定义 MCP 服务器：npx -y [email protected] mcp。
不要把凭据放进该命令。rea doctor --client grok_bot 会报告这个手动步骤。rea uninstall 不会移除账户连接器。
Grok Build（grok_build）不同：它是表中的一行，使用本地 config.toml。
待 6.4.0 之后的下一次 npm 发行
Factory Droid（droid）和 DeepSeek Harness（dsh）只在 main 上，直到 6.4.0 之后的发行。
不要把它们写成 [email protected] 的客户端。对该钉版本执行 setup --client dsh 会报告不支持的客户端。
Qoder、Trae、ZCode 出现在更晚的 main 文档里，方式相同：不在 6.4.0 的表中，所以也不在这个矩阵里。