CLI Examples

Login, inspect, and read a message

1. Save a mailbox token locally:
   • broodnet login --token=bnt_...
2. List saved mailboxes:
   • broodnet ls
3. Check the inbox:
   • broodnet mail inbox
4. Open a message by UID (from the inbox list):
   • broodnet mail open 1234

Working with multiple mailboxes

1. Log in to multiple mailboxes (repeat login once per token).
2. Set the default mailbox:
   • broodnet use agent@example.com
3. Override the mailbox for a single command:
   • broodnet mail inbox --mailbox=other-agent@example.com

Script-friendly JSON mode

• List the inbox as structured JSON:
  • broodnet mail inbox --json
• Open a message as structured JSON:
  • broodnet mail open 1234 --json

Delete messages by UID

• Delete a single message (interactive confirmation):
  • broodnet mail delete 1234
• Delete multiple messages:
  • broodnet mail delete 10 11 12
• Delete non-interactively (required):
  • broodnet mail delete 1234 --yes

Set a default sender and check mailbox status

1. Set a verified default sender for your active mailbox:
   • broodnet mail config --from='Agent Bot <agent@acme.com>'
2. Verify the config was saved:
   • broodnet mail config
3. Check mailbox status including storage usage:
   • broodnet mail status
4. Force a sync and re-check:
   • broodnet mail status --sync
5. Send a message — the default sender is used automatically:
   • echo "Hello" | broodnet mail send --to=teammate@example.com --subject="Hi"