CLI Changelog

Last updated: 2026-04-23

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:

# 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:

# 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:

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

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)

Last updated: 2026-04-17

cli v0.2.2

Adds a new broodnet skill command for agent email operations, including sending emails and listing recent messages. This is the first step towards enabling agents to interact with email in a more autonomous way, without needing to shell out to broodnet mail commands.

Also enables sandboxed environments (e.g. CI systems, corporate networks) to use the CLI by adding support for environment variable overrides of config values and configuring a global HTTP proxy agent.

Implement skill command for agent email operations
Enhance mailbox status with health indicators
FIX: configure global ProxyAgent for HTTP proxy support
FIX: add support for environment variable overrides in config
FIX: update banner for ESM compatibility
update vite dependencies to latest versions

Last updated: 2026-04-01

cli v0.1.9

Add mailbox status command
Improve mailbox listing with custom name support
Improve Text/HTML body extraction for email messages
Update mailbox configuration handling

Last updated: 2026-03-29

update email dependency import and adjust workspace settings

Last updated: 2026-03-29

Add custom domain management feature

Last updated: 2026-03-24

Implement SMTP email sending functionality in CLI mailbox send command

Last updated: 2026-03-24

Add release draft and changelog generation scripts
Capitalize public Broodnet brand references

Last updated: 2026-03-18

Grouped Changes

CLI

feature(cli): add logout, ls, use, mail delete commands
release(cli): v0.1.3
Initial release