Pulsar 讓不同程式工具裡的 AI 助理互相傳訊息
Show HN: Pulsar – cross-harness agent to agent communication and messaging
用不同程式工具工作的 AI 助理,往往不知道同一臺電腦上還有誰在忙,也不容易把工作交給彼此。
- Pulsar 是一套 MCP 伺服器,會列出正在運作的 AI 助理,讓人或助理依專案、角色等條件傳訊息,也能一次通知一群人。
- 收到訊息時,部分工具還能喚醒閒置助理。它會記錄訊息,並標明內容來自其他助理,不能替使用者核准任何事。Pulsar 目前在單一電腦上運作,跨電腦通訊列為未來功能。
AI 伴隨問答
針對這篇報導有疑問?可直接點選快捷問題或向 AI 追問背景脈絡與技術細節:
Pulsar 用同一個訊息匯流排連線不同工具中的 AI 助理,並能喚醒閒置助理,適合瞭解跨工具協作如何運作。
你的 AI 代理現在可以互相溝通了,任何代理執行環境都適用。
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
- 整臺電腦共用一份清單。列出所有正在執行的代理,不論使用哪種代理執行環境,也包括從未載入 pulsar 的 Claude Code 和 OpenCode 工作階段。Claude 工作階段會保留 Claude 為它們取的名稱;其他代理則會顯示為
harness@project。 - 標籤與活動狀態。代理會自行取得
harness、model、project、branch(推送程式碼的分支,即使是在名稱隨機產生的 worktree 中也能辨識)、worktree和pr(正在處理的 PR,會從本機 git refs 和工作階段記錄離線找出)。代理也能自行新增標籤,例如role:reviewer或issue:1378,並顯示活動狀態,例如「正在審查 PR #1402」。 - 傳訊息給任何人。可指定名稱、選擇器(例如
project=apparish、model=fable或pr=1402 role=reviewer)、任意文字(~1378),或使用*傳訊息給這臺電腦上的所有代理。「傳訊息給你的審查者」只要查詢一次即可。 - 推送訊息,不必輪詢。訊息會喚醒閒置中的代理;支援此功能的代理執行環境也會在回合進行期間收到
urgent類訊息(請參閱訊息傳遞)。 - 請求與回覆。
reply會保留對話串,ask會等候回覆才繼續,而wait可取代sleep迴圈(等待訊息、回覆或其他代理進入閒置狀態)。 - 預設安全。訊息會標示為來自其他代理,而非你的使用者,且無法核准任何事項。每個代理都能接受、保留或拒絕訊息。系統設有速率限制,也不會蒐集遙測資料。
安裝
npx pulsar setup
設定程式會尋找你的代理,清楚列出將變更的檔案,並只詢問一次。它會備份所有要修改的檔案,並將 pulsar 複製到本機資料夾供各代理執行,因此工作階段啟動時不必等待 npm。
| 旗標 | 用途 |
|---|---|
--yes --all-detected |
不詢問(適用於指令碼和設定檔) |
--client claude,codex |
只設定這些代理 |
--dry-run |
顯示計畫,不做任何變更 |
--no-mcp |
只安裝擴充功能和技能(適用於自行管理 MCP 設定的情況) |
--skills-dir <path> |
將技能放在共用資料夾,而非各代理的資料夾 |
--uninstall |
還原設定程式所做的所有變更 |
設定程式會安裝至 ~/.local/share/pulsar/<version>,並將所有代理指向 current 連結,因此 npx pulsar@latest setup 可直接就地升級。
沒有 Node?curl -fsSL https://raw.githubusercontent.com/yocontra/pulsar/main/install.sh | bash 會安裝專用的 Node,並執行相同的設定程式。
偏好使用代理執行環境自己的套件管理工具?以下指令會安裝 MCP 伺服器和技能(要在 pi 和 omp 中使用推送訊息功能,必須安裝 npm 套件,因為其中包含它們的擴充功能):
| 代理執行環境 | 指令 |
|---|---|
| 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 的工具核准機制,這些是透過外掛程式安裝無法設定的。
設定程式會對各代理執行環境做哪些變更
| 代理執行環境 | 變更內容 |
|---|---|
| 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 | 安裝 pulsar 套件的 pi install:用於推送訊息的擴充功能,同時也會註冊 MCP 伺服器,並包含技能 |
| omp | 在 ~/.omp/agent/mcp.json 中設定 mcpServers.pulsar,並安裝 omp install 擴充功能 |
| Cursor | 在 ~/.cursor/mcp.json 中設定 mcpServers.pulsar |
| Gemini CLI | 在 ~/.gemini/settings.json 中設定 mcpServers.pulsar |
手動設定 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 |
活動(「正在審查 PR #1402」)、標籤(role:reviewer)、名稱、模型、資料夾、訊息接收政策 |
whoami、history |
你的身分;搜尋訊息和對話串,並檢視收件回條 |
pulsar 也會安裝一個簡短的技能,教代理程式何時使用這些工具;MCP 伺服器也會以指示提供相同說明。
命令列介面
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
訊息如何傳遞
每臺機器上都有一個小型常駐程式(按需啟動,閒置時停止),負責維護登入資料和位於 ~/.local/state/pulsar 的 SQLite 訊息記錄。每個代理程式的 MCP 伺服器都是輕量使用者端,透過僅供目前使用者存取的 Unix 通訊端連線至常駐程式。常駐程式會透過各執行環境自己的入口推送每則訊息:
| 執行環境 | 推送路徑 | 喚醒閒置中的代理程式 |
|---|---|---|
| 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 Code SendMessage |
pulsar | |
|---|---|---|
| 支援的執行環境 | 僅限 Claude | Claude、Codex、OpenCode、pi、omp、Cursor、Gemini,以及任何 MCP 使用者端 |
| 依專案或角色尋找 | — | 標籤和選取器 |
| 傳送給一組收件者 | 每位收件者各呼叫一次 | project=x、任何選取器 |
| 廣播 | — | * |
| 等待回覆 | — | ask、wait reply:<id> |
| 閒置通知 | ✓ | ✓(wait idle:<agent>;Claude、OpenCode、pi、omp) |
| 收件回條和歷史紀錄 | — | 依收件者分類;可搜尋 |
| 機器 | 本機與 Remote Control | 一臺機器(v1) |
安全性
- 通訊端位於
0700資料夾中,只有你的使用者帳戶能存取。這就是信任邊界:以你的帳戶執行的程式都視為可信任,就像你的檔案一樣。常駐程式會根據連線標記每位寄件者,因此訊息無法冒充他人。代理程式內部的pulsar send會以該代理程式的身分發言,而代理程式也不能使用名稱operator。 - 傳遞的文字會說明訊息來自其他代理程式,而非你的使用者帳戶,且無法授予許可權。Claude 原有的安全防護仍會繼續生效。
- pulsar 絕不會代替 Claude 宣稱任何許可權模式。設定時會依照 Claude 檔案說明的
crossSessionInbound設定,請你允許 pulsar 傳送的訊息。 - 限制:每則訊息上限為 64 KB;每分鐘最多傳送 60 則訊息;每個代理程式每分鐘最多廣播 6 次;每個收件匣最多保留 50 則未讀訊息。
- 不會收集遙測資料。唯一的網路連線是
pulsar doctor的 npm 版本檢查。PR 偵測會離線進行:讀取本機 git refs 和代理程式自己的工作階段記錄。
如要回報安全性漏洞,請參閱 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 # 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。
授權條款
MIT