mxr label
Generated from
mxr label --help. After editingcrates/daemon/src/cli/, update and review the snapshots withscripts/cargo-test -p mxr --test integration cli_help::, then rebuildsite/.
Apply a label to a message
mxr label [OPTIONS] <NAME> [MESSAGE_ID]...Arguments
Section titled “Arguments”| Flag | Description |
|---|---|
<NAME> |
Label name |
[MESSAGE_ID] |
… Message ID(s). If omitted, reads IDs from stdin when stdin is piped |
Options
Section titled “Options”| Flag | Description |
|---|---|
--search <SEARCH> |
|
--account <ACCOUNT> |
|
--yes |
|
--dry-run |
|
--async |
Run as a daemon-side background job and poll with mxr jobs |
--all |
Act on every message the search matches, not only the newest 1,000. The daemon resolves the whole set, so the exact count is shown before anything changes, and runs it as one background job that this command waits for. An –all job cannot be undone: preview it with –dry-run first, since the preview is the check |
--no-wait |
With –all, return once the daemon has accepted the job instead of waiting for it. Follow it with mxr jobs <JOB_ID> |
--preview-token <TOKEN> |
With –all, run exactly the messages an earlier --all --dry-run counted (its preview_token; valid for 10 minutes, once) |
--format <FORMAT> |
[possible values: table, json, jsonl, csv, ids] |
-h, --help |
Print help |
Use When
Section titled “Use When”Apply a label/folder to messages, including piped IDs from search.
Everyday Examples
Section titled “Everyday Examples”mxr label receipts MESSAGE_IDmxr search 'from:billing@example.com' --format ids | mxr label receipts --yesSee also
Section titled “See also”- CLI overview: full command index
- Concepts: query operators, search modes, JSON shapes
- Automation contract: which commands support
--format json,--dry-run, stdin