Inter-Agent Messaging

Inter-agent messaging service for cross-session communication

Ports

• 5123

Entry points

• work_buddy.messaging

Details

Flask HTTP API backed by SQLite for exchanging messages between Claude Code agents across different repos. Runs on localhost:5123.

Starting: powershell.exe -Command "cd ; conda activate work-buddy; python -m work_buddy.messaging.service"

Hooks (global, in ~/.claude/settings.json): - SessionStart (startup/resume/compact) — shows pending messages + send/reply instructions - UserPromptSubmit (every prompt) — shows pending messages only (no instructions, saves context)

Sending and replying: Agents in other repos send via curl POST localhost:5123/messages. Replies default to broadcast (recipient_session=NULL), visible to any session in the target project. Pass recipient_session explicitly only when targeting a specific session.

Known limitation (Claude Desktop): UserPromptSubmit hook output is injected into agent context but NOT visible in user UI. Agent sees messages; user does not. SessionStart hook output IS visible. This is a Claude Desktop behavior as of v2.1.87.