capcut-cli
An unofficial CLI for CapCut and JianYing projects: subtitles, timing, speed, volume and long-to-shorts, from the terminal or through an agent
- 1,181 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- Reads and writes local CapCut draft files
- Runs external tools such as FFmpeg and Whisper
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add cli/capcut-cliDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Reads and writes local CapCut draft files
- Runs external tools such as FFmpeg and Whisper
This is third-party code. Review the repository files before installing.
What it does
capcut-cli creates and edits real CapCut and JianYing projects from the terminal or through an AI agent. It works directly on the local draft store: it reads and writes JSON with no cloud upload, API, MCP server or daemon. The result opens in CapCut with every track still editable. It can add and style subtitles, change timing, speed and volume, apply templates and cut long video into shorts. Some commands need external tools: Whisper for captions, FFmpeg for render, ffprobe for metadata and an Anthropic key for translation.
Who it is for. For editors and short-form creators who edit CapCut and JianYing projects through an agent.
Good fit when
- You need to add or style subtitles in a CapCut or JianYing project
- You need to cut long video into shorts while keeping it editable
- You need to edit track timing, speed and volume from the terminal
Not a fit when
- You do not work with CapCut or JianYing
- You want a cloud service or MCP server rather than a local CLI
Example request
Cut this long video into a vertical short with silence-aware captions and open an editable CapCut draftLimitations
The tool is unofficial and not affiliated with ByteDance. It needs Node.js 18 or later, and some commands need Whisper, FFmpeg, ffprobe or an Anthropic key for translation. Early versions up to 0.17.x had vulnerabilities and unsafe handling, now fixed, and the README advises installing the latest version. Encrypted JianYing 6.0+ drafts cannot always be seeded.
How to disable. Uninstall the package: npm uninstall -g capcut-cli, or remove the plugin or skill from the agent config.
FAQ
Does it upload video to the cloud?
No. capcut-cli works directly on the local draft store, with no upload, API or server, and the result opens in CapCut.
Are external tools needed?
Only Node.js 18+ for the basics. Whisper is for captions, FFmpeg for render and an Anthropic key for translation.
Discussion
No questions or reviews yet.
Related
CLI toolsThe jyr CLI and five skills: the agent builds a video edit as a JianYing or CapCut draft, and you finish it in the editor itself
An agent skill that creates and edits CapCut (Jianying) drafts from a text brief, exports the video and installs the draft.
SmartCut MCP
SmartCut MCP Server
MCP server that edits talking head videos inside a CapCut project: it uses auto-captions to cut silences and repeated takes.
An MCP server with 59 tools for CapCut and OpenCut editing: tracks, clips, text, transitions and voiceover from Cursor and Codex.
A macOS video editor driven by Claude Code and Codex: a terminal docked beside the timeline, bashcut commands and an MCP server.
A Claude Code skill that turns a talking-head video into a short motion-graphics edit and checks its own cut
README in short
The README describes capcut-cli as an unofficial CLI for creating and editing CapCut and JianYing projects from the terminal or through an agent. It works directly on the local draft store, JSON in and out, with no upload, API, MCP server or daemon, and the result opens in CapCut with editable tracks. Install is via npm globally, with a Python wrapper and an agent install via npx skills add or a plugin. Some commands need Whisper, FFmpeg, ffprobe or an Anthropic key. The README notes fixed vulnerabilities and advises the latest version.