Skip to content

quox mail

Documented Checked against the CLI's current help and source. Not run end to end. CLI 0.3.1, checked 2026-10-13.

All commands

InboxQ: connected mail accounts, triaged messages, zones, sync, reports, watches, proposals

CommandWhat it does
quox mail accountsList connected mail accounts
quox mail connect [options]Connect a mailbox. Reuse a stored credential (--credential), or create one inline from IMAP settings (--imap-host with --password-env, or --provider gmail|icloud|outlook to pre-fill host/port). Creating a credential needs a human/admin profile, e.g. quox -p moo mail connect …
quox mail import [options] <csvFile>Batch-import mailboxes from a CSV. Header columns (case-insensitive): email (required), imap_host (required), imap_port, smtp_host, smtp_port, username, password_env OR password, label, name, folders (semicolon-separated). One credential + account is created per row. Needs a SECRETS_WRITE profile, e.g. quox -p moo mail import boxes.csv. A file with a password column is a secret: chmod 600 it.
quox mail disconnect <accountId>Disconnect a mail account
quox mail sync <accountId>Sync a mail account now (fetch new messages, run triage)
quox mail list [options]List triaged messages
quox mail zones [options]Show zone counts (focus, fyi, auto, screened)
quox mail report [options] <accountId>Show the latest triage report, or generate a fresh one
quox mail watchManage standing watches (label + match rules)
quox mail propose [options]Create a proposal (file, block or draft) for an account
quox mail proposals [options]List proposals
quox mail resolve [options] <proposalId>Approve or deny a proposal
quox mail moves [options]List recent undoable moves (most recent first)
quox mail undo <moveId>Undo a recorded move: reverse the IMAP move back to its source folder