你的 AI 智能体现在可以互相通信了。在任何 harness 中。

CI npm License: MIT

pulsar 是一个 MCP 服务器,它把你机器上的每个 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以及pr(它们正在处理的 PR,通过本地 git refs 和它们的会话日志离线找到)。它们会添加自己的标签,例如role:reviewer或issue:1378,以及一行活动状态,例如 "reviewing PR #1402"。
  • 发给任何人。指定一个名字、一个选择器,例如project=apparish、model=fable或pr=1402 role=reviewer,在任意位置输入文本(~1378),或者用*发给机器上的每个智能体。"Message your reviewer" 只需一次查找。
  • 推送,而非轮询。消息会唤醒空闲的智能体,urgent消息会在回合中途送达(在 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>并让每个智能体指向current链接,因此npx pulsar@latest setup会就地升级。

没有 Node?curl -fsSL https://raw.githubusercontent.com/yocontra/pulsar/main/install.sh | bash安装一个私有 Node 并运行相同的设置。

更喜欢你的 harness 自带的包管理器?以下命令会安装 MCP 服务器和技能(将推送投递到 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(扩展 + 技能),或/marketplace add yocontra/pulsar
pi pi install npm:pulsar(扩展、MCP 工具和技能)

pulsar setup还会设置 Claude 的crossSessionInbound以及 Codex 的工具审批,这是插件安装无法做到的。

各 harness 中 setup 会改变什么
Harness 变更
Claude Code claude mcp add-json pulsar --scope user;crossSessionInbound: "accept"在~/.claude/settings.json中,使 pulsar 消息能到达跳过权限提示的会话;技能位于~/.claude/skills/pulsar
Codex codex mcp add pulsar,其中 pulsar 的工具已获批准,且工具超时更长(用于ask/wait);技能位于~/.codex/skills/pulsar
OpenCode mcp.servers.pulsar中opencode.jsonc(保留注释);技能位于~/.config/opencode/skills/pulsar
pi pi installpulsar 包中:一个用于推送投递的扩展,同时注册 MCP 服务器,外加技能
omp mcpServers.pulsar中~/.omp/agent/mcp.json,外加omp install扩展的
Cursor mcpServers.pulsar中~/.cursor/mcp.json
Gemini CLI mcpServers.pulsar中~/.gemini/settings.json
手动 MCP 配置

任何 MCP 客户端都可以使用。将其指向:

{ "command": "npx", "args": ["-y", "pulsar", "mcp"] }

如果该客户端没有推送路径,消息会等待在智能体的收件箱中,并且每个 pulsar 工具结果都会说明何时有未读消息在等待。

工具

工具 用途
list_agents 谁在线。selector:*、名称、key=value条件(project=x、branch=y、pr=1402、model=fable、harness=codex、status=idle、任意标签),或~text
send 向名称、选择器或*发送消息。priority:urgent(回合中),normal(下一回合,唤醒空闲),fyi(不唤醒)
reply 按 id 在其线程中回复消息
ask 发送并阻塞直到收到第一条回复
wait 阻塞等待message、reply:<id>或idle:<agent>
inbox 未被推送到对话中的消息
set_identity 活动("reviewing PR #1402")、标签(role:reviewer)、名称、模型、文件夹、入站策略
whoami、history 你的身份;搜索消息和线程,附带回执

pulsar 还会安装一个简短的技能,教智能体何时使用这些,并且 MCP 服务器会以指令形式发送相同的指导。

CLI

pulsar ls [selector]          #谁在线
pulsar send '*' "main 已为发布冻结"
pulsar send project=apparish --expect-reply "谁负责 auth 迁移?"
pulsar reply m_123 "在处理"    #在其线程中回复消息
pulsar inbox                  #发送给你的回复("operator")
pulsar tail                   #加入、离开和消息的实时流
pulsar doctor                 #检查守护进程和每个 harness

投递如何工作

每台机器一个小型守护进程(按需启动,空闲时停止)将注册表和 SQLite 消息日志保存在~/.local/state/pulsar。每个智能体的 MCP 服务器都是守护进程的瘦客户端,通过仅限用户的 Unix 套接字通信。守护进程通过每个 harness 自己的入口推送每条消息:

Harness 推送路径 唤醒空闲
Claude Code Claude 的每会话收件箱套接字(即SendMessage使用的那个) ✓
Codex codex queue --resume(app-server 守护进程) ✓
OpenCode 本地服务器的POST /api/session/{id}/prompt ✓
pi、omp pulsar 扩展的sendMessage({ triggerTurn }) ✓
其他内容 收件箱 + 在每个 pulsar 工具结果上标注“N 条未读” —

守护进程还会扫描从未加载 pulsar 的活跃 Claude Code 和 OpenCode 会话,使它们也能显示出来并接收消息。详情和边界情况见docs/adapters.md。

与 Claude Code 内置的消息功能相比

Claude CodeSendMessage pulsar
运行框架 仅 Claude Claude、Codex、OpenCode、pi、omp、Cursor、Gemini、任意 MCP 客户端
按项目或角色查找 — 标签 + 选择器
发送给一组 每个接收者一次调用 project=x,任意选择器
广播 — *
等待回复 — ask,wait reply:<id>
空闲通知 ✓ ✓(wait idle:<agent>;Claude、OpenCode、pi、omp)
回执与历史记录 — 按接收者;可搜索
机器 本地 + 远程控制 单台机器(v1)

安全性

  • 套接字位于一个0700文件夹中,且仅你的用户可访问。这就是信任边界:以你的身份运行的进程是被信任的,正如它们对你的文件一样。守护进程根据连接为每个发送者打上标记,因此消息无法冒充来自他人。pulsar send从智能体内部发出的消息以该智能体的身份说话,且任何智能体都不能使用operator这个名字。
  • 投递的文本会说明它来自对等智能体,而非你的用户,并且它无法授予权限。Claude 自身的防护措施仍然叠加生效。
  • pulsar 从不代表 Claude 声明权限模式。安装程序会要求你使用 Claude 文档中记载的crossSessionInbound设置来允许 pulsar 的消息。
  • 限制:每条消息 64 KB,每分钟 60 次发送,每个智能体每分钟 6 次广播,每个收件箱 50 条未读。
  • 无遥测。唯一的网络调用是pulsar doctor的 npm 版本检查。PR 检测是离线的:它读取本地 git 引用和智能体自身的会话日志。

参见SECURITY.md报告漏洞。

环境

变量 默认值 作用
PULSAR_HOME $XDG_STATE_HOME/pulsar 状态文件夹:套接字、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 自动检测 此智能体注册时使用的名称
PULSAR_TAGS 无 此智能体的额外标签,以逗号或空格分隔
PULSAR_HARNESS 自动检测 强制指定运行框架(claude,codex,opencode,pi,omp,……)
PULSAR_SESSION_ID 自动检测 强制指定运行框架会话 ID
PULSAR_DEBUG 未设置 设置后,MCP 服务器将日志写入mcp-debug.log(位于状态文件夹中)

开发

bun install
bun run check     #类型检查 + lint + 测试
bun run build     #打包 dist/cli.js 和 dist/extension.js
node src/cli.ts ls   #从源码运行,无需构建步骤

参见CONTRIBUTING.md。

许可证

MIT