一个带驾驶舱而非聊天记录的终端编码智能体。

1. ~/.rovecode/providers.json

   1{
   2  "default": "kaesra/zai-org/glm-5.3-flash",
   3  "providers": {
   4    "kaesra": {
   5      "baseUrl": "https://api.kaesra.tech/v1",
   6      "protocol": "openai",
   7      "keyEnv": "KAESRA_API_KEY"
   8    },

   01问题

   每个智能体都被焊死在一家厂商的 API 和一张价目表上。

   rovecode 的做法

   一处 StreamFn 接缝加一份活的提供方注册表。16 个具名提供方，或 providers.json 里任意 OpenAI、Anthropic 兼容端点；在另一个终端里新增的提供方，下一次调用就会用上。按角色的回退链会在 429 或 5xx 时向后推进。

   rovecode provider add homelab http://10.0.0.7:8000/v1 --no-key
2. 

   02问题

   智能体正在改的那个文件，被聊天记录顶出了屏幕。

   rovecode 的做法

   分面板的驾驶舱：文件、代码、消息、计划、用量和云朵吉祥物。消息面板把每次工具调用压成一行；代码面板只展示真正落地的那一块。

   files · code · messages · plan · usage · rovecode
3. 

   03问题

   模型要求 rm -rf，而没人来得及说不，框架就执行了。

   rovecode 的做法

   先是默认拒绝的通配规则，再是 execpolicy 判定——被禁止的既到不了执行也到不了人，然后是针对修正后参数的批准卡片。四层叠加，且没有一层假装自己是沙箱。

   rules → execpolicy → approval → runtime denylist + cwd lock
4. 

   04问题

   第 40 轮出了问题，唯一的退路却是重开一段对话。

   rovecode 的做法

   带 sha256 哈希链的仅追加 JSONL 会话树。/rewind 打开轮次选择器，可从任意一轮分叉，并把那一轮的完整文本填回编辑器；shadow-git 检查点以 3 种模式恢复，且从不碰你的 .git。

   /rewind /checkpoints /restore rovecode trace <session-id>

界面

sextant 驾驶舱

在至少 100×30 的真彩 TTY 上排布 6 个面板：带 git 状态的文件、带高亮条和 ± 差异的代码、紧凑的工具行、计划、用量、吉祥物。3 套配色，/theme 可热切换；--classic 保留 pi-tui 的聊天界面。

rovecode · ROVECODE_TUI=sextant|classic · /theme night|ember|contrast

提供方

热重载的提供方

16 个内置，加上你在 providers.json 里登记的一切。每次调用都按活的快照解析提供方：在另一个终端里添加一个，正在运行的驾驶舱下一次调用就会用它。无需重启。

rovecode provider add|list|test · rovecode model use provider/model

~/.rovecode/providers.json

1{
2  "default": "kaesra/zai-org/glm-5.3-flash",
3  "providers": {
4    "kaesra": {
5      "baseUrl": "https://api.kaesra.tech/v1",
6      "protocol": "openai",
7      "keyEnv": "KAESRA_API_KEY"
8    },
9    "homelab": {
10      "baseUrl": "http://10.0.0.7:8000/v1",
11      "protocol": "openai",
12      "noKey": true,
13      "models": ["qwen3-coder-30b"]
14    }
15  }
16}

• 上下文

  MCP 客户端

  来自 .rovecode/mcp.json 的 stdio 与 HTTP 服务器。通过 2 个注册表工具惰性披露，空闲的服务器几乎不耗 token。

  mcp_list · mcp_call

• 安全

  安全阶梯

  每次工具调用运行前都要爬四级。被禁止的 argv 在任何钩子看到之前就被拒绝；--yolo 跳过询问，但绝不跳过拒绝规则。

  rules → execpolicy → approval → runtime

• 记忆

  会话树 + 检查点

  带 sha256 哈希链的仅追加 JSONL。/rewind 分叉、/resume 续接，shadow-git 检查点以 3 种模式恢复，且从不碰你的 .git。

  /rewind · /checkpoints · /restore

• 面向 Zed 与 JetBrains 的 ACP

  基于 stdio 的 Agent Client Protocol v1，官方 SDK。

  rovecode acp

• 无界面 HTTP + SSE

  会话、一条 RunEvent 流、/doc 上的 OpenAPI。端口 4100，仅回环。

  rovecode serve

• 后台子智能体

  有上限的 FIFO 子会话，默认并发 3 个；笔记会在父会话的下一轮送达。

  /tasks

• 钩子

  .rovecode/hooks.ts 中 9 个带类型的钩子，各自限时 5 秒。pre_tool 只能拒绝。

  pre_tool · approval · on_event

• OpenTelemetry

  每次运行一条链路：run ⊃ turn ⊃ tool，带 token、延迟与成本。未设置端点则没有导出器。

  ROVECODE_OTEL_ENDPOINT

部署与数据

• 01

  按定义即自托管

  从源码在你的机器或你的 CI 上运行。账户是可选的：它只解锁定价页面上的套餐，绝不会限制 CLI。唯一的要求是 Bun ≥ 1.3.14。

• 02

  不回传

  出站流量只去往你配置的提供商、你列出的 MCP 服务器，以及模型请求时的 web_fetch。价格目录是离线快照；没有自动更新。

• 03

  遥测需自行开启

  在设置 ROVECODE_OTEL_ENDPOINT 之前，OpenTelemetry 导出是关闭的；即便开启，它携带的也只是 id、大小与结果——绝不包含提示词、参数或输出。

• 04

  审计轨迹来自结构

  会话是只追加的 JSONL，带 sha256 哈希链；每次运行导出一条 trace（run ⊃ turn ⊃ tool），被取消的也不例外。

• 05

  平台状况

  Windows 优先：开发与发布闸门都跑在 Windows 11 上。POSIX 路径已测试，Linux 与 macOS 尚未经 CI 验证。

• 06

  许可证

  AGPL-3.0-only。可自由修改与再分发；将修改后的构建作为网络服务运行，则须向这些用户提供其源码。

1. 01

   克隆并链接（Bun ≥ 1.3.14）

   CLI 入口是由 bun 执行的 TypeScript，node 跑不了。bun link 会把 rovecode 放进 PATH。

   $ git clone https://github.com/9Code-Labs/rovecode && cd rovecode && bun install && bun link复制
2. 02

   接上一个模型

   rovecode setup 会带着你走：挑一个提供方，隐藏着粘贴密钥，做一次很小的测试调用，完成。也可以用 rovecode auth set 直接存密钥，或把 ROVECODE_BASE_URL 指向任意 OpenAI 兼容端点。

   $ rovecode setup复制

   或

   $ rovecode auth set anthropic复制
3. 03

   跑一个任务或打开驾驶舱

   直接输入 rovecode 会打开 sextant 界面。带引号的提示是一次性运行；--output json 恰好返回一个结果对象。

   $ rovecode "fix the failing test"复制

   $ run · exit 0

   

• 评审搬进了终端，审批卡片成了对话本身。交付量不变，来回沟通少了三分之二。

  AD

  Aylin Demirci

  Head of Platform · Northwind Robotics

• 默认拒绝的策略是安全团队签字放行的原因。每一次工具调用都是我们本来就会读的日志里的一行。

  MO

  Marcus Oyelaran

  Staff Engineer · Harbourline Payments

• 十二个人，本地模型，中间没有供应商。它运行在客户代码被允许运行的地方。

  IF

  Inés Ferrer

  创始人 · Meridian Studio

为页面撰写的虚构团队示例引言——上线前会换成真实的。

• Free

  在你自己的仓库上试用代理。

  $0/ 月

• Pro

  为每天用它交付的一位工程师。

  $20/ 月

• Max

  为整周都泡在其中的工程师。

  $200/ 月

• Teams

  为共享额度、知识和策略的团队。

  $80/ 月

  最低 $80 · 每个完整席位 $40 / 月