Skip to content
mxr

mxr drafts

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

Manage drafts: list (default), recover orphaned in-flight sends, resume one for retry, edit, delete, or sync drafts with a provider

mxr drafts [OPTIONS] [COMMAND]

Subcommands

Section titled “Subcommands”
Subcommand Purpose
list Show all drafts (default if no subcommand)
recover Show drafts that look orphaned mid-send (status 'sending', stale heartbeat). The startup loop already auto-resets these after 1h; this surfaces them earlier so you can act now
resume Force-reset an orphaned draft to 'draft' status so it can be re-sent via the normal pipeline. No-op if the draft is already in 'draft'
delete Permanently delete a draft and its linked provider draft, if present. discard remains as an alias for compatibility with earlier releases [alias: discard]
push Link a local draft to the account’s provider draft mailbox. The first push creates it; later edits and pushes update the same provider draft
edit Open an existing draft in $EDITOR and re-save it in place under the same draft id. No new draft is created and nothing is discarded
help Print this message or the help of the given subcommand(s)

Options

Section titled “Options”
Flag Description
--account <ACCOUNT> —
--format <FORMAT> [possible values: table, json, jsonl, csv, ids]
-h, --help Print help

Use When

Section titled “Use When”

List and edit drafts, preview linked deletion, or create/update one linked provider draft.

Everyday Examples

Section titled “Everyday Examples”
Terminal window
mxr drafts --format json
mxr drafts delete DRAFT_ID --dry-run
mxr drafts push DRAFT_ID --dry-run

Sub-subcommands

Section titled “Sub-subcommands”

mxr drafts delete

Section titled “mxr drafts delete”

Permanently delete a draft and its linked provider draft, if present. discard remains as an alias for compatibility with earlier releases

mxr drafts delete [OPTIONS] <DRAFT_ID>

Arguments

Section titled “Arguments”
Flag Description
<DRAFT_ID> Draft ID to delete

Options

Section titled “Options”
Flag Description
--dry-run Show the exact draft that would be deleted without deleting it
-h, --help Print help

mxr drafts discard

Section titled “mxr drafts discard”

Permanently delete a draft and its linked provider draft, if present. discard remains as an alias for compatibility with earlier releases

mxr drafts delete [OPTIONS] <DRAFT_ID>

Arguments

Section titled “Arguments”
Flag Description
<DRAFT_ID> Draft ID to delete

Options

Section titled “Options”
Flag Description
--dry-run Show the exact draft that would be deleted without deleting it
-h, --help Print help

mxr drafts edit

Section titled “mxr drafts edit”

Open an existing draft in $EDITOR and re-save it in place under the same draft id. No new draft is created and nothing is discarded

mxr drafts edit <DRAFT_ID>

Arguments

Section titled “Arguments”
Flag Description
<DRAFT_ID> Draft ID to edit

Options

Section titled “Options”
Flag Description
-h, --help Print help

mxr drafts list

Section titled “mxr drafts list”

Show all drafts (default if no subcommand)

mxr drafts list

Options

Section titled “Options”
Flag Description
-h, --help Print help

mxr drafts push

Section titled “mxr drafts push”

Link a local draft to the account’s provider draft mailbox. The first push creates it; later edits and pushes update the same provider draft

mxr drafts push [OPTIONS] <DRAFT_ID>

Arguments

Section titled “Arguments”
Flag Description
<DRAFT_ID> Local draft ID to link or update at the provider

Options

Section titled “Options”
Flag Description
--dry-run Show the exact draft and provider without creating or updating it
-h, --help Print help

mxr drafts recover

Section titled “mxr drafts recover”

Show drafts that look orphaned mid-send (status 'sending', stale heartbeat). The startup loop already auto-resets these after 1h; this surfaces them earlier so you can act now

mxr drafts recover

Options

Section titled “Options”
Flag Description
-h, --help Print help

mxr drafts resume

Section titled “mxr drafts resume”

Force-reset an orphaned draft to 'draft' status so it can be re-sent via the normal pipeline. No-op if the draft is already in 'draft'

mxr drafts resume <DRAFT_ID>

Arguments

Section titled “Arguments”
Flag Description
<DRAFT_ID> Draft ID to resume

Options

Section titled “Options”
Flag Description
-h, --help Print help

See also

Section titled “See also”

MIT ORApache-2.0, at your option.