Skill

inbox

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.

From hive

Install

Run in your terminal

npx claudepluginhub colonyops/hive --plugin hive

Tool Access

This skill uses the workspace's default tool permissions.

Supporting Assets

View in Repository

references/troubleshooting.md

Skill Content

Similar Skills

agent-harness-construction

Designs and optimizes AI agent action spaces, tool definitions, observation formats, error recovery, and context for higher task completion rates.

everything-claude-code

139.9k

agent-payment-x402

Enables AI agents to execute x402 payments with per-task budgets, spending controls, and non-custodial wallets via MCP tools. Use when agents pay for APIs, services, or other agents.

everything-claude-code

139.9k

agent-eval

Compares coding agents like Claude Code and Aider on custom YAML-defined codebase tasks using git worktrees, measuring pass rate, cost, time, and consistency.

everything-claude-code

139.9k

Stats

Parent Repo Stars23

Parent Repo Forks3

Last CommitFeb 26, 2026

Actions

View Source View Plugin View on GitHub View README

Inbox - Read Inter-Agent Messages

Check and read messages sent to this session's inbox from other agents or sessions.

When to Use

Another agent mentions sending a message
Starting work on a task that may have been handed off
Coordinating with other Claude sessions
Checking for pending messages or recent communications

How It Works

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.

Commands

Read Unread Messages (Default)

hive msg inbox

Shows unread messages without marking them as read.

Read and Acknowledge

hive msg inbox --ack

Shows unread messages and marks them as read so they won't appear again.

Read All Messages

hive msg inbox --all

Shows all messages (read and unread).

Specify Session Explicitly

hive msg inbox --session <id|name>

Overrides auto-detection from working directory. Useful when running outside a session directory.

Wait for a Message

hive msg inbox --wait
hive msg inbox --wait --timeout 2m

Blocks until a message arrives. Default timeout is 24h for wait mode.

Poll for New Messages

hive msg inbox --listen --timeout 30s

Continuously polls and outputs new messages until timeout.

Limit Results

hive msg inbox --tail 5

Returns only the last N unread messages.

Output Format

All output is JSON Lines (one JSON object per line) on stdout. Fields:

id - Unique message identifier
topic - The inbox topic (agent.<id>.inbox)
payload - The message text
sender - Who sent the message (session ID or custom sender)
session_id - Sender's session ID (if auto-detected)
created_at - ISO 8601 timestamp

On timeout (--listen/--wait), a JSON status line is printed and exit code is 1.

Common Workflows

Basic Message Check

hive msg inbox

Read and act on any unread messages.

Handle Coordinated Handoff

When another agent hands off work:

# Check inbox for handoff message
hive msg inbox

# Read referenced task details
bd show <issue-id>

Review Message History

hive msg inbox --all

Additional Resources

For troubleshooting and advanced usage patterns, see:

references/troubleshooting.md - Common issues and solutions

Related Skills

/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