# Generated command reference

> Generated by `npm run docs:commands` from the v2 command registry. Do not edit manually.

| Command | Usage | Mutates | Summary |
|---|---|:---:|---|
| `info` | `capcut info <project>` | no | Project overview + material summary. |
| `version` | `capcut version <project>` | no | Detect CapCut/JianYing version, schema flags, and support status. |
| `lint` | `capcut lint <project> [options]` | no | Schema-aware checks (overlaps, line length, missing files); exit 0/1/2 for CI. |
| `tracks` | `capcut tracks <project>` | no | List all tracks. |
| `segments` | `capcut segments <project> [--track <type>]` | no | List segments with timing; filter by --track <type>. |
| `texts` | `capcut texts <project>` | no | List all text/subtitle content. |
| `set-text` | `capcut set-text <project> <id> <text>` | yes | Change a text segment's content. |
| `shift` | `capcut shift <project> <id> <offset>` | yes | Shift one segment's timing by an offset (e.g. +0.5s). |
| `shift-all` | `capcut shift-all <project> <offset> [--track <type>]` | yes | Shift all segments (optionally on one --track) by an offset. |
| `speed` | `capcut speed <project> <id> <multiplier>` | yes | Set a segment's playback speed. |
| `volume` | `capcut volume <project> <id> <level>` | yes | Set a segment's volume (0.0-1.0). |
| `trim` | `capcut trim <project> <id> <start> <duration>` | yes | Trim a segment to a start/duration window. |
| `opacity` | `capcut opacity <project> <id> <alpha>` | yes | Set a segment's opacity (0.0-1.0). |
| `export-srt` | `capcut export-srt <project> [options]` | no | Export subtitles to SRT or WebVTT on stdout, per line or per word. |
| `export-timeline` | `capcut export-timeline <project> [--out <file.otio>]` | no | Export video/audio tracks as OpenTimelineIO JSON for NLE handoff (DaVinci Resolve imports .otio natively). |
| `materials` | `capcut materials <project> [--type <type>]` | no | List material types and counts; filter with --type. |
| `segment` | `capcut segment <project> <id>` | no | Full detail for one segment and its material. |
| `material` | `capcut material <project> <id>` | no | Full detail for one material. |
| `add-audio` | `capcut add-audio <project> <file-or-url> <start> [duration] [options]` | yes | Add a local or Wikimedia audio file on an audio track. |
| `add-video` | `capcut add-video <project> <file-or-url> <start> [duration] [options]` | yes | Add a local or Wikimedia video/image on a video track. |
| `add-text` | `capcut add-text <project> <start> <duration> <text> [options]` | yes | Add a text segment with font/color/position options. |
| `crop` | `capcut crop <project> <segment-id> [--ratio <r> \| --rect <x,y,w,h> \| --reset]` | yes | Read or set a video/photo segment's source-material crop (--ratio preset, --rect x,y,w,h, or --reset). |
| `cut` | `capcut cut <project> <start> <end> --out <path>` | yes | Extract a time range into a new standalone draft. |
| `duplicate` | `capcut duplicate <project> <segment-id> [--track <track-name>] [--new-track]` | yes | Duplicate a segment at its same timeline position onto a track above the source. |
| `remove` | `capcut remove <project> <segment-id> [--keep-track] [--keep-materials]` | yes | Remove a segment, its emptied track, and the materials that orphans. |
| `keyframe` | `capcut keyframe <project> <id> <property> <time> <value> [--easing <name>] \| --batch` | yes | Add a keyframe (position/scale/rotation/alpha/volume); single or --batch. |
| `transition` | `capcut transition <project> <id> <slug> [--duration <time>]` | yes | Add a transition between segments. |
| `mask` | `capcut mask <project> <id> <slug> [options] \| --off` | yes | Apply a mask (linear/circle/heart/...) with geometry flags, or --off. |
| `bg-blur` | `capcut bg-blur <project> <id> <level> \| --off` | yes | Set background blur level 1-4, or --off. |
| `text-style` | `capcut text-style <project> <id> [options]` | yes | Style text (alpha/shadow/border/background box). |
| `text-anim` | `capcut text-anim <project> <id> [options]` | yes | Add intro/outro/combo text animation. |
| `image-anim` | `capcut image-anim <project> <id> [options]` | yes | Add intro/outro/combo animation to an image/video segment. |
| `add-sticker` | `capcut add-sticker <project> <resource-id> <start> <duration> [options]` | yes | Add a sticker on its own track with transform. |
| `mix-mode` | `capcut mix-mode <project> <id> <mode>` | yes | Set a video segment's blend mode. |
| `audio-fade` | `capcut audio-fade <project> <id> [--in <seconds>] [--fade-out <seconds>]` | yes | Add fade-in/fade-out to an audio segment (--in / --fade-out). |
| `add-cover` | `capcut add-cover <project> <image> [--time <milliseconds>]` | yes | Set the project cover/thumbnail from a local image. |
| `add-filter` | `capcut add-filter <project> <slug-or-name> (<start> <duration> \| --full) [options]` | yes | Add a colour filter on its own track. |
| `bubble-text` | `capcut bubble-text <project> <id> --bubble <slug>` | yes | Apply a speech-bubble shape to a text segment. |
| `add-effect` | `capcut add-effect <project> <slug-or-name> (<start> <duration> \| --full) [options]` | yes | Add a scene effect on its own track. |
| `save-template` | `capcut save-template <project> <id> <name> --out <path>` | no | Extract a segment as a reusable template JSON. |
| `apply-template` | `capcut apply-template <project> <template> <start> <duration> [text] [options]` | yes | Stamp a template into a project with new timing/text. |
| `make-preset` | `capcut make-preset <project> <text-segment-id> --out <preset.json>` | no | Extract a text segment's styling as a reusable preset JSON (apply via --preset). |
| `templates` | `capcut templates <project>` | no | List bundled reusable templates. |
| `batch` | `capcut batch <project> [--continue-on-error] < operations.jsonl` | yes | Run multiple edits from stdin (JSONL), one file write. |
| `import-srt` | `capcut import-srt <project> <srt-or-> [options]` | yes | Import an SRT file/stdin as one text segment per cue. |
| `import-ass` | `capcut import-ass <project> <ass-or-> [options]` | yes | Import an ASS/SSA subtitle file as text segments. |
| `text-ranges` | `capcut text-ranges <project> <id> --styles <json-or-@file>` | yes | Apply byte-accurate multi-style ranges to a text segment. |
| `caption` | `capcut caption <project> (--audio <path> \| --from-segment <id>) [options]` | yes | Transcribe audio via whisper into real caption-track segments. |
| `translate` | `capcut translate <project> --to <language> --out <path> [options]` | yes | Clone a draft into another language via the Anthropic API. |
| `migrate` | `capcut migrate <project> --from <version> --to <version>` | yes | Apply known schema migrations across version boundaries. |
| `add-sfx` | `capcut add-sfx <project> <slug> <start> <duration> [options]` | yes | Add a sound effect on a dedicated track. |
| `chroma` | `capcut chroma <project> <id> (--color <hex> \| --off) [options]` | yes | Green-screen / chroma key a video segment, or --off. |
| `prune` | `capcut prune <project>` | yes | Remove materials no segment references. |
| `register` | `capcut register <project-dir> [--apply] [--drafts <dir>]` | yes | Repair an existing draft's registration metadata (draft_meta_info.json + root_meta_info.json entry) from a read-only draft_content.json so the CapCut app lists it (plan by default; --apply writes with .bak). |
| `relink` | `capcut relink <project> (--dir <path> \| --from <prefix> --to <prefix>)` | yes | Repair broken media paths (--dir or --from/--to). |
| `replace-media` | `capcut replace-media <project> <segment-id> <new-file> [--retime]` | yes | Swap a segment's source file (placeholder > final) keeping its timing, effects, and keyframes. |
| `timeline` | `capcut timeline <project> [--cols <number>]` | no | Show the track/segment layout (JSON, or -H ASCII bars). |
| `projects` | `capcut projects [query] [--drafts <path>] [--names]` | no | List CapCut/JianYing draft folders on disk. |
| `diff` | `capcut diff <project-a> <project-b>` | no | Compare two drafts (segments/materials/tracks added/removed/changed). |
| `concat` | `capcut concat <project-a> <project-b> [--out <path>]` | yes | Append one draft onto another's timeline (id-safe), write to --out or in place. |
| `config` | `capcut config` | no | Show the resolved config (.capcutrc + effective defaults). |
| `describe` | `capcut describe` | no | Emit the full command surface as JSON (agent tool spec). |
| `completions` | `capcut completions <bash\|zsh\|fish>` | no | Generate shell completions (bash|zsh|fish). |
| `enums` | `capcut enums <category-flag> [--jianying]` | no | List enum slugs (transitions, masks, effects, ...) by category. |
| `harvest-enums` | `capcut harvest-enums <project> [--apply] [--catalogue <path>]` | no | Learn store resource ids from an app-authored draft into the per-user catalogue (lint + writable slugs). |
| `doctor` | `capcut doctor` | no | Environment preflight (Node, whisper, API key, project dir). |
| `diagnose` | `capcut diagnose <project> [--bundle <report.json>]` | no | Inspect canonical draft files, divergence, and editor-write safety. |
| `fixture` | `capcut fixture <project> --out <dir>` | no | Build a shareable, redacted compatibility bundle (timeline JSON only) for a version-support issue. |
| `sync-timelines` | `capcut sync-timelines <project-dir> [--apply]` | yes | Reconcile drifted timeline mirrors (template-2.tmp, draft_info.json) from a read-only draft_content.json (plan with mtimes by default; --apply rewrites only the drifted mirrors). |
| `restore` | `capcut restore <project> [--step <number> \| --list]` | yes | Undo writes from .bak / snapshot history (--step N, --list). |
| `serve` | `capcut serve [--queue <path>] [options]` | no | Run a stateless JSONL job queue from stdin/--queue. |
| `decrypt` | `capcut decrypt <project-or-file>` | no | Detect JianYing 6.0+ encryption and explain the workaround. |
| `export` | `capcut export <drafts-dir> --batch [options]` | yes | EXPERIMENTAL UI-automated render queue (macOS). |
| `init` | `capcut init <name> [--template <dir>] [--drafts <dir>]` | yes | Create a new empty draft from a template. |
| `quickstart` | `capcut quickstart <name> [--video <f>] [--audio <f>] [--srt <f>] [--drafts <dir>]` | yes | One-command first draft: create + add one input + lint + print the open-in-CapCut step. |
| `compile` | `capcut compile <spec.json> [--out <draftdir>] [--check \| --plan]` | yes | Build a draft from a declarative JSON spec (the inverse of describe). |
| `render` | `capcut render <project> [--out <preview.mp4>] [options]` | no | Render a low-res ffmpeg proxy preview (trim+speed+audio, --burn-captions); not CapCut's final render. |
| `detect-scenes` | `capcut detect-scenes <video> [options]` | no | Detect scene-change cut points in a video (ffmpeg scene filter); prints cuts + segments to seed compile/cut. |