capcut-edit

1# capcut-edit
2 
3CLI for editing CapCut / JianYing drafts through a version-aware store. v0.11 detects and synchronizes readable timelines across `draft_content.json`, `draft_info.json`, `draft_meta_info.json`, and `template-2.tmp`.
4 
5## Project locations
6 
7- **macOS**: `~/Movies/CapCut/User Data/Projects/com.lveditor.draft/<project>/`
8- **Windows**: `%LOCALAPPDATA%\CapCut\User Data\Projects\com.lveditor.draft\<project>\`
9- **Windows (JianYing / 剪映)**: `%LOCALAPPDATA%\JianyingPro\User Data\Projects\com.lveditor.draft\<project>\`
10 
11## Core principle — deterministic scripts
12 
13Any recipe involving more than one `capcut` call, any arithmetic, or any branching ships as a parameterised shell script in `scripts/`. Claude invokes the script with inputs; the script runs a fixed sequence. If a recipe can be a script, it **must** be a script — not a narrative in `references/`.
14 
15`references/workflows.md` documents *which script to call and why*, never a reconstructable sequence.
16 
17## Progressive disclosure
18 
19Start broad, drill into what you need. Never dump full project JSON.
20 
21```bash
22capcut info <project> -H           # overview
23capcut doctor -H                   # installed media/transcription capabilities
24capcut diagnose <project> -H       # canonical files, divergence, editor safety
25capcut tracks <project> -H         # all tracks
26capcut materials <project> -H      # material summary
27capcut segments <project> -H       # segments with timing
28…