刚刚，我把自己写的 npm 包 coding-agent-runner 更新到了 v0.1.2！
它干的事情很简单——把 Codex、Claude Code、Cursor、OpenCode、Pi 这 5 个编码 Agent CLI，统一成了一套 Node.js API。
不是又一个 Agent 框架，不是 LangChain 套壳，而是一个只做「翻译官」的 SDK。
业界在发生什么？
先说背景——最近有个趋势已经非常明显了。
新冒出来的一批项目——open-design、OpenClaw、Multica——全都做了同一个选择：local first，直接调用本地的编码 Agent CLI。
没有人再从零手搓 Agent loop 了。
原因也不复杂：
- 自研 Agent，你要自己做工具调用、上下文管理、权限沙箱、错误恢复……而这些 Claude Code 和 Codex 团队已经打磨了无数轮
- 模型和 harness 是一起进化的——你拿 API 自己攒的 Agent，永远追不上官方 CLI 的迭代速度
- 本地 CLI 自带用户的登录态和订阅额度，应用层连 API key 都不用操心
业界的共识正在形成：与其自己开发 Agent，不如直接拿业界最强的 Claude Code / Codex 做二次开发。
Agent 正在变成「基础设施」——就像没人会为了做网站，先自己写一个浏览器。
而 coding-agent-runner，就是这条路上的那层「插座」。
我为什么要写它？
起因是我自己踩的坑。
我想在 Node.js 应用里调用本地的编码 Agent，结果发现——每家 CLI 都是一个「方言区」：
- Codex 要走
codex app-server --listen stdio:// - Claude Code 是自家的流式 JSON
- Cursor 是
cursor-agent acp - OpenCode 是
opencode acp - Pi 是
pi-acp
5 个 CLI，5 种启动方式，5 套输出格式。
想同时接入它们？就得写 5 遍胶水代码。
写到第 2 遍的时候我就受不了了……于是干脆把这层胶水抽成了一个 SDK。
它做了什么？
🎯 一套 API 通吃：runCliAgent() 单次运行、streamCliAgent() 流式输出、createCodingAgentRunner() 多轮会话——换 Agent 只改一个 provider 字符串。
🔄 事件全部标准化：不管底层是哪家 CLI，吐出来的都是同一套事件——text_delta、thinking_delta、tool_start、tool_update、tool_end、done、error，一共 7 种，for-await 直接遍历。
💡 本地探测 + 会话管理：detectCliAgents() 一行代码扫出你机器上装了哪些 Agent CLI，还支持中止和会话恢复。
代码长这样，三行起步：
import { runCliAgent } from "coding-agent-runner";
const result = await runCliAgent({
provider: "codex",
cwd: process.cwd(),
prompt: "Inspect this repository and summarize the test command.",
});
console.log(result.output);
想换成 Claude Code？把 "codex" 改掉就完了。
我想要的效果是：调用一个编码 Agent，就该和调用 fetch() 一样简单。
为什么押注 ACP？
我给它的定位是 ACP-friendly。
ACP（Agent Client Protocol）——就是编码 Agent 界的「USB-C 接口」，一个让客户端和 Agent 对话的标准协议。Cursor、OpenCode、Pi 的 CLI 都已经原生支持 acp 模式。
所以我没有发明一套私有协议，而是顺着 ACP 生态做适配——协议统一到哪，我就接到哪。
自己造协议这件事……还是留给大厂吧。
怎么用？
MIT 协议，完全开源，v0.1.2 发布于 7 月 8 日。
- 环境要求：Node.js 20+、ESM 项目
- 安装：
npm install coding-agent-runner - 前提：本机至少装了一个支持的 Agent CLI
🔗 仓库地址：github.com/yinguangyao…
或许，「自研 Agent」这个词，很快就会像「自建机房」一样古老。
这个包现在还很早期，如果你有想接入的 Agent CLI，或者踩到了什么坑——欢迎直接提 Issue 和 PR，也欢迎点个 Star。
