mayros mailbox

Manage persistent messages between agents. Messages are stored in AIngle Cortex and survive restarts.

Global options

  • --cortex-host <host> — Cortex host (default: 127.0.0.1 or from config)
  • --cortex-port <port> — Cortex port (default: 8080 or from config)
  • --cortex-token <token> — Cortex auth token (or set CORTEX_AUTH_TOKEN)

Subcommands

mailbox list

List messages in an agent's inbox.

Options:

FlagDescription
--agent <id>Agent ID (default: current agent)
--status <status>Filter: unread, read, archived
--type <type>Filter by message type
--from <id>Filter by sender agent ID
--limit <n>Max messages (default: 20)
--format <fmt>Output: terminal, json (default: terminal)

mailbox read <messageId>

Read a specific message and automatically mark it as read.

Options:

FlagDescription
--agent <id>Recipient agent ID (default: main)
--format <fmt>Output: terminal, json

mailbox send

Send a message to another agent.

Options:

FlagDescription
--from <id>(required) Sender agent ID
--to <id>(required) Recipient agent ID
--content <text>(required) Message content
--type <type>Message type (default: task). Options: task, finding, question, status, knowledge-share, delegation-context
--reply-to <id>Parent message ID for threading
--format <fmt>Output: terminal, json

mailbox archive <messageId>

Archive a message.

Options: --agent <id> (default: main)

mailbox stats

Show mailbox statistics: total, unread, read, archived counts and breakdown by message type.

Options:

FlagDescription
--agent <id>Agent ID (default: main)
--format <fmt>Output: terminal, json

Examples

bash
mayros mailbox list
mayros mailbox list --agent ops --status unread
mayros mailbox read msg-abc123
mayros mailbox send --from main --to ops --content "Review PR #42" --type task
mayros mailbox send --from ops --to main --content "Done" --reply-to msg-abc123 --type status
mayros mailbox archive msg-abc123
mayros mailbox stats --agent ops