Skip to content
mxr

mxr messages

Generated from mxr messages --help. Edit the clap definitions in crates/daemon/src/cli/ and re-run npm run build in site/ to regenerate.

People you talk with, one row each. Reply or mark done.

Four bands: Your turn (their latest message to you is unanswered; closest people first, then whoever has waited longest past your usual pace), Pinned, Recent and Quiet. Each row is a person, merged across their addresses, with your conversations inside as topics; a group thread is its own row. A thread you were only copied on goes to Updates. The preview is what they asked, from the conversation’s gist when one is cached, else what they wrote last.

mxr messages [OPTIONS] [COMMAND]

Subcommands

Section titled “Subcommands”
Subcommand Purpose
list The bands (the default)
person One person’s page: how you know them, every topic, and the selected topic as a conversation of what each message newly says [alias: show]
ack Got it: reply with a short acknowledgement in your usual greeting and sign-off for that person. –dry-run prints the exact text
merge Make several addresses one person, by hand. mxr only ever suggests a merge (same name, you’ve written to both); –suggestions lists them
split Take an address back out of the person it was merged into
help Print this message or the help of the given subcommand(s)

Options

Section titled “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 (see a summary with ‘-h’)

Use When

Section titled “Use When”

People you talk with, one row each, with your conversations inside as topics: Your turn, Pinned, Recent and Quiet. person shows one person’s page with each message’s new text; ack sends Got it (preview with --dry-run); merge makes several addresses one person, by hand. See Messages.

Everyday Examples

Section titled “Everyday Examples”
Terminal window
mxr messages --turn mine
mxr messages --format json | jq -r '.your_turn[] | .title'
mxr messages person samir@launchpad.example
mxr messages ack THREAD_ID --dry-run
mxr messages merge --suggestions

Sub-subcommands

Section titled “Sub-subcommands”

mxr messages ack

Section titled “mxr messages ack”

Got it: reply with a short acknowledgement in your usual greeting and sign-off for that person. –dry-run prints the exact text

mxr messages ack [OPTIONS] <THREAD_ID>

Arguments

Section titled “Arguments”
Flag Description
<THREAD_ID> The conversation’s thread id

Options

Section titled “Options”
Flag Description
--dry-run Print the exact text without sending 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

mxr messages list

Section titled “mxr messages list”

The bands (the default)

mxr messages list [OPTIONS]

Options

Section titled “Options”
Flag Description
--turn <TURN> Only rows where it is this side’s turn Possible values: - mine: Your turn - theirs: Waiting on them
--limit <LIMIT> Rows to list in Recent and Quiet; totals count them all [default: 50]
--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’)

mxr messages merge

Section titled “mxr messages merge”

Make several addresses one person, by hand. mxr only ever suggests a merge (same name, you’ve written to both); –suggestions lists them

mxr messages merge [OPTIONS] [INTO] [ADDRESSES]...

Arguments

Section titled “Arguments”
Flag Description
[INTO] The person’s main address
[ADDRESSES] … Addresses to merge in

Options

Section titled “Options”
Flag Description
--suggestions List the merges mxr suggests instead
--dry-run Show the person it would make 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

mxr messages person

Section titled “mxr messages person”

One person’s page: how you know them, every topic, and the selected topic as a conversation of what each message newly says

mxr messages person [OPTIONS] <PERSON>

Arguments

Section titled “Arguments”
Flag Description
<PERSON> An address, or a row id from mxr messages --format ids

Options

Section titled “Options”
Flag Description
--topic <THREAD_ID> The conversation to show, by thread id. Defaults to the one whose turn it is, else the latest
--account <ACCOUNT> Limit to one account; the default covers every account
--format <FORMAT> [possible values: table, json, jsonl, csv, ids]
-h, --help Print help

mxr messages split

Section titled “mxr messages split”

Take an address back out of the person it was merged into

mxr messages split [OPTIONS] <ADDRESS>

Arguments

Section titled “Arguments”
Flag Description
<ADDRESS>

Options

Section titled “Options”
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

See also

Section titled “See also”

MIT ORApache-2.0, at your option.