magic-meal-kits MMK Plaud — File Commands
Prerequisite: Read
../mmk-shared/SKILL.mdfor auth, global flags, and error handling. Parent:mmk-plaud— includes credential overrides and requirements.
Always use -o json when parsing results or composing with other commands.
list — List recordings (compose transcripts/summaries)
mmk plaud file list --limit 10 -o json
mmk plaud file list --with transcripts,summaries --limit 25 -o json
mmk plaud file list --sort start_time --asc --trash active -o json
Required: none
Optional:
| Flag | Default | Description |
|---|---|---|
--limit |
20 |
Max files to return (server caps at 99999) |
--skip |
0 |
Offset for pagination |
--sort |
edit_time |
Sort field: edit_time or start_time |
--asc |
(descending) | Sort ascending |
--trash |
active |
Filter: active, trash, or all |
--with |
Compose attachments: comma list of transcripts, summaries, shares, audio-urls |
|
--concurrency |
4 |
Max concurrent attachment fetches per file (1–8); only with --with |
--since |
0 |
Only files with start_time >= this epoch-ms (only with --with) |
--strict |
Fail-fast on any attachment error (only with --with) |
get — Get file detail (compose transcript/summary)
mmk plaud file get <file_id> -o json
mmk plaud file get <file_id> --with transcripts,summaries -o json
Required: <file_id> (positional)
Optional:
| Flag | Description |
|---|---|
--with |
Compose attachments: comma list of transcripts, summaries, shares, audio-urls |
--strict |
Fail-fast on any attachment error (only with --with) |
audio-url — Get pre-signed audio URL (when available)
mmk plaud file audio-url <file_id> -o json
Required: <file_id> (positional)
download — Download the audio file to disk via the signed URL
mmk plaud file download <file_id>
mmk plaud file download <file_id> --out ./recordings/
mmk plaud file download <file_id> --out my-note.ogg --force
mmk plaud file download <file_id> --quiet
Required: <file_id> (positional)
Optional:
| Flag | Default | Description |
|---|---|---|
--out |
current directory (auto-named) | Output file or directory path |
--force |
false | Overwrite if the target file already exists |
--quiet |
false | Suppress progress output; print only the saved path |
Default filename: {file_name}.{ext} where file_name comes from the recording's metadata (non-filesystem-safe characters stripped) and ext is parsed from the signed URL path. Falls back to {file_id}.ogg when the name is empty.
The file is streamed directly from S3 to disk — the server only returns the signed URL and does not proxy the bytes.
transcript — Get decoded transcript JSON
mmk plaud file transcript <file_id> -o json
Required: <file_id> (positional)
summary — Get AI-generated summary (Markdown)
mmk plaud file summary <file_id> -o json
Required: <file_id> (positional)
Returns a Markdown summary as a string in the JSON payload.
tabs — List a note's content tabs
mmk plaud file tabs <file_id> -o json
Required: <file_id> (positional)
A Plaud note can carry several rendered views beyond the default summary — e.g. "Key Points", "Outline", "Mind Map", recording highlights, the raw transcript. Each row shows the tab type, display name, stable template selector, content format, and whether it's ready, plus the per-note tab ID used by tab --tab-id.
tab — Get one content tab
mmk plaud file tab <file_id> --template SUMMARY -o json
mmk plaud file tab <file_id> --template "Key Points" -o json
mmk plaud file tab <file_id> --tab-id source_outline:... -o json
Required: <file_id> (positional), one of --template or --tab-id
Optional:
| Flag | Description |
|---|---|
--template |
Stable template selector (e.g. SUMMARY, Key Points, Mind Map) — same across all notes |
--tab-id |
Per-note tab id from mmk plaud file tabs <file_id> |
Markdown tabs print as text; structured tabs (transcript, outline) print as JSON. Use -o json for the full envelope (tab_id, tab_name, format, content).
transsumm — Trigger auto transcript + summary (optionally wait)
mmk plaud file transsumm <file_id> -o json
mmk plaud file transsumm <file_id> --wait --timeout 120 -o json
mmk plaud file transsumm <file_id> --llm gemini-3.1-pro --language ko --no-diarization -o json
Required: <file_id> (positional)
Optional:
| Flag | Default | Description |
|---|---|---|
--wait |
false |
Poll until the task completes and print transcript + summary |
--timeout |
300 |
Server-side timeout in seconds (only with --wait) |
--poll-interval |
2 |
Server-side poll interval in seconds (only with --wait) |
--check-quota |
off / on with --wait |
Pre-check remaining seconds vs file duration |
--reload |
false |
Re-run transcription even if already transcribed |
--diarization |
true |
Enable speaker diarization (pass --diarization=false to disable) |
--language |
auto |
Transcription language (server picks if auto) |
--llm |
auto |
Summary LLM model (e.g. gpt-5.2, gemini-3.1-pro) |
--summ-type |
AUTO-SELECT |
Summary template id |
--timezone |
local offset | Timezone offset hours |
Without --wait the command returns task handles; with --wait it blocks until completion and returns the finished transcript + summary.
rename — Rename a Plaud recording
mmk plaud file rename <file_id> "Team standup 2026-04-14" -o json
Required: <file_id> (positional), new name (positional)
organize — Put recordings into a folder (creates the folder if missing)
mmk plaud file organize --files f1,f2 --into "Interviews" -o json
mmk plaud file organize --files f1 --into "Q2 Planning" --color "#fb5c5c" --icon e627 -o json
mmk plaud file organize --files f1,f2 --into "interviews" --match fold -o json
mmk plaud file organize --files f1 --into "Must Exist" --no-create -o json
Required: --files (comma-separated file IDs), --into (target folder name)
Optional:
| Flag | Default | Description |
|---|---|---|
--match |
exact |
Tag name match mode: exact or fold (case/unicode-insensitive) |
--no-create |
Fail instead of creating a missing folder (useful for strict automation) | |
--color |
Color for the new folder if it has to be created | |
--icon |
Icon glyph for the new folder if it has to be created |
Prefer organize over mmk plaud admin tag … primitives — it finds-or-creates the tag and assigns files in one call.
trash — Move one or more notes to trash (soft-delete, recoverable)
mmk plaud file trash --files 9eb5d6e8b... -o json
mmk plaud file trash --files f1,f2,f3 -o json
Required: --files (comma-separated file IDs to move to trash)
Soft-delete: notes are moved to trash and remain recoverable. Trashed notes can still be listed with mmk plaud file list --trash trash (or --trash all).
See Also
- mmk-shared — Auth, global flags, error handling
- mmk-plaud — All Plaud commands overview, credential overrides
- mmk-plaud-search — Search transcripts and filenames
- mmk-plaud-admin — Low-level passthroughs (AI status, tag primitives, file share/ack-pull)