ClaudeMap

Agent Cockpit

给做研究的 AI agent 用的本地白板加 MCP 服务器:计划、任务、每次实验与每条论断画上同一块板,证据链任何一环变动,依赖它的论断立刻变红——纯规则检查,零 LLM 调用(AGPL-3.0)

插件与代理researchevidence chainmcpwhiteboardcode review

Agent Cockpit 是面向「用 AI agent 做研究」场景的本地证据链工作台(npm 包 @tingyen/agent-cockpit,需 Node 22.13+ 的内建 node:sqlite;撰稿时 465 星,2026-11-09)。任何说 MCP 的 agent(Claude Code、Codex、Cursor、Gemini CLI)把工作画上同一块白板:研究计划与阶段、任务卡、每次实验运行(记录脚本哈希、脚本依赖的每个文件、以及逐函数可达性哈希)与每条论断(必须引用某次运行真实写出的文件与字段)。确定性引擎持续核对整条证据链:任一环哈希变化,运行作废、其上论断标记待复查;回滚文件后哈希重新吻合,论断自动恢复——作废判定看内容哈希而非时间戳,Python 依赖还能精确到函数级(运行不可达的函数改动不算 stale)。未报告的改动无论 agent 承不承认都会被检测:阻塞 git commit,并要求 Claude Code 报告完毕才能结束回合;所有写入(MCP、CLI、白板)过同一道校验门,不合规写入连同理由一起记日志。要人拍板的事经 cockpit_decide 提问并等待,链路断裂时白板主动发起决策并生成一页证据简报。事件全部追加进 .cockpit/events.jsonl 这一单一事实源(作者建议提交进仓库),白板只是投影,可回放任意时刻。Claude Code 有官方插件(内含一个教 agent 如何在 Cockpit 下工作的 skill),MCP 服务器已列入 MCP Registry(io.github.chutingyean/agent-cockpit)。白板绑定 127.0.0.1,所有检查为纯规则、零 token。

它做什么

  • 证据链精确到 JSON 字段:论断必须引用某次运行真实写出的值,运行记录脚本哈希、文件依赖与逐函数可达性哈希
  • 未报告的改动无论 agent 承不承认都会被检测——阻塞 git commit,Claude Code 不报告完就不能结束回合
  • MCP、CLI 与白板共用一道写入校验门:不合规写入连同 agent 可执行的整改理由一起拒绝并记日志
  • 人始终在环里:agent 经 cockpit_decide 提问并等待;链路断裂时白板主动发起决策并生成一页证据简报
  • 追加式事件库(.cockpit/events.jsonl)是单一事实源——白板只是投影,可拖动回放至任意时刻
  • 内建 graphify 风格代码图与规则式审查器;装了真正的 graphify 或 alibaba/open-code-review 会自动改用它们

什么时候用

适合 agent 跑长周期研究型编码的场景:实验、评分器、数据管线互相咬合,一个 agent 悄悄改了公共代码,别的「已验证」结果就静默失效——这正是 Cockpit 用机器规则盯死的那类失败;也适合想让 agent 在关键决策点停下来等人拍板的团队。

如何上手

# 在你自己的研究仓库上直接用,无需 clone(需 Node 22.13+ 与 git;演示需 python3):
npx -y @tingyen/agent-cockpit init      # 写入 MCP 配置、AGENTS.md、Stop hook 与 pre-commit
npx -y @tingyen/agent-cockpit serve     # 白板开在 http://127.0.0.1:4180
npx -y @tingyen/agent-cockpit run -- python3 train.py   # 实验经 cockpit 跑并记录

# 要常驻命令:
npm install -g @tingyen/agent-cockpit

# Claude Code 插件(内含教 agent 在 Cockpit 下工作的 skill):
claude plugin marketplace add chutingyean/Agent-Cockpit
claude plugin install agent-cockpit@agent-cockpit

# 建议先跑演示:
git clone https://github.com/chutingyean/Agent-Cockpit.git && cd Agent-Cockpit
npm install && npm run demo
node bin/cockpit.mjs serve --repo demo/research

注意事项

先说许可:AGPL-3.0-or-later——改完拿去网络上服务他人,就必须提供你版本的源码。设计上纯本地:白板绑定 127.0.0.1,检查是纯规则而非 LLM 评审。函数级 stale 精度只覆盖 Python 依赖,其他语言退回文件级哈希。内建代码图与审查器是有意轻量的替身——装了真正的 graphify 与 open-code-review 后会自动改用。把 .cockpit/events.jsonl 提交进仓库是设计的一部分(它同时充当 agent 的工作日志)。内建 node:sqlite 要求 Node 22.13+。撰稿时 465 星(2026-11-09)。

代码仓库

chutingyean/Agent-Cockpit

收录日期

地图上的相关资源

  • clawd-conduit

    插件 / 代理

    把全部 15 个 Claude Code hook 事件接进 Clawd on Desk 桌面宠物,权限请求变成可等待的桌面卡片。

    • hooks
    • desktop
    • notifications
    • claude-code
  • CometixCode

    插件 / 代理

    非官方的 Claude Code 终端 UI 复刻:用 Rust 按 1:1 逐文件移植到 iocraft 这套 React 风格 TUI 框架上。

    • terminal-ui
    • rust
    • reimplementation
    • unofficial
  • Abide

    插件 / 代理

    把 AGENTS.md、CLAUDE.md 里的自然语言规则变成钩子级强制:每次编辑都被评审,违规当场修复。

    • hooks
    • code-review
    • rules
    • agents-md