tt inbox

Check agent inbox(es).

Synopsis

tt inbox <AGENT>         # Check specific agent
tt inbox --all           # Show all agents' inboxes

Description

Shows pending messages in agent inboxes.

When used with --all, displays a summary of pending messages for all agents, categorized by type:

• [T] Tasks requiring action
• [Q] Queries awaiting response
• [I] Informational messages (FYI)
• [C] Confirmations/acknowledgments

Messages are added by:

• tt assign — Creates a task and sends TaskAssign message
• tt send — Sends a custom message

Arguments

Options

Examples

Check Specific Agent

tt inbox backend

Output:

📬 Inbox for 'backend': 3 messages

View All Agents’ Inboxes

tt inbox --all

Output:

📋 Pending Messages by Agent:

  backend (Working):
    [T] 2 tasks requiring action
    [Q] 1 queries awaiting response
    [I] 3 informational
    [C] 0 confirmations
    • Fix authentication bug in login endpoint
    • Update database schema for new fields

  reviewer (Idle):
    [T] 1 tasks requiring action
    [Q] 0 queries awaiting response
    [I] 0 informational
    [C] 2 confirmations
    • Review PR #42: Add user validation

Total: 4 actionable message(s)

Comparison with tt status

• tt status shows agent states and total inbox counts
• tt inbox --all shows message breakdown and previews

See Also

• tt send — Send messages to agents
• tt assign — Assign tasks (sends TaskAssign message)
• tt task — Manage individual tasks
• Messages Concept