Newshot

Show HN:Pulsar —— 跨 harness 的智能体间通信与消息传递

Translation(model translation, not the source's own text)

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
Codexcodex plugin marketplace add yocontra/pulsar && codex plugin add pulsar@pulsar
ompomp install pulsar(扩展 + skill),或 /marketplace add yocontra/pulsar
pipi install npm:pulsar(扩展、MCP 工具和 skill)

Show HN:Pulsar – 跨 harness 的 agent 间通信与消息传递

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

Harness变更
Claude Codeclaude mcp add-json pulsar --scope user;在 ~/.claude/settings.json 中设置 crossSessionInbound: "accept",使 pulsar 消息能送达跳过权限提示的会话;技能安装在 ~/.claude/skills/pulsar
Codexcodex 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 CodeClaude 的按会话收件箱 socket(SendMessage 使用的那个)✓
Codexcodex queue --resume(app-server daemon)✓
OpenCode本地服务器的 POST /api/session/{id}/prompt✓
pi, omppulsar 扩展的 sendMessage({ triggerTurn })✓
其他inbox + 每个 pulsar 工具结果上的 "N unread" 提示—

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

与 Claude Code 内置消息传递的对比

Claude Code SendMessagepulsar
Harnesses仅 ClaudeClaude、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/pulsarpulsar 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。

许可证

The translation is machine-generated and individual terms may be off. Nothing is rewritten or cut; the original is authoritative.

Published by Hacker News
This site only summarises and aggregates; copyright stays with the original author. Headlines and summaries follow the source — where they differ, the original wins.
Read the original ↗