CLICommands
inbox
snug inbox <COMMAND>Inbox persistent notifications.
Subcommands
| Command | What it does |
|---|---|
send | Send a message to one or more recipients |
batch-send | Send many distinct messages from a JSON file (array of message objects) |
list | List messages in the current inbox |
get | Get a single message |
read | Mark a message read |
unread | Mark a message unread |
dismiss | Dismiss or archive a message |
bulk | Bulk apply an operation to messages |
channel | Channel management |
counts | Show aggregate unread counts |
threads | List thread summaries |
action | Execute an interactive message action |
receipt | Record a read or delivery receipt |
maintenance | Run scheduled-delivery promotion, expiry, and self-destruct sweeps (admin) |
Run snug inbox <command> --help for that command's own options.
The global options apply everywhere.
Examples
snug inbox send --to user_123 --channel ich_agent_handoff --msg "Hello"
snug inbox send --to user_123 --to user_456 --channel ich_agent_handoff --title "Review handoff" --msg "Ready" --priority high
snug inbox send --to user_123 --channel ich_agent_handoff --msg "Reminder" --deliver-at 2026-07-01T09:00:00Z
snug inbox list --unread
snug inbox list --channel ich_agent_handoff --priority high --page 1 --page-size 20
snug inbox get --message-id msg_01JABCDEF --mark-read
snug inbox read --message-id msg_01JABCDEF
snug inbox unread --message-id msg_01JABCDEF
snug inbox dismiss --message-id msg_01JABCDEF --archive
snug inbox bulk --operation mark_read --unread-only
snug inbox bulk --operation dismiss --message-id msg_01JABCDEF --message-id msg_01JGHIJKL
snug inbox counts
snug inbox threads
snug inbox action --message-id msg_01JABCDEF --action-id act_ack
snug inbox receipt --message-id msg_01JABCDEF --kind read
snug inbox maintenance
snug inbox channel create --name agent.handoff --actions-allowed --technical-notes-required
snug inbox channel list
snug inbox channel get --channel-id ich_agent_handoffNext
- inbox guide - what the service does and when to reach for it.
- API reference - every endpoint these commands call.
- CLI reference - global options, output modes, and exit codes.