Skip to content

mxr attachments

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

Manage message attachments

mxr attachments <COMMAND>
Subcommand Purpose
inline-bytes Read a bounded inline-image chunk as JSON, without a host cache path
list List attachments for one message, or for every match of a --search QUERY. Multi-message output prefixes each section with --- MESSAGE_ID ---
download Download attachment(s)
open Open attachment with system handler
help Print this message or the help of the given subcommand(s)
Flag Description
-h, --help Print help

List or download message attachments to this client. Read a bounded, base64-encoded inline-image chunk with inline-bytes; the host cache path is never returned.

Terminal window
mxr attachments list MESSAGE_ID
mxr attachments download MESSAGE_ID 1 --dir ~/Downloads/mxr
mxr attachments inline-bytes MESSAGE_ID --source cid:logo@example.com --offset 0 --length 65536 --format json

Download attachment(s)

mxr attachments download [OPTIONS] <MESSAGE_ID> [INDEX]
Flag Description
<MESSAGE_ID>
[INDEX] Attachment index (1-based, omit for all)
Flag Description
--account <ACCOUNT>
--dir <DIR> Output directory
--format <FORMAT> Output format for completed local paths [possible values: table, json, jsonl, csv, ids]
-h, --help Print help

Read a bounded inline-image chunk as JSON, without a host cache path

mxr attachments inline-bytes [OPTIONS] --source <SOURCE> <MESSAGE_ID>
Flag Description
<MESSAGE_ID>
Flag Description
--source <SOURCE>
--offset <OFFSET> [default: 0]
--length <LENGTH> [default: 262144]
--format <FORMAT> [possible values: table, json, jsonl, csv, ids]
-h, --help Print help

List attachments for one message, or for every match of a --search QUERY. Multi-message output prefixes each section with --- MESSAGE_ID ---

mxr attachments list [OPTIONS] [MESSAGE_ID]
Flag Description
[MESSAGE_ID]
Flag Description
--search <SEARCH>
--account <ACCOUNT>
--first
--limit <LIMIT>
--format <FORMAT> [possible values: table, json, jsonl, csv, ids]
-h, --help Print help

Open attachment with system handler

mxr attachments open [OPTIONS] <MESSAGE_ID> <INDEX>
Flag Description
<MESSAGE_ID>
<INDEX> Attachment index (1-based)
Flag Description
--account <ACCOUNT>
--format <FORMAT> Output format for the local file [possible values: table, json, jsonl, csv, ids]
-h, --help Print help