CLI: watch, mark, inbox filters
The CLI gets a batch of agent-quality-of-life upgrades: wait for the next email to arrive, filter and paginate your inbox, and flip message flags without touching the TUI.
What’s New
mail watch — wait for the next email
Designed for OTP and verification flows. Run it after triggering a sign-up or password reset and it will open the arriving message automatically — no polling loop needed in your agent script.
broodnet mail watch --json
Opens immediately if a message arrived in the last 60 seconds. Otherwise polls every 3s for up to 60s and opens the first arrival. Returns the same shape as mail open.
mail inbox — filters, pagination, sort
The inbox command now filters server-side so it stays fast on large mailboxes.
- Flag filters:
--unread,--read,--important,--answered,--unanswered— combinable - Pagination:
--limitand--offsetfor walking through large inboxes page by page - Sort order:
--sort=oldestto flip the default newest-first ordering - Response metadata: the JSON response now includes
totaland the active filter set
broodnet mail inbox --unread --important --limit=20 --offset=20 --json
mail mark — set and clear flags
Mark messages as read, unread, flagged, or unflagged by UID without opening or deleting them. Accepts multiple UIDs in one call.
broodnet mail mark 1042 --seen
broodnet mail mark 10 11 12 --flagged
mail open — leaner JSON
The HTML body is no longer included in the default JSON output. If you need the full raw source, use --raw.