菜单
This skill should be used when the user asks to "check my inbox", "read my messages", "any unread messages?", "check for new messages", "see my inbox", or needs to read inter-agent messages from other hive sessions. Provides guidance on reading, filtering, and managing inbox messages.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
This skill should be used when the user asks to "configure hive", "setup hive for my workflow", "customize session spawn", "add tmux integration", "create custom keybindings", "add user commands", or needs guidance on hive configuration, rules, spawn commands, terminal integration, or keybindings.
Use `hive hc` commands to track tasks and epics for agent workflows. Like GitHub Issues but scoped to a repository and designed for machine consumption. Use when: - Creating work items (epics, tasks) - Checking item status or listing open work - Recording progress via comments - Claiming the next actionable task for a session - Querying epic context as a structured summary
Define and extend Go enums using the go-enum code generator. Use when adding new enum types, extending existing ones, or running generation after changes.
Add SQL queries, run code generation, and configure type overrides for the hive SQLite data layer. Use when writing new queries, adding tables, or mapping domain types to generated code.
This skill should be used when the user asks to "send message to agent X", "publish to topic", "broadcast to all agents", "notify other sessions", "tell agent Y that...", or needs to send inter-agent messages, hand off work, or broadcast notifications across hive sessions.
This skill should be used when the user asks to "wait for message from agent X", "block until response", "wait for handoff", "synchronize with other agents", "wait for acknowledgment", or needs to block execution until messages arrive on specific topics with configurable timeout.
| name | inbox |
| description | This skill should be used when the user asks to "check my inbox", "read my messages", "any unread messages?", "check for new messages", "see my inbox", or needs to read inter-agent messages from other hive sessions. Provides guidance on reading, filtering, and managing inbox messages. |
| compatibility | claude, opencode |
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
hive hc 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