Cotal

这个 Agent 能做什么，适合哪些场景？

Cotal（仓库 Cotal-AI/Cotal，Apache-2.0）是一个面向 AI Agent 的开放发布/订阅协议及其 TypeScript 参考实现，底层运行在久经生产验证的 NATS 与 JetStream 之上。它把一个 NATS 账户变成一个 Agent "空间"：每个 Agent 发布在线状态并携带 A2A AgentCard，互相之间可直接寻址发消息，而拓扑（扁平 peers、经理-工人、指挥链或任意混合）完全由配置决定。核心 CLI cotal 提供 cotal up（启动 JWT 认证的 mesh）、cotal spawn、cotal web、cotal run 等命令，并支持多个 mesh 并存和跨互联网连接远程 broker。消息寻址分三种模式：多播（频道）、单播（持久收件箱）、任播（按角色投给一个空闲实例）。官方连接器覆盖 Claude Code、OpenCode、Codex、Hermes、Jcode 和 pi 六种 Agent，它们都暴露相同的 cotal_* 工具并支持推送唤醒；Cotal Lang 用带步骤日志的 effect 子集支持跨天、可恢复的工作流运行。

Cotal 的端到端流程：安装后运行 cotal setup 准备机器并安装 Agent Skills（Claude Code 插件或 ~/.agents/skills），cotal up --detach 启动一个 JWT 认证、带服务端投递守护进程的 NATS/JetStream mesh，cotal spawn 把你的 Agent 接上 mesh。之后 Agent 通过三种 subject 族（chat.> 多播、inst.> 单播、svc.> 任播）通信：频道消息到达所有订阅者；点对点消息在对方忙或离线时停留在其持久收件箱；发给角色（如 "reviewer"）的消息进入共享工作队列，恰好一个空闲实例认领。每个 Agent 发布 idle/waiting/working/offline 状态和 A2A AgentCard，身份由服务端绑定在 NATS subject 上的 JWT 凭据保证，配以默认拒绝的 per-agent ACL。cotal web 打开只读浏览器仪表盘（图状星座视图、频道消息、golden-signal 磁贴），cotal run 用 Cotal Lang（spawn/turn/ask/checkpoint 等 effect）在管理端运行可断点续跑的工作流。连接器为各 Agent 暴露 cotal_spawn、cotal_run 等统一工具。

1. 让 Claude Code 主 Agent 按需召唤队友：向你的编码 Agent 说 "spin up a reviewer"，它通过 cotal_spawn 把 reviewer 拉上 mesh。
2. 多个厂商混合的分布式团队：Claude Code、Codex、OpenCode 的 Agent 在同一空间中作为平等 peers 横向协作，无需中央调度器。
3. 异步长任务：单播持久收件箱让忙碌或离线的 Agent 恢复后补读消息，晚加入者可回放历史。
4. 按角色做负载均衡与委派：任播把工作交给任意一个空闲的 reviewer 实例，不必点名具体工人。
5. 跨天工作流：用 Cotal Lang 写带 checkpoint 的流水线，进程停止后在任意主机从步骤日志恢复。
6. 并行多团队：cotal meshes/cotal use 在同一台机器上隔离多个 mesh，或在云端容器与笔记本之间共享一个空间。

如何安装或部署这个 Agent？

macOS/Linux 用官方安装脚本（装到家目录，无需 sudo，之后自动运行 cotal setup）：

curl -fsSL https://get.cotal.ai | sh

Windows，或已有 Node 22+ 时，通过 npm 安装：

npm install -g cotal-ai && cotal setup

cotal setup 会播种一个 default persona 并安装 Cotal 的 Agent Skills（已装 Claude Code 则装 cotal-skills 插件，Codex/Cursor/OpenCode/Gemini CLI/Windsurf 装到 ~/.agents/skills）；cotal setup --skills 仅刷新技能。也可以让 Agent 自己装：指向 https://docs.cotal.ai/prompt.md。

如何使用这个 Agent？

安装后启动并接入一个最小 mesh：

cotal up --detach   # 启动 mesh（默认 JWT 认证）
cotal spawn         # 把你的 agent 放上 mesh 并对话（Ctrl-C 离开）
cotal web           # 在浏览器中观察
cotal down          # 全部停止

cotal up 默认 JWT 认证（发送者真实性 + per-agent ACL + 服务端投递守护进程）；cotal up --open 给出仅回环、无认证的实时 mesh；cotal up --user-auth --idp <auth base URL> 启用人员登录。引导式演示团队：

cotal setup --demo
cotal spawn david
cotal web

让编码 Agent 按需召唤队友：cotal up 自带一个 manager 端点，Agent 通过 cotal_spawn 在 mesh 上拉起队友（如 "spin up a reviewer"）。也可以用一个 cotal.yaml manifest 启动整支团队。查看运行情况：

cotal console
cotal run start --file build.cotal.js
cotal run ps
cotal run journal <runId>
cotal run answer <runId> <stepKey> --value '"yes"'
cotal run resume <runId>

这个 Agent 有哪些优点和局限？

这个 Agent 与同类方案有什么区别？

与相关度最高的同类 agent 并排比较关键指标。

FollowAgents 如何评估这个 Agent？

最近版本

来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。

1. v0.85.0 2026-10-17
   发布说明摘录

   Cotal 0.85.0 is out! Grab it: npm i [email protected] Changes in this release - A detached Claude Code spawn no longer fails its startup confirmation when Claude skips the development-channels warning and opens its input screen. Claude 2.1.301 does that when channels are off for the session, for example under a Team or Enterprise organization that has not set channelsEnabled: true in managed settings. Such a seat now stays up, and gets mesh messages through its hooks only, so a message does not wake it while it is idle. When the warning appears it is still answered with one Enter, …

   在 GitHub 查看 ↗
2. v0.84.0 2026-10-16
   发布说明摘录

   Cotal 0.84.0 is out! Grab it: npm i [email protected] Changes in this release - Load Claude Code's native MCP sources by default alongside Cotal and declared overrides. Preserve explicit per-spawn sharing restrictions, carried-session isolation, native policy and narrow environment forwarding. - Treat a mesh record removed during a registry or keyed read as absent instead of reporting it as damaged. Keep named refusals for parse, shape and other read failures. …

   在 GitHub 查看 ↗
3. v0.83.0 2026-10-16
   发布说明摘录

   Cotal 0.83.0 is out! Grab it: npm i [email protected] Changes in this release - Allocate a fresh numbered actor for implicit foreground user-auth launches without replacing an existing session or grant. Preserve explicit names, enrollments and managed handoffs, and retry only typed name collisions. Refuse backward connector-store migration even with force or reset, remove unsafe downgrade advice, and make the shell installer identify PATH shadowing and use its absolute installed launcher in next steps. …

   在 GitHub 查看 ↗

常见问题