/inbox — Agent Mail Inbox
Purpose: Check the agent mail inbox for pending messages, HELP_REQUESTs, and inter-agent notifications.
YOU MUST EXECUTE THIS WORKFLOW. Do not just describe it.
CLI dependencies: gt — required. This skill wraps gt mail inbox.
Quick Start
/inbox # Check pending messagesExecution Steps
Step 1: Check Inbox
if command -v gt &>/dev/null; then
gt mail inbox
else
echo "gt CLI not installed. Install with: brew install gt"
exit 1
fiStep 2: Display Results
Show the inbox contents to the user. If there are pending messages, display them with sender, timestamp, and content. If the inbox is empty, confirm no pending messages.
Step 3: Suggest Action
If messages contain HELP_REQUESTs, suggest responding. If inbox is empty, confirm and suggest returning to current work.
Examples
Checking Inbox With Messages
User says: /inbox
What happens:
- Agent runs
gt mail inboxto retrieve pending messages - Agent displays messages with sender, timestamp, and content
- Agent suggests responding to any HELP_REQUESTs
Result: User sees pending messages and can act on them.
Checking Empty Inbox
User says: /inbox
What happens:
- Agent runs
gt mail inboxand finds no messages - Agent confirms inbox is empty
Result: User confirms no pending messages and continues current work.
Troubleshooting
| Problem | Cause | Solution |
|---|---|---|
| "gt CLI not installed" | gt not in PATH | Install with brew install gt |
| No messages shown but expected | Messages already read or expired | Check gt mail for full mail history |
| Permission error | gt not configured for this workspace | Run gt init to configure the workspace |