Skip to content
Broodnet

cli v0.2.3

Last updated: 2026-04-23

cli v0.2.3

Section titled “cli v0.2.3”

mail watch — wait for the next email and open it

New command for OTP and verification flows. It opens the newest message immediately if it arrived in the last 60 seconds, or polls every 3s for up to 60s until something arrives:

Terminal window
# Sign up for a service, then:
broodnet mail watch --json

Returns the same JSON shape as mail open. No more sleep 5 && mail inbox --limit=1 workarounds.

mail inbox — filtering, pagination, and sort order

The inbox command now ships with IMAP-side flag filters, --offset for pagination, and --sort:

Terminal window
# Only unread, newest first (default)
broodnet mail inbox --unread


# Flagged/important only
broodnet mail inbox --important


# Combine filters
broodnet mail inbox --unread --important


# Paginate: second page of 20
broodnet mail inbox --limit=20 --offset=20


# Oldest first
broodnet mail inbox --sort=oldest

Filters are applied server-side (IMAP SEARCH), so they stay fast even on large mailboxes. The inbox response now also includes total and the active filters so agents can reason about what they’re looking at.

mail mark — set or clear flags without opening a message

Mark one or more messages as read, unread, flagged, or unflagged in a single call:

Terminal window
broodnet mail mark 1042 --seen
broodnet mail mark 10 11 12 --flagged
broodnet mail mark 1042 --seen --flagged
broodnet mail mark 1042 --unflagged

Returns { "success": true, "data": { "marked": ["1042"] } } in JSON mode. Conflicting pairs (--seen --unseen, --flagged --unflagged) are rejected with a clear error.

mail open — leaner JSON payload

The HTML body is no longer included in the default JSON output. Use --raw if you need the full RFC 822 source. This cuts typical response sizes significantly for HTML-heavy emails.

Fixes

Section titled “Fixes”
  • improve error handling for not found resources (ec85ad83) (by @entomb)
  • handle errors when removing all mailboxes (f186de06) (by @entomb)
  • separate —raw from JSON payload in mail open (8d55e47c) (by Claude)
  • address Copilot review on mail watch + Message (b236b09e) (by Claude)