Help us improve
Share bugs, ideas, or general feedback.
How this skill is triggered — by the user, by Claude, or both
Slash command
/hive:inboxThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Check and read messages sent to this session's inbox from other agents or sessions.
Enables communication between coding agent sessions via msg CLI: register in tmux panes, send/reply messages, check inbox, list agents/threads.
Agent-to-agent messaging bus for Claude Code. Sends messages between local sessions, delegates tasks, fans-out work, and coordinates concurrent agents on the same machine.
Share bugs, ideas, or general feedback.
Check and read messages sent to this session's inbox from other agents or sessions.
Each hive session has a unique inbox topic (agent.<id>.inbox). Other agents publish messages to this inbox, readable via the commands below.
By default, messages are NOT marked as read. Use --ack to acknowledge messages.
hive msg inbox
Shows unread messages without marking them as read.
hive msg inbox --ack
Shows unread messages and marks them as read so they won't appear again.
hive msg inbox --all
Shows all messages (read and unread).
hive msg inbox --session <id|name>
Overrides auto-detection from working directory. Useful when running outside a session directory.
hive msg inbox --wait
hive msg inbox --wait --timeout 2m
Blocks until a message arrives. Default timeout is 24h for wait mode.
hive msg inbox --listen --timeout 30s
Continuously polls and outputs new messages until timeout.
hive msg inbox --tail 5
Returns only the last N unread messages.
All output is JSON Lines (one JSON object per line) on stdout. Fields:
id - Unique message identifiertopic - The inbox topic (agent.<id>.inbox)payload - The message textsender - Who sent the message (session ID or custom sender)session_id - Sender's session ID (if auto-detected)created_at - ISO 8601 timestampOn timeout (--listen/--wait), a JSON status line is printed and exit code is 1.
hive msg inbox
Read and act on any unread messages.
When another agent hands off work:
# Check inbox for handoff message
hive msg inbox
# Read referenced task details
bd show <issue-id>
hive msg inbox --all
For troubleshooting and advanced usage patterns, see:
references/troubleshooting.md - Common issues and solutions/hive:publish - Send messages to other agents/hive:wait - Wait for specific messages with timeout/hive:session-info - Get current session details and inbox topic