Skip to content

mxr commitments

Generated from mxr commitments --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/.

List, find, keep or resolve commitments: promises made in mail

mxr commitments [OPTIONS] [COMMAND]
Subcommand Purpose
resolve Mark a commitment resolved by id
add Keep a promise from a message you sent, due at a time, so it comes back when due. Adding it again moves the date
detect Find promises you made in a message you sent, with their due times
help Print this message or the help of the given subcommand(s)
Flag Description
--contact <CONTACT>
--status <STATUS> [possible values: open, resolved, expired]
--account <ACCOUNT>
--format <FORMAT> [possible values: table, json, jsonl, csv, ids]
-h, --help Print help

List, keep or resolve promises made in mail. detect finds the promises in a message you sent; add keeps one so it comes back under Due on the desk. See promises on send and the forgotten-work guide.

Terminal window
mxr commitments --status open --format json
mxr commitments detect SENT_MESSAGE_ID
mxr commitments add SENT_MESSAGE_ID --what 'send the deck' --due 'fri 9am' --dry-run
mxr commitments resolve COMMITMENT_ID

Keep a promise from a message you sent, due at a time, so it comes back when due. Adding it again moves the date

mxr commitments add [OPTIONS] --what <WHAT> --due <DUE> <MESSAGE_ID>
Flag Description
<MESSAGE_ID> The sent message the promise is in
Flag Description
--what <WHAT> What you promised, such as “send the deck”
--due <DUE> When it is due: “fri”, “tomorrow 9am”, “in 3d” or RFC3339
--dry-run Show what would be kept without storing it
--format <FORMAT> [possible values: table, json, jsonl, csv, ids]
-h, --help Print help

Find promises you made in a message you sent, with their due times

mxr commitments detect [OPTIONS] <MESSAGE_ID>
Flag Description
<MESSAGE_ID> The sent message to read
Flag Description
--format <FORMAT> [possible values: table, json, jsonl, csv, ids]
-h, --help Print help

Mark a commitment resolved by id

mxr commitments resolve <ID>
Flag Description
<ID>
Flag Description
-h, --help Print help