Skip to content

mxr modes

Generated from mxr modes --help. After editing crates/daemon/src/cli/, update and review the snapshots with scripts/cargo-test -p mxr --test integration cli_help::, then rebuild site/.

How each mode explains itself: its job, empty states, keys and hints

mxr modes [OPTIONS] <COMMAND>
Subcommand Purpose
seen Calm the exact To do or Updates revision you opened. Get the row id, account_id and seen_revision from todo or updates --format json
explain What a mode is for, what lands there, how it works, its keys and its hints. Every mode that has shipped when none is named
hint Dismiss a hint in every client, as Esc or acting on its element does, or bring it back with –show. mxr modes explain lists the ids
rail The rail: Now, the five modes and Inbox, with each one’s key and count, which are early versions, and the pages under More
why Which modes hold a conversation, and why
done Done here: the conversations leave one mode until someone writes again (in To do, their open to-dos are ticked off, or only those named with –todo). When no other mode holds a conversation it is archived at your provider too, unless modes.archive_on_last_done is off. Prints what happened and an undo id for mxr undo
help Print this message or the help of the given subcommand(s)
Flag Description
--format <FORMAT> [possible values: table, json, jsonl, csv, ids]
-h, --help Print help

Look up a mode’s purpose, keys and hints, inspect overlapping membership, or preview finishing a conversation in one mode. See email modes.

Terminal window
mxr modes explain
mxr modes explain todo --format json
mxr modes rail --format json
mxr modes why MESSAGE_ID --format json
mxr modes done THREAD_ID --mode messages --dry-run
mxr modes done THREAD_ID --mode messages
mxr modes hint todo.runway --show

Done here: the conversations leave one mode until someone writes again (in To do, their open to-dos are ticked off, or only those named with –todo). When no other mode holds a conversation it is archived at your provider too, unless modes.archive_on_last_done is off. Prints what happened and an undo id for mxr undo

mxr modes done [OPTIONS] --mode <MODE> [THREAD_IDS]...
Flag Description
[THREAD_IDS] … Thread ids, as mxr now --format ids prints them
Flag Description
--mode <MODE> The mode to be done in: messages, todo, updates or reading
--todo <TODO_ID> To do only: tick off just this to-do (repeat for more)
--sender <EMAIL> Updates or Reading: every conversation of this sender’s there
--account <ACCOUNT_ID> The sender’s account, with –sender
--dry-run Show what done would change without changing anything
--format <FORMAT> [possible values: table, json, jsonl, csv, ids]
-h, --help Print help

What a mode is for, what lands there, how it works, its keys and its hints. Every mode that has shipped when none is named

mxr modes explain [OPTIONS] [MODE]
Flag Description
[MODE] The mode, such as todo
Flag Description
--format <FORMAT> [possible values: table, json, jsonl, csv, ids]
-h, --help Print help

Dismiss a hint in every client, as Esc or acting on its element does, or bring it back with –show. mxr modes explain lists the ids

mxr modes hint [OPTIONS] <ID>
Flag Description
<ID> The hint id, such as todo.runway
Flag Description
--show Show the hint again the next time its element is needed
--format <FORMAT> [possible values: table, json, jsonl, csv, ids]
-h, --help Print help

The rail: Now, the five modes and Inbox, with each one’s key and count, which are early versions, and the pages under More

mxr modes rail [OPTIONS]
Flag Description
--account <ACCOUNT> Limit to one account; the default covers every account
--format <FORMAT> [possible values: table, json, jsonl, csv, ids]
-h, --help Print help

Calm the exact To do or Updates revision you opened. Get the row id, account_id and seen_revision from todo or updates --format json

mxr modes seen [OPTIONS] --account <ACCOUNT> --revision <REVISION> <MODE> <ROW_ID>
Flag Description
<MODE> [possible values: todo, updates]
<ROW_ID>
Flag Description
--account <ACCOUNT>
--revision <REVISION>
--dry-run
--format <FORMAT> [possible values: table, json, jsonl, csv, ids]
-h, --help Print help

Which modes hold a conversation, and why

mxr modes why [OPTIONS] [MESSAGE_ID]
Flag Description
[MESSAGE_ID] A message in the conversation
Flag Description
--thread <THREAD_ID> The conversation’s thread id instead
--format <FORMAT> [possible values: table, json, jsonl, csv, ids]
-h, --help Print help