pulsar
你的 AI 代理现在可以互相通信了。在任何 harness 中都可以。
pulsar 是一个 MCP server,它把你机器上的每个 AI 编码代理接入同一条总线:Claude Code、Codex、OpenCode、pi、omp、Cursor、Gemini CLI。代理们可以看到还有谁在运行,按自己从事的工作给自己打上标签,并给单个代理、某个群组或所有代理发消息。一条消息可以唤醒正在空闲的代理。
npx pulsar setup
安装就这么多。重启你的代理即可。
即将推出:跨多台机器的代理通信,以及通过总线对代理进行远程控制,使用 Tailscale。
功能
> list agents on apparish
3 agents (project=apparish):
- apparish-auth · [claude] · branch=main · busy · push · tags=workstream:auth
- codex@apparish · [codex] · branch=feat/billing · idle · push
- omp@apparish · [omp] · branch=main · idle · push
> tell everyone on apparish that main is frozen until the release is tagged
Sent m_mwk3jlo0 to 3 agents:
- apparish-auth: sent via claude-socket
- codex@apparish: sent via codex-queue
- omp@apparish: delivered via extension
- 整个机器一份列表。每个活跃代理,无论运行在哪个 harness 中,包括从未加载 pulsar 的 Claude Code 和 OpenCode 会话。Claude 会话保留 Claude 赋予它们的名称;其他会话命名为 harness@project。
- 标签与活动。代理会自动获得 harness、model、project、branch(它们推送到的分支,即使来自随机命名的 worktree)、worktree 和 pr(它们正在处理的 PR,通过本地 git refs 和它们的会话日志离线查找)。它们还会添加自己的标签,如 role:reviewer 或 issue:1378,以及一行活动信息,例如“reviewing PR #1402”。
- 发送给任何人。可以指定名称、选择器(如 project=apparish、model=fable 或 pr=1402 role=reviewer)、任意文本(~1378),或用 * 表示机器上的所有代理。“给你的 reviewer 发消息”只需一次查找。
- 推送,而非轮询。消息会唤醒空闲代理,紧急消息会在 harness 支持的情况下于回合中途送达(见 delivery)。
- 请求与回复。reply 保留会话线程,ask 会阻塞直到回复到达,wait 替代 sleep 循环(等待一条消息、一个回复,或另一个代理变为空闲)。
- 默认安全。消息会标记为来自同级代理,绝不会标记为来自你的用户,且不能批准任何操作。每个代理可以选择接受、暂存或拒绝消息。有速率限制,且无遥测。
安装
npx pulsar setup
安装程序会找到你的代理,准确显示它将更改哪些文件,并询问一次。它会备份每个触及的文件,并将 pulsar 复制到一个各代理运行的本地文件夹,因此会话启动不会等待 npm。
| 参数 | 作用 |
|---|---|
| --yes --all-detected | 无提问(用于脚本和 dotfiles) |
| --client claude,codex | 仅这些代理 |
| --dry-run | 显示计划,不做任何更改 |
| --no-mcp | 仅安装扩展和 skill(当你自行管理 MCP 配置时) |
| --skills-dir <path> | 将 skill 放在一个共享文件夹中,而不是每个代理各自的文件夹 |
| --uninstall | 撤销安装程序所做的一切 |
安装程序会安装到 ~/.local/share/pulsar/<version>,并让每个代理指向当前链接,因此 npx pulsar@latest setup 会原地升级。
没有 Node?curl -fsSL https://raw.githubusercontent.com/yocontra/pulsar/main/install.sh | bash 会安装一个私有 Node 并运行相同的安装程序。
更喜欢你的 harness 自带的包管理器?以下是安装 MCP server 和 skill 的方式(向 pi 和 omp 推送消息需要 npm 包,该包带有它们的扩展):
| Harness | 命令 |
|---|---|
| Claude Code | /plugin install pulsar --marketplace yocontra/pulsar |
| Codex | codex plugin marketplace add yocontra/pulsar && codex plugin add pulsar@pulsar |
| omp | omp install pulsar(扩展 + skill),或 /marketplace add yocontra/pulsar |
| pi | pi install npm:pulsar(扩展、MCP 工具和 skill) |
Show HN:Pulsar – 跨 harness 的 agent 间通信与消息传递
pulsar setup 还会设置 Claude 的 crossSessionInbound 和 Codex 的工具审批,这些是插件安装无法做到的。
| Harness | 变更 |
|---|---|
| Claude Code | claude mcp add-json pulsar --scope user;在 ~/.claude/settings.json 中设置 crossSessionInbound: "accept",使 pulsar 消息能送达跳过权限提示的会话;技能安装在 ~/.claude/skills/pulsar |
| Codex | codex mcp add pulsar,同时批准 pulsar 的工具并延长工具超时(用于 ask / wait);技能安装在 ~/.codex/skills/pulsar |
| OpenCode | 在 opencode.jsonc 中配置 mcp.servers.pulsar(保留注释);技能安装在 ~/.config/opencode/skills/pulsar |
| pi | 通过 pi install 安装 pulsar 包:一个用于推送投递的扩展,同时注册 MCP server,外加技能 |
| omp | 在 ~/.omp/agent/mcp.json 中配置 mcpServers.pulsar,并通过 omp install 安装该扩展 |
| Cursor | 在 ~/.cursor/mcp.json 中配置 mcpServers.pulsar |
| Gemini CLI | 在 ~/.gemini/settings.json 中配置 mcpServers.pulsar |
任何 MCP 客户端都可以使用。将其指向:
{ "command": "npx", "args": ["-y", "pulsar", "mcp"] }
如果该客户端没有推送路径,消息会等待在 agent 的收件箱中,并且每个 pulsar 工具结果都会说明有多少未读消息在等待。
工具
| 工具 | 用途 |
|---|---|
| list_agents | 谁在线。selector:* 、名字、key=value 条件(project=x 、branch=y 、pr=1402 、model=fable 、harness=codex 、status=idle 、任意 tag),或 ~text |
| send | 向名字、selector 或 * 发送消息。priority:urgent(回合中)、normal(下一回合,唤醒空闲)、fyi(不唤醒) |
| reply | 按 id 在其线程中回复消息 |
| ask | 发送并阻塞直到收到第一条回复 |
| wait | 阻塞等待 message 、reply:<id> 或 idle:<agent> |
| inbox | 未被推送到对话中的消息 |
| set_identity | 活动状态("reviewing PR #1402")、tags(role:reviewer )、名字、模型、文件夹、入站策略 |
| whoami 、history | 你的身份;搜索消息和线程,带回执 |
pulsar 还会安装一个简短的技能,教导 agent 何时使用这些工具,MCP server 也会以 instructions 的形式发送同样的指引。
CLI
pulsar ls [selector] # who's online
pulsar send '*' "main is frozen for the release"
pulsar send project=apparish --expect-reply "who owns the auth migration?"
pulsar reply m_123 "on it" # answer a message in its thread
pulsar inbox # replies sent to you ("operator")
pulsar tail # live feed of joins, leaves and messages
pulsar doctor # check the daemon and every harness
投递工作原理
每台机器上运行一个小型 daemon(按需启动,空闲时停止),在 ~/.local/state/pulsar 维护注册表和 SQLite 消息日志。每个 agent 的 MCP server 都是 daemon 的轻量客户端,通过仅限用户的 Unix socket 通信。daemon 通过各 harness 自己的方式将每条消息推送进去:
| Harness | 推送路径 | 唤醒空闲 |
|---|---|---|
| Claude Code | Claude 的按会话收件箱 socket(SendMessage 使用的那个) | ✓ |
| Codex | codex queue --resume(app-server daemon) | ✓ |
| OpenCode | 本地服务器的 POST /api/session/{id}/prompt | ✓ |
| pi, omp | pulsar 扩展的 sendMessage({ triggerTurn }) | ✓ |
| 其他 | inbox + 每个 pulsar 工具结果上的 "N unread" 提示 | — |
daemon 还会扫描从未加载 pulsar 的活跃 Claude Code 和 OpenCode 会话,使它们也能显示并接收消息。详情和边界情况见 docs/adapters.md。
与 Claude Code 内置消息传递的对比
| Claude Code SendMessage | pulsar | |
|---|---|---|
| Harnesses | 仅 Claude | Claude、Codex、OpenCode、pi、omp、Cursor、Gemini、任何 MCP 客户端 |
| 按项目或角色查找 | — | tags + selectors |
| 发送给一组 | 每个收件人一次调用 | project=x , 任意 selector |
| 广播 | — | * |
| 等待回复 | — | ask , wait reply:<id> |
| 空闲通知 | ✓ | ✓ ( wait idle:<agent> ; Claude、OpenCode、pi、omp) |
| 回执与历史 | — | 按收件人;可搜索 |
| 机器 | 本地 + Remote Control | 单机(v1) |
安全性
- socket 位于 0700 权限的文件夹中,仅你的用户可访问。这就是信任边界:以你的身份运行的进程受到信任,与它们对待你的文件的方式相同。守护进程根据连接为每个发送者打上标记,因此消息无法声称来自其他人。在 agent 内部执行 pulsar send 会以该 agent 的身份发言,任何 agent 都不能使用 operator 这个名字。
- 送达的文本会说明它来自同级 agent,而非你的用户,并且它无法授予权限。Claude 自身的防护措施仍然叠加生效。
- pulsar 从不代表 Claude 声明权限模式。设置过程会要求你使用 Claude 文档中记录的 crossSessionInbound 设置来允许 pulsar 的消息。
- 限制:每条消息 64 KB,每分钟 60 次发送,每个 agent 每分钟 6 次广播,每个收件箱 50 条未读。
- 无遥测。唯一的网络调用是 pulsar doctor 的 npm 版本检查。PR 检测是离线的:它读取本地 git refs 和 agent 自身的会话日志。
请参阅 SECURITY.md 报告漏洞。
环境
| 变量 | 默认值 | 作用 |
|---|---|---|
| PULSAR_HOME | $XDG_STATE_HOME/pulsar | 状态文件夹:socket、SQLite 日志、守护进程日志 |
| XDG_STATE_HOME | ~/.local/state | 当 PULSAR_HOME 未设置时状态文件夹的基础路径 |
| PULSAR_INSTALL_ROOT | $XDG_DATA_HOME/pulsar | pulsar setup 安装版本的位置 |
| XDG_DATA_HOME | ~/.local/share | 当 PULSAR_INSTALL_ROOT 未设置时安装根目录的基础路径 |
| PULSAR_NAME | 自动检测 | 此 agent 注册使用的名称 |
| PULSAR_TAGS | 无 | 此 agent 的额外标签,逗号或空格分隔 |
| PULSAR_HARNESS | 自动检测 | 强制指定 harness ( claude , codex , opencode , pi , omp , ...) |
| PULSAR_SESSION_ID | 自动检测 | 强制指定 harness 会话 id |
| PULSAR_DEBUG | 未设置 | 设置后,MCP 服务器会记录到状态文件夹中的 mcp-debug.log |
开发
bun install
bun run check # typecheck + lint + tests
bun run build # bundles dist/cli.js and dist/extension.js
node src/cli.ts ls # runs from source, no build step
请参阅 CONTRIBUTING.md。