Docs Guides
CLI reference
Drive the whole Podcli pipeline from your terminal. One command transcribes, picks moments, crops to the speaker, and burns captions in.
Everything the studio does is available from the terminal. The one command you need most:
That transcribes, picks the best moments, crops to the face, burns captions in, and writes upload-ready clips. Nothing leaves your machine.
Clip scoring uses Claude Code or Codex login, or an Anthropic API key. Without those it falls back to heuristics.
Headless#
Requires podcli 2.8.2 or later.
One JSON object on stdout: clip paths, durations, scores, titles, descriptions,
tags, caption files. Logs go to stderr. -y / --yes skips prompts.
NO_COLOR=1 or a non-TTY stdout turns off colour and spinners.
Exit codes: 0 success, 1 runtime or processing error, 2 usage, 130 interrupted.
--help and --version never download. First run of process, studio,
transcribe, or multicam provisions the engine. podcli mcp does not —
stdout is JSON-RPC — so run podcli setup first.
podcli doctor --json includes a provisioned map (backend, python,
studio, mcp, remotion, ffmpeg, whisper, node) next to version,
paths, and checks. Only a "fail" check makes the command exit 1. MCP
registration warnings do not.
Common flags#
Use an existing transcript instead of transcribing, and cap the clip count:
Set caption style, crop mode, and output format:
Force thumbnails on or off:
| Flag | What it does |
|---|---|
--transcript <file> | Use a .txt / .srt / .vtt transcript instead of transcribing. |
--top <n> | Cap the number of clips. |
--caption-style <style> | branded, hormozi, karaoke, or subtle. See captions and formats. |
--crop <mode> | center, face, or speaker. |
--format <ratio> | vertical (9:16), horizontal (16:9), or square (1:1). |
--logo <asset or file> | Overlay a logo on every clip. Accepts a registered asset name or a path. |
--intro <asset or file> | Prepend an intro video before every clip. |
--outro <asset or file> | Append an outro video after every clip. |
--thumbnails / --no-thumbnails | Force thumbnail generation on or off. |
Logo, intro, and outro all accept a registered asset name (see Assets) or a direct file path. Leave them off to use whatever you've marked as the default asset.
Presets#
Save a set of render settings once and reuse it:
Assets#
Register logos, outros, intros, and music once, then reference them by name
anywhere. The same library backs the studio Assets page
and the manage_assets MCP tool.
Then use a name instead of a path:
Other actions: podcli assets rename <old> <new>, podcli assets undefault <name>, and podcli assets remove <name>.
Other commands#
podcli opens the interactive menu with Open Web UI. podcli ui opens the
studio directly at localhost:3847.
podcli setup provisions runtimes and models. podcli mcp does not, because
stdout is JSON-RPC — run setup first, then register the server.
podcli doctor prints resolved paths, the interpreter, backend, ffmpeg, and
models. --json writes that as one object, including a provisioned map;
see Headless.
podcli uninstall removes all managed data by default. Run it with --dry-run
first to preview exactly what will be removed.