不是聊完，是做完。

把目标交给 OwlCoda。把满意的成果拿回来。

OwlCoda 进入真实工作环境，追根究底，始终接住下一步，实际验收结果，并持续推进到成果被接受。交付控制是主产品，CLI 只是其中一个执行入口。

从交付控制开始查看交付引擎 →
  • 项目真值
  • 证据关联
  • 人工验收
  • 持续交付
owlcoda · 项目交付workcase / 设备交付
$ npx owlrunkit project status --workspace .
# 项目不会随当前 Agent 或会话一起消失
目标完成设备资料交付已接受
缺口解决 BOM 数量漂移已指派 Owner
证据14 个来源已绑定已验证
结果候选等待复核需要人工验收
下一步 → 复核数量裁决，然后继续交付。
owlcoda · 交付控制

项目真值 · 交付生命周期

  • 目标合同一个结果 · 一个 Owner就绪
  • 交付状态证据已关联就绪
  • 业务动作继续单独授权待授权

五秒读懂

从目标到可验收结果。

  • 从什么开始从项目目标开始，不从一次临时 prompt 开始。
  • 如何不断档指派、交接、返工、恢复和唯一下一步都留在项目里。
  • 如何验收候选身份、验证证据、交付状态和人工接受相互绑定。
  • 如何执行OwlCoda CLI 或其他受控执行器负责动手，但不接管项目真值。

主产品面

先接住项目，再调用 Agent。

OwlCoda 的交付控制由公开的 OwlRunKit 引擎驱动。目标、Owner、候选、证据、交接、恢复和交付状态不会因为换 Agent 或换窗口而丢失。

把交付控制加入项目

npm install --save-exact [email protected]
  • Node ≥ 20.19
  • 项目持有状态
  • GPL 源码
  • 不隐式调度
逐步说明
  1. 01

    锁定项目依赖

    npm install --save-exact [email protected]
  2. 02

    先预览安全接入

    npx --no-install owlrunkit bootstrap --workspace . --exact [email protected] --dry-run
  3. 03

    项目空闲时正式接入

    npx --no-install owlrunkit bootstrap --workspace . --exact [email protected] --apply
  4. 04

    读取项目真实状态

    npx --no-install owlrunkit project status --workspace .

OwlCoda CLI · 执行入口

项目需要动手时，CLI 才上场。

CLI 把模型和工具接入真实执行。它仍是完整的专家入口，但不再承担整个产品叙事：交付控制始终位于一次会话之上。

  • 42+ 工具 Bash、Read、Write、Edit、Glob、Grep、Task、MCP 工具、agent dispatch、调度、插件。
  • 69+ slash 命令 model、cost、budget、context、sessions、skills、training，全在同一个 prompt 下查。
  • Selection-first transcript 鼠标拖选、复制和其他终端 app 完全一致。
  • 会话持久化 每次对话自动落到 ~/.owlcoda/sessions/，--resume <id> 恢复任意一次。
  • 持续运行 context 预算闸 长会话会按 context 预算闸校验，最终报告不会被悄悄截断。

Slash 命令 · 摘自 69+

  • /model查看已配置模型、切换当前路由。
  • /budget查 context 预算与单次上限。
  • /context打印当前 context window 状态。
  • /sessions浏览并恢复历史会话。
  • /resume按 id 恢复一次历史 session。
  • /training为 session 评分并导出微调数据。
  • /trace打开上一次运行的 trace 检查器。
  • /perf查每个工具的延迟和 token 消耗。
  • /doctor探测路由、key 和 runtime 健康。
  • /tools列出当前可用工具，scope 或 global。
  • /skills管理已学技能和触发条件。
  • /tokens逐条消息的 token 计数。
  • /cost本次 session 各 provider 的花费。
  • /config查看或编辑 ~/.owlcoda/config.json。
  • /agents列出可用 subagent 并 dispatch。
  • /plan进入 plan 模式做多步规划。
  • /clear清空可见 transcript（不丢 session）。
  • /undo回滚上一次工具应用的改动。
  • /open从 REPL 打开 admin UI 的某个页面。
owlcoda · session 7e3a~/work/owlcoda
$ /model
default → qwen3-coder (ollama · local)
heavy → kimi-for-coding (kimi · provider-native)
long-context → minimax-m27 (minimax · messages)
cheap → openrouter/auto (openrouter)
$ /model heavy
✓ 活动路由 → kimi-for-coding · ctx 128k · key 来自环境变量。
$ 修一下 completion-guard 的误判
Readsrc/native/conversation.ts412 行 · 13.2 KB
Grep"completion-guard" → 6 处命中3 个文件
Globsrc/native/**/*.ts47 路径
Editsrc/native/completion-guard.ts3 块 hunk
Bashnpm test --silent14 通过 · 2.1 s
Taskspawn review-agent运行中
✓ patch 应用 · vitest 14/14 · session 已落盘。

自带后端

OwlCoda 不带模型 —— 你把它指过去就行。

本地 runtime、云端 API key 或者两者都行。Endpoint 和 provider probe 用一套心智处理。

后端类型端点协议形态状态
OllamaLocalhttp://127.0.0.1:11434/v1OpenAI 兼容 · 日常本地路由自动探测
LM StudioLocalhttp://127.0.0.1:1234/v1OpenAI 兼容 · GUI runtime自动探测
vLLMLocalhttp://127.0.0.1:8000/v1OpenAI 兼容 · GPU runtime自动探测
自建本地Local用户自填OpenAI 兼容 · 任意 /v1 端点自动探测
Kimi CodingCloudhttps://api.kimi.com/coding/v1provider 原生 · kimi-for-coding已实测
Kimi (Moonshot)Cloudhttps://api.moonshot.ai/v1OpenAI 兼容 · 通用 Moonshot自带 key
MiniMaxCloudhttps://api.minimaxi.com/anthropicMessages 形态 · Anthropic 风格已实测
OpenRouterCloudhttps://openrouter.ai/api/v1OpenAI 兼容 · 多上游目录自带 key
阿里百炼 / DashScopeCloudhttps://dashscope.aliyuncs.com/compatible-mode/v1OpenAI 兼容 · 阿里托管模型自带 key
OpenAI 兼容Cloudhttps://api.openai.com/v1OpenAI 兼容 · 任意 /v1 vendor自带 key

CLI 配置

执行器可以更换，项目真值不能漂。

OwlCoda CLI 可以路由本地或云端模型并调用真实工具。换模型、换会话或换 Agent，都不会改写项目目标、已接受证据和交付状态。

  1. 01
    打印 URL

    owlcoda ui 打印一个绑了一次性 token 的 localhost URL，自己复制或喂给启动器。

  2. 02
    直接打开

    owlcoda ui --open-browser 把 URL 直接交给你的默认浏览器。

  3. 03
    配置 provider

    加 provider、贴 API key、跑一次连接测试。配完页面会自己关掉。

$ owlcoda ui
$ owlcoda ui --open-browser
$ owlcoda admin

进阶 catalog / aliases / orphans 清理收在 Diagnostics 里，首次运行路径不被它们打扰。

owlcoda admin · providers · kimi-coding
01填写
02测试
03保存

PROVIDER · KIMI CODING

ProviderKimi Coding
端点https://api.kimi.com/coding/v1
后端模型kimi-for-coding
API keysk-•••••••••••••••
协议形态provider 原生
测试连接200 OK · 412 ms

不写死端口，URL 每次启动都换，从来不离开你这台机器。

Coda

Coda 不是结尾，是把整段工作收拢、并把下一次起点留下来的那一段。

当前 Agent 停下，项目仍然继续。

OwlCoda 把项目真值留在持久化工件里。新 Agent 直接读取目标、当前缺口、候选、证据、决策和下一步，不再反向猜旧聊天。

$ npx owlrunkit project status --workspace . # 恢复唯一下一步。

.owlcoda/runkit/ · 项目真值当前 · 可检查
  • .owlcoda/runkit/project/definition.json目标 · WorkItems · 验收条件
  • .owlcoda/runkit/project/events/指派 · 决策 · 交接
  • .owlcoda/runkit/runtime-executions/执行证据 · receipts
  • .owlcoda/runkit/project/status当前缺口 · Owner · 下一步
  • SourceCandidate / DeliveryPacket精确候选身份
  • DeliveryLifecycle集成 · 部署 · 线上读回 · 验收

控制态势

执行器可以变，权限不会跟着它偷偷扩张。

  • 项目真值目标、候选、证据和下一步属于项目，不属于某一段执行器聊天。
  • 显式权限Git、发布、部署、生产、资金和业务动作继续分别授权。
  • 全程可查失败、交接、返工、恢复和交付阶段不会被改写成一句“完成”。
  • 数据控制执行数据留在你选择的环境和 Provider 中；可选采集继续保持 opt-in。

一个对外品牌

一个 OwlCoda，两种产品面。

用户面对的品牌只有 OwlCoda。交付控制是主产品面，CLI 是辅助执行面；底层公开仓库仍可分别检查。

  • OwlCoda · 交付控制 ↗主产品 · OwlRunKit 0.23 驱动

    负责项目连续性、候选身份、验证、交接、返工、恢复和交付生命周期真值。

  • OwlCoda · CLI ↗辅助执行 · 0.18

    把模型和工具接入执行，保留会话与证据，再把结果交回交付控制。