Skip to content

mxr todo

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.

Terminal window
mxr todo --format json
mxr todo why TODO_ID
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
mxr todo done TODO_ID

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

mxr todo list [OPTIONS]
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