Generated from mxr todo --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/.
Things email asked you to do, ordered by when to act.
Each row is one thing to do, written as what to do rather than the email’s subject (“Pay council tax”), with who it’s for, how much, when to act and when it’s due. A row shows up on the day you should start on it: a bill three days before it’s due, a renewal two weeks before, a verify link at once. Bills, failed payments, renewals, sign and verify requests, invites and the promises you made land here. A payment collected by direct debit or card on file is not a to-do; a failed one is.
With no subcommand, prints the runway: Now, Coming up by week, Later, Whenever and Done this week.
mxr todo [OPTIONS] [COMMAND]
Subcommand
Purpose
microsoft
Link tasks with the optional ms-todo CLI and keep shared fields in sync
list
The runway (the default), or every row in one state
why
Where each field of a to-do came from: schema.org, a pattern in the email, the lead-time table, a model, or you
resolve
Review a later email’s resolution offer. Defaults to a read-only preview
done
Tick off to-dos
undo
Reopen to-dos you ticked off, marked not a to-do, or that expired. A reopened row is yours: it never expires again
dismiss
Not a to-do: kept as a correction and never shown again
correct
Record one of four durable correction reasons
undo-correction
Undo a correction using its returned token, preserving newer edits
snooze
Show a to-do on your own date (“mon 9am”, “in 3d”, “fri”). The due date stays as it is
edit
Correct a to-do: title, due, amount, counterparty or kind, as field=value. The row is yours from then on
add
Add a to-do from a message yourself
catchup
The first run’s one-time catch-up: things from before mxr sorted your mail that might still need you. Keep or let go of each
help
Print this message or the help of the given subcommand(s)
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 (see a summary with ‘-h’)
Act on tasks by their act-by dates, add or correct a task from mail, and review older work in the first-run catch-up. Preview changes before applying them. See To do and later-evidence review .
mxr todo add --from MESSAGE_ID --title " Send the signed form " --due " in 2d " --dry-run
mxr todo edit TODO_ID " due=in 3d " --dry-run
mxr todo correct TODO_ID not-mine --dry-run --format json
mxr todo correct TODO_ID not-mine --format json
mxr todo undo-correction TODO_ID CORRECTION_ID --dry-run --format json
mxr todo catchup --format json
mxr todo catchup --keep TODO_ID --dry-run
mxr todo done TODO_ID --dry-run
Add a to-do from a message yourself
mxr todo add [OPTIONS] --from <MESSAGE_ID> --title <TITLE>
Flag
Description
--from <MESSAGE_ID>
The message it’s about
--title <TITLE>
What to do, starting with the verb: “Send the signed form”
--due <DUE>
When it’s due: “fri”, “9 oct”, “in 2w”
--kind <KIND>
bill, renewal, sign, rsvp, promise, other, … (default other)
--dry-run
--account <ACCOUNT>
Limit to one account; the default covers every account
--format <FORMAT>
[possible values: table, json, jsonl, csv, ids]
-h, --help
Print help
The first run’s one-time catch-up: things from before mxr sorted your mail that might still need you. Keep or let go of each
mxr todo catchup [OPTIONS]
Flag
Description
--keep <TODO_ID>
… Keep these: they join the runway and are yours from then on
--let-go <TODO_ID>
… Let go of these: they join the Expired list
--let-go-all
Let go of everything still in the catch-up
--undecide <TODO_ID>
… Put rows you kept or let go back in the catch-up, undecided
--dry-run
Show what would change without changing anything
--account <ACCOUNT>
Limit to one account; the default covers every account
--format <FORMAT>
[possible values: table, json, jsonl, csv, ids]
-h, --help
Print help
Record one of four durable correction reasons
mxr todo correct [OPTIONS] <TODO_ID> <REASON> [FIELD=VALUE]...
Flag
Description
<TODO_ID>
<REASON>
[possible values: not-a-todo, not-mine, already-done, wrong-details]
[FIELD
=VALUE]…
Flag
Description
--dry-run
--account <ACCOUNT>
Limit to one account; the default covers every account
--format <FORMAT>
[possible values: table, json, jsonl, csv, ids]
-h, --help
Print help
Not a to-do: kept as a correction and never shown again
mxr todo dismiss [OPTIONS] <TODO_ID>...
Flag
Description
<TODO_ID>
…
Flag
Description
--dry-run
--account <ACCOUNT>
Limit to one account; the default covers every account
--format <FORMAT>
[possible values: table, json, jsonl, csv, ids]
-h, --help
Print help
Tick off to-dos
mxr todo done [OPTIONS] <TODO_ID>...
Flag
Description
<TODO_ID>
…
Flag
Description
--dry-run
Show what would change without changing anything
--account <ACCOUNT>
Limit to one account; the default covers every account
--format <FORMAT>
[possible values: table, json, jsonl, csv, ids]
-h, --help
Print help
Correct a to-do: title, due, amount, counterparty or kind, as field=value. The row is yours from then on
mxr todo edit [OPTIONS] <TODO_ID> <FIELD=VALUE>...
Flag
Description
<TODO_ID>
<FIELD
=VALUE>…
Flag
Description
--dry-run
--account <ACCOUNT>
Limit to one account; the default covers every account
--format <FORMAT>
[possible values: table, json, jsonl, csv, ids]
-h, --help
Print help
The runway (the default), or every row in one state
Flag
Description
--expired
The Expired list: rows past their window or let go. Undo restores one
--state <STATE>
Every row in this state instead of the runway [possible values: open, done, dismissed, expired]
--limit <LIMIT>
Rows to list with –expired or –state [default: 200]
--account <ACCOUNT>
Limit to one account; the default covers every account
--format <FORMAT>
[possible values: table, json, jsonl, csv, ids]
-h, --help
Print help
Link tasks with the optional ms-todo CLI and keep shared fields in sync
mxr todo microsoft [OPTIONS] <COMMAND>
Subcommand
Purpose
status
Whether ms-todo is installed on the machine running the daemon
link
Create a Microsoft task and link title, due date, schedule and status both ways
sync
Reconcile one linked task, or all links. Conflicting edits are preserved for review
help
Print this message or the help of the given subcommand(s)
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
Create a Microsoft task and link title, due date, schedule and status both ways
mxr todo microsoft link [OPTIONS] <TODO_ID>
Flag
Description
<TODO_ID>
Flag
Description
--fingerprint <FINGERPRINT>
The fingerprint from the exact –dry-run preview you reviewed
--dry-run
Show the exact link and shared fields without running ms-todo
--account <ACCOUNT>
Limit to one account; the default covers every account
--format <FORMAT>
[possible values: table, json, jsonl, csv, ids]
-h, --help
Print help
Whether ms-todo is installed on the machine running the daemon
mxr todo microsoft status [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
Reconcile one linked task, or all links. Conflicting edits are preserved for review
mxr todo microsoft sync [OPTIONS] [TODO_ID]
Flag
Description
[TODO_ID]
Flag
Description
--dry-run
Read the cached Microsoft task and show changes without applying them
--account <ACCOUNT>
Limit to one account; the default covers every account
--format <FORMAT>
[possible values: table, json, jsonl, csv, ids]
-h, --help
Print help
Review a later email’s resolution offer. Defaults to a read-only preview
mxr todo resolve [OPTIONS] <TODO_ID> <SUGGESTION_ID> [ACTION]
Flag
Description
<TODO_ID>
<SUGGESTION_ID>
[ACTION]
[default: preview] [possible values: preview, accept, dismiss, undo]
Flag
Description
--dry-run
Validate the selected action without applying it
--account <ACCOUNT>
Limit to one account; the default covers every account
--format <FORMAT>
[possible values: table, json, jsonl, csv, ids]
-h, --help
Print help
Show a to-do on your own date (“mon 9am”, “in 3d”, “fri”). The due date stays as it is
mxr todo snooze [OPTIONS] <TODO_ID> [WHEN]...
Flag
Description
<TODO_ID>
[WHEN]
… When it should show up
Flag
Description
--clear
Go back to the date mxr worked out
--dry-run
--account <ACCOUNT>
Limit to one account; the default covers every account
--format <FORMAT>
[possible values: table, json, jsonl, csv, ids]
-h, --help
Print help
Reopen to-dos you ticked off, marked not a to-do, or that expired. A reopened row is yours: it never expires again
mxr todo undo [OPTIONS] <TODO_ID>...
Flag
Description
<TODO_ID>
…
Flag
Description
--dry-run
--account <ACCOUNT>
Limit to one account; the default covers every account
--format <FORMAT>
[possible values: table, json, jsonl, csv, ids]
-h, --help
Print help
Undo a correction using its returned token, preserving newer edits
mxr todo undo-correction [OPTIONS] <TODO_ID> <CORRECTION_ID>
Flag
Description
<TODO_ID>
<CORRECTION_ID>
Flag
Description
--dry-run
--account <ACCOUNT>
Limit to one account; the default covers every account
--format <FORMAT>
[possible values: table, json, jsonl, csv, ids]
-h, --help
Print help
Where each field of a to-do came from: schema.org, a pattern in the email, the lead-time table, a model, or you
mxr todo why [OPTIONS] <TODO_ID>
Flag
Description
<TODO_ID>
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