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 | 变更 |
|---|---|
| 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 客户端都可以使用。将其指向:
{ "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 #从源码运行,无需构建步骤
许可证
MIT