Skip to content
mxr

mxr draft-assist

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

Generate a draft reply for a thread, grounded on the thread context plus the user’s instruction. Output goes to stdout — pipe it into $EDITOR or your scratch buffer. Never auto-sends. Two equivalent forms:

  • mxr draft-assist THREAD_ID "decline politely" (legacy positional) - mxr draft-assist --search 'from:acme' --first --instruct "..." (search)

The instruction can be a positional second argument OR provided via --instruct — pick whichever composes better. --search requires --instruct.

mxr draft-assist [OPTIONS] [THREAD_ID] [INSTRUCTION]

Arguments

Section titled “Arguments”
FlagDescription
[THREAD_ID]Thread ID to reply to
[INSTRUCTION]Plain-language instruction (e.g. "decline politely"). Required unless --instruct is provided

Options

Section titled “Options”
FlagDescription
--search <SEARCH>Resolve target thread by query instead of a positional ID
--firstUse only the most recent matching thread
--limit <LIMIT>Cap the number of threads drafted for when —search is used
--instruct <TEXT>Long form of the positional instruction. Required when --search is used (no positional fallback)
--format <FORMAT>[possible values: table, json, jsonl, csv, ids]
-h, --helpPrint help (see a summary with ‘-h’)

Use When

Section titled “Use When”

Generate a draft body grounded in a thread, then review before sending.

Everyday Examples

Section titled “Everyday Examples”
Terminal window
mxr draft-assist THREAD_ID 'Polite follow-up with next steps'
mxr draft-assist --search 'from:sarah newer_than:14d' --first '1:1 agenda'

See also

Section titled “See also”