mxr search

Generated from mxr search --help. Edit the clap definitions in crates/daemon/src/cli/ and re-run npm run build in site/ to regenerate.

Search messages

mxr search [OPTIONS] [QUERY]

Arguments

Flag	Description
[QUERY]	—

Options

Flag	Description
--account <ACCOUNT>	—
--format <FORMAT>	[possible values: table, json, jsonl, csv, ids]
--limit <LIMIT>	[default: 50]
--offset <OFFSET>	Skip this many matching results before returning a page [default: 0]
--mode <MODE>	[possible values: lexical, hybrid, semantic]
--sort <SORT>	[possible values: date, relevance]
--group-by <GROUP_BY>	Aggregate the query result set by a field instead of listing messages [possible values: from, list, category]
--explain	—
--triage	Classify matching messages with cached ACTION/FYI/ROUTINE verdicts
-h, --help	Print help

Use When

Find messages fast, then pipe IDs or JSON into the next step.

Everyday Examples

mxr search 'from:alice is:unread' --format json
mxr search 'has:attachment subject:invoice' --format ids | mxr label receipts --dry-run
mxr search 'is:owed-reply' --format ids   # threads you're the bottleneck on

See also

• CLI overview — full command index
• Concepts — query operators, search modes, JSON shapes
• Automation contract — which commands support --format json, --dry-run, stdin