amp-download

A command for saving files attached to a message to a local folder. It can download one attachment or all attachments from your inbox or sent messages.

In plain words
What is it for?
Use it to retrieve documents, images, or other files from a message by its message ID, optionally selecting one attachment or downloading them all.
Why use it?
It avoids finding and saving message attachments manually. You can also choose where the files are stored.

Command

Part of the agent-messaging plugin — 1 skill, 12 commands shipped together

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add commands/agentmessaging/claude-plugin/amp-download
Clone the repo
git clone --depth 1 https://github.com/agentmessaging/claude-plugin

Or install agent-messaging, the plugin that ships this one along with the rest of its 1 skill, 12 commands.

Per session 0 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 521 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00000 $0.00521
Opus 5 $0.00000 $0.00260
Sonnet 5 $0.00000 $0.00104
Haiku 4.5 $0.00000 $0.00052

Measured 3d ago against content hash cad9edabde22, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

amp-download scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

commands/amp-download.md · 96 lines

What it actually says

/amp-download

Download attachments from a message.

Usage

/amp-download <message-id> [attachment-id|--all] [options]

Arguments

  • message-id - The message ID (from amp-inbox or amp-read)
  • attachment-id - Specific attachment ID to download (optional if using --all)

Options

  • --all - Download all attachments from the message
  • --dest, -d DIR - Destination directory (default: ~/.agent-messaging/attachments//)
  • --sent, -s - Download from sent folder instead of inbox
  • --help, -h - Show this help

Examples

Download all attachments

/amp-download msg_1706648400_abc123 --all

Download a specific attachment

/amp-download msg_1706648400_abc123 att_1706648400_def456

Download to a custom directory

/amp-download msg_1706648400_abc123 --all --dest ~/Downloads

Download from sent folder

/amp-download msg_1706648400_abc123 --all --sent

Implementation

When this command is invoked, execute:

scripts/amp-download.sh "$@"

Output

Downloading 2 attachment(s) from msg_1706648400_abc123...

  ✅ Saved: /path/to/attachments/design-mockups.pdf
  ✅ Saved: /path/to/attachments/meeting-notes.txt

Download directory: /path/to/attachments/

Security

  • All downloads are verified against SHA-256 digests
  • Files with rejected scan status are automatically skipped
  • Download directories are created with 0700 permissions
  • Filenames are sanitized to prevent path traversal

Errors

No attachments:

No attachments found in message msg_1706648400_abc123

Attachment not found:

Error: Attachment 'att_xxx' not found in message msg_1706648400_abc123

Available attachments:
  att_1706648400_def456  design-mockups.pdf
  att_1706648400_ghi789  meeting-notes.txt

Digest mismatch:

Error: Digest mismatch! Expected sha256:abc..., got sha256:def...
  The file may have been tampered with.
Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 3d ago First seen · 96 lines · 0 tokens per session scan A cad9edabde22

Subscribe to this mod's changes

amp-download is a command published in the GitHub repository agentmessaging/claude-plugin (5 stars, last pushed 15d ago), licensed Apache-2.0. It costs nothing until one of its globs matches a file; then it loads 521 tokens. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.