Skip to content
Back to search

capcut-cli

MarketplaceWorks with Claude CodeGitHub

Edit CapCut and JianYing projects from Claude Code (capcut-cli plugin).

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026. Its scripts were only partly scanned.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/renezander030/capcut-cli with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/renezander030/capcut-cli'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/renezander030-capcut-cli/badge.svg)](/listings/renezander030-capcut-cli)

HTML

<a href="/listings/renezander030-capcut-cli"><img src="/api/listings/renezander030-capcut-cli/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

**Prerequisites:** Node ≥ 18 (built-ins only — no native modules). Optional tools unlock specific commands: Whisper for `caption`, FFmpeg for `render`, ffprobe for automatic media metadata, and `ANTHROPIC_API_KEY` for `translate`.

npm install -g capcut-cli

From Python: `pip install capcut` wraps the same binary — `capcut.run("quickstart", "my-short", video="clip.mp4", ratio="9:16")` — see [python/README.md](https://github.com/renezander030/capcut-cli/blob/master/python/README.md).

capcut doctor
capcut quickstart my-first --video clip.mp4 --srt captions.srt
capcut info ./my-first/ -H

**Result:** a real local project with video and captions on editable tracks — not a flattened export. Open it in CapCut or JianYing to review, adjust, and render. The publish click stays human.

Useful? [Star capcut-cli](https://github.com/renezander030/capcut-cli) to help other editors and agent builders find it.

For more practical tools for AI agents, from video automation to checks before they ship, [follow René on GitHub](https://github.com/renezander030).

Build from source instead: `git clone https://github.com/renezander030/capcut-cli && cd capcut-cli && npm install && npm run build` (then `npm link` to expose `capcut`). Or run any command without installing: `npx capcut-cli <command>`.

> [!IMPORTANT] > **Upgrade before using older versions.** Fixture bundles made with versions up to 0.17.2 may contain stable device identifiers and must be treated as unsanitised ([#59](https://github.com/renezander030/capcut-cli/issues/59)). Versions up to 0.17.0 also contain local command/filter injection paths and unsafe temporary-file or credential-output behaviour. These issues are fixed in 0.18.0 and 0.17.1 respectively. Run `npm install -g capcut-cli@latest` and see the [changelog](./CHANGELOG.md) for full details.

> **Disclaimer:** This is an independent, community-maintained project. It is **not affiliated with, sponsored by, or endorsed by** CapCut, JianYing, or ByteDance Ltd. "CapCut" and "JianYing" (剪映) are trademarks of ByteDance Ltd. All product names, logos, and brands are the property of their respective owners and are used here only for identification (nominative) purposes.

**An independent CLI for CapCut / JianYing that any LLM agent can drive — zero dependencies, no server, both namespaces in one binary.**

JSON in, JSON out: every command reads and writes the local draft store directly, with no MCP server or HTTP daemon. On newer CapCut versions it detects and synchronizes every readable timeline target instead of assuming `draft_content.json` is the only source of truth. That gives any model (Claude, DeepSeek, GLM, Kimi) a deterministic boundary for inspection, building, subtitles, captions, translation, and long-form cuts.

**Use it four ways:**

- **CLI** — `npm install -g capcut-cli`, then `capcut <command> <project>` - **Library** — `import { loadDraft, lintDraft, saveDraft } from "capcut-cli"` (typed, zero-dep) - **Queue runner** — `capcut serve` reads JSONL jobs from stdin, for [n8n / Make / Coze](./examples/serve-automation.md) - **Agent sandbox (experimental)** — build [`capcut-core.wasm`](https://github.com/renezander030/capcut-cli/tree/master/wasm/capcut-core) for three read-only MCP tools with zero filesystem, network, environment, clock, random, stdio, or process imports

Give your agent the skill

One command installs the `capcut-edit` skill into Claude Code, Codex, Cursor, OpenCode and the other agents the [`skills`](https://skills.sh) installer supports:

npx skills add renezander030/capcut-cli

Claude Code can also load it as a plugin:

/plugin marketplace add renezander030/capcut-cli
/plugin install capcut-cli@capcut-cli

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 14 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. {
  2. "name": "capcut-cli",
  3. "owner": {
  4. "name": "René Zander"
  5. },
  6. "description": "Edit CapCut and JianYing projects from Claude Code (capcut-cli plugin).",
  7. "plugins": [
  8. {
  9. "name": "capcut-cli",
  10. "source": "./",
  11. "description": "Edit CapCut and JianYing (剪映) projects from Claude Code — subtitles and SRT/ASS import, timing, speed, volume, keyframes, masks, filters and effects, templates, lint --fix, render previews, and cutting long-form to shorts."
  12. }
  13. ]
  14. }
README.md · README · 219 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <p align="center">
  2. <img src="https://raw.githubusercontent.com/renezander030/capcut-cli/master/media/og-card.png" alt="capcut-cli — the CapCut/JianYing CLI any LLM agent can drive: zero dependencies, no server, both namespaces" width="640">
  3. </p>
  4. # capcut-cli
  5. [![CI](https://github.com/renezander030/capcut-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/renezander030/capcut-cli/actions/workflows/ci.yml)
  6. [![npm version](https://img.shields.io/npm/v/capcut-cli.svg)](https://www.npmjs.com/package/capcut-cli)
  7. [![npm downloads](https://img.shields.io/npm/dm/capcut-cli.svg)](https://www.npmjs.com/package/capcut-cli)
  8. [![node](https://img.shields.io/node/v/capcut-cli.svg)](https://nodejs.org)
  9. [![license](https://img.shields.io/npm/l/capcut-cli.svg)](./LICENSE)
  10. English | [中文](./README.zh-CN.md) | [日本語](./README.ja.md)
  11. **Create and edit real CapCut / JianYing projects from the terminal — or any LLM agent.**
  12. Open the result in CapCut with every track still editable. capcut-cli works directly on the local draft store: JSON in, JSON out, with no upload, API, MCP server, or HTTP daemon. The one opt-in exception is the experimental `caption --cloud`, which uploads the audio it transcribes to ByteDance.
  13. **Also from the maintainer:** [500 Years Frozen in Time: The Inca Children Mystery](https://www.youtube.com/watch?v=cl8SP3PjspQ), a 14:49 documentary from [Bronze Age Banter](https://www.youtube.com/@BronzeAgeBanter).
  14. `raw recording` → `silence-aware cuts + styled captions` → `editable CapCut / JianYing draft`
  15. **▶ Captioned output example (35 seconds)**
  16. https://github.com/user-attachments/assets/ba6d4f4c-626b-4d09-bcf2-d32471c427be
  17. ## Install and open your first editable draft
  18. **Prerequisites:** Node ≥ 18 (built-ins only — no native modules). Optional tools unlock specific commands: Whisper for `caption`, FFmpeg for `render`, ffprobe for automatic media metadata, and `ANTHROPIC_API_KEY` for `translate`.
  19. ```bash
  20. npm install -g capcut-cli
  21. ```
  22. ### Linux x64 without installing Node or npm
  23. Download `capcut-cli-v0.34.0-linux-x64.tar.gz` and its `.sha256` file from the [release assets](https://github.com/renezander030/capcut-cli/releases). Verify and extract them together:
  24. ```sh
  25. sha256sum -c capcut-cli-v0.34.0-linux-x64.tar.gz.sha256
  26. tar -xzf capcut-cli-v0.34.0-linux-x64.tar.gz
  27. ./capcut-cli-v0.34.0-linux-x64/capcut --version
  28. ./capcut-cli-v0.34.0-linux-x64/capcut describe --compact
  29. ```
  30. Keep the whole extracted directory together; it includes the Node runtime and its license. Both `capcut` and `capcut-cli` launchers work after moving the directory. This archive targets Linux x64 with glibc (not Alpine/musl); optional FFmpeg/Whisper tools remain separate. macOS and Windows continue to use the npm installation above. This is a portable directory, not a single-file executable.
  31. To build an archive from source, use a complete official Node distribution and run `npm run pack:portable -- --out ./portable` (or add `--node-root <node-distribution>`). The builder uses the local npm payload, downloads nothing and refuses to overwrite existing artifacts.
  32. From Python: `pip install capcut` wraps the same binary — `capcut.run("quickstart", "my-short", video="clip.mp4", ratio="9:16")` — see [python/README.md](https://github.com/renezander030/capcut-cli/blob/master/python/README.md).
  33. ```bash
  34. capcut doctor
  35. capcut quickstart my-first --video clip.mp4 --srt captions.srt
  36. capcut info ./my-first/ -H
  37. ```
  38. **Result:** a real local project with video and captions on editable tracks — not a flattened export. Open it in CapCut or JianYing to review, adjust, and render. The publish click stays human.
  39. Useful? [Star capcut-cli](https://github.com/renezander030/capcut-cli) to help other editors and agent builders find it.
  40. For more practical tools for AI agents, from video automation to checks before they ship, [follow René on GitHub](https://github.com/renezander030).
  41. Build from source instead: `git clone https://github.com/renezander030/capcut-cli && cd capcut-cli && npm install && npm run build` (then `npm link` to expose `capcut`). Or run any command without installing: `npx capcut-cli <command>`.
  42. > [!IMPORTANT]
  43. > **Upgrade before using older versions.** Fixture bundles made with versions up to 0.17.2 may contain stable device identifiers and must be treated as unsanitised ([#59](https://github.com/renezander030/capcut-cli/issues/59)). Versions up to 0.17.0 also contain local command/filter injection paths and unsafe temporary-file or credential-output behaviour. These issues are fixed in 0.18.0 and 0.17.1 respectively. Run `npm install -g capcut-cli@latest` and see the [changelog](./CHANGELOG.md) for full details.
  44. > **Disclaimer:** This is an independent, community-maintained project. It is **not affiliated with, sponsored by, or endorsed by** CapCut, JianYing, or ByteDance Ltd. "CapCut" and "JianYing" (剪映) are trademarks of ByteDance Ltd. All product names, logos, and brands are the property of their respective owners and are used here only for identification (nominative) purposes.
  45. **An independent CLI for CapCut / JianYing that any LLM agent can drive — zero dependencies, no server, both namespaces in one binary.**
  46. JSON in, JSON out: every command reads and writes the local draft store directly, with no MCP server or HTTP daemon. On newer CapCut versions it detects and synchronizes every readable timeline target instead of assuming `draft_content.json` is the only source of truth. That gives any model (Claude, DeepSeek, GLM, Kimi) a deterministic boundary for inspection, building, subtitles, captions, translation, and long-form cuts.
  47. **Use it four ways:**
  48. - **CLI** — `npm install -g capcut-cli`, then `capcut <command> <project>`
  49. - **Library** — `import { loadDraft, lintDraft, saveDraft } from "capcut-cli"` (typed, zero-dep)
  50. - **Queue runner** — `capcut serve` reads JSONL jobs from stdin, for [n8n / Make / Coze](./examples/serve-automation.md)
  51. - **Agent sandbox (experimental)** — build [`capcut-core.wasm`](https://github.com/renezander030/capcut-cli/tree/master/wasm/capcut-core) for three read-only MCP tools with zero filesystem, network, environment, clock, random, stdio, or process imports
  52. ### Give your agent the skill
  53. One command installs the `capcut-edit` skill into Claude Code, Codex, Cursor, OpenCode and the other agents the [`skills`](https://skills.sh) installer supports:
  54. ```bash
  55. npx skills add renezander030/capcut-cli
  56. ```
  57. Claude Code can also load it as a plugin:
  58. ```
  59. /plugin marketplace add renezander030/capcut-cli
  60. /plugin install capcut-cli@capcut-cli
  61. ```
  62. The skill teaches the agent every command, the progressive-disclosure habit (inspect first, never dump a whole draft), where the draft store lives on macOS and Windows, and the deterministic scripts for fades, Ken Burns and long-to-short cuts. It triggers on English and Chinese requests alike (剪映, 字幕, 草稿).
  63. ### Capability-free Wasm tools for agents
  64. **Using an AI assistant with capcut-cli? Give it a safer “look, don’t touch” mode.**
  65. The optional Wasm tool lets an AI:
  66. - describe what is inside a CapCut project;
  67. - show what changed between two versions; and
  68. - spot common timeline and caption problems.
  69. It can examine only the project information you hand to it. It cannot browse your files, go online, read passwords or API keys, open other apps, or change the project.
  70. **Use it when** you want an AI to review a draft with the least possible access. **Skip it when** you are using capcut-cli yourself or want the AI to edit or render—the normal CLI still does those jobs. This feature is experimental, optional, and changes nothing unless you set it up. [**Technical details and setup →**](https://github.com/renezander030/capcut-cli/tree/master/wasm/capcut-core#readme)
  71. The experimental [`wasm/capcut-core`](https://github.com/renezander030/capcut-cli/tree/master/wasm/capcut-core) source package moves the deterministic, JSON-in/JSON-out boundary into a WebAssembly Component:
  72. - `inspect` matches `capcut info` for valid drafts.
  73. - `diff` matches `capcut diff` for structural changes.
  74. - `lint-portable` runs an explicit, parity-tested subset of `capcut lint` that needs no host files or media probing.
  75. The host reads a draft and passes its JSON as tool input. The component itself has no ambient capabilities, and CI proves the built world has zero imports before exercising all three functions through [Wassette](https://github.com/microsoft/wassette) over MCP. From a source checkout, build it with `npm --prefix wasm/capcut-core ci && npm run wasm:verify`; setup and security details are in the [component README](https://github.com/renezander030/capcut-cli/tree/master/wasm/capcut-core#readme).
  76. ## Release notes
  77. > **New in v0.33.0:** `caption` reports speech its cues leave uncaptioned and reuses a cached transcription when only the styling changes; `loudness --tolerance` and `--max-true-peak` gate a delivery with an exit code; `lint` gains opt-in pacing and silent-stretch checks; `diff --since-write` shows what CapCut changed after the CLI's last write; `fixture --anonymize` makes a shareable bundle; and `render --burn-captions` draws captions in the draft's own font. Full details in the [changelog](./CHANGELOG.md).
  78. > **New in v0.32.0:** time arguments reject malformed or unsafe values before writing; translation responses must contain exactly one string per input; and subtitle imports reject malformed UTF-8 instead of silently corrupting caption text. Full details in the [changelog](./CHANGELOG.md).
  79. For an existing nested project, use `capcut diagnose <project> --active-timeline` to inspect the selected document before editing. The opt-in follows the pointer on unverified builds and refuses invalid or conflicting selected documents; it does not bypass write guards.
  80. To populate a project that CapCut already owns, create an empty project in the app and quit CapCut, then run:
  81. ```sh
  82. capcut compile spec.json --into /path/to/app-created-project --active-timeline --check
  83. capcut compile spec.json --into /path/to/app-created-project --active-timeline
  84. ```
  85. Omit `--active-timeline` for a flat project without `Timelines/`. Every root and active mirror must be empty. The project keeps its name and registration; canvas and frame rate change only when supplied in the spec. Imported media is staged under the project, with registration and timeline backups committed together. Reopen, save, close and reopen in CapCut to check that edits persist. Automated safety tests cover these paths; desktop acceptance on your app build remains unverified.
  86. ## Built with capcut-cli
  87. - [OpenChatCut](https://github.com/0xsline/OpenChatCut) — exports an agent-edited timeline, local media, audio, and captions into a real CapCut / JianYing draft for review and rendering.
  88. Built something with capcut-cli? [Open a showcase issue](https://github.com/renezander030/capcut-cli/issues/new?template=showcase.yml) with a public link, one sentence about what it does, and an optional screenshot or demo.
  89. Project descriptions are approved by their maintainers. Inclusion does not imply endorsement or affiliation.
  90. ## Commands
  91. JSON by default (pipe to `jq`); add `-H` for a human-readable table. Pass `--jianying` to use the JianYing enum namespace. Run `capcut <command> --help` for full flags.
  92. | Group | Commands |
  93. |-------|----------|
  94. | **Inspect** | `info` · `tracks` · `materials` · `version` · `lint` |
  95. | **Browse / drill in** | `segments` · `texts` · `segment` · `material` |
  96. | **Create** | `init` · `quickstart` · `compile` (build a draft from a JSON spec) |
  97. | **Preview** | `render` (low-res ffmpeg proxy — not CapCut's final render) |
  98. | **Add** | `add-video` · `add-audio` · `add-text` (Wikimedia URLs supported, license-checked) |
  99. | **Edit / animate** | trim · speed · volume · transitions · masks · text/image animations · easing curves |
  100. | **Templates** | apply and extract reusable layouts · `make-preset` (portable text-style presets) |
  101. | **Subtitles & i18n** | `caption` · `import-srt` · `export-srt` (line/word SRT + VTT) · `translate` (multi-language draft clone) |
  102. | **Effects** | `sfx` · `chroma` (chroma key) · `matting` (smart background removal) |
  103. | **Long-form → short** | `cut` · `detect-scenes` (ffmpeg scene-cut detection) · `detect-silence` · `detect-retakes` (repeated takes) |
  104. | **Automation** | `serve` (stateless JSONL runner) · `migrate` · `doctor` · `sync-timelines` (8.7 mirror repair) |
  105. `capcut describe --compact` lists command names, summaries, usage, and write status. Fetch a complete contract with `capcut describe --command compile`; repeat `--command` for several commands. Plain `capcut describe` still emits the full registry.
  106. **Full reference** for every command, option, and exit code: **[docs/command-reference.md](./docs/command-reference.md)** (简体中文: [docs/command-reference.zh-CN.md](./docs/command-reference.zh-CN.md)).
  107. ## Sponsor
  108. capcut-cli is MIT and free forever. Sponsoring funds faster releases and same-week support for new CapCut / JianYing versions — and unlocks power-user extras:
  109. - **$5/mo · Supporter** — sponsors-only release notes plus your name in `BACKERS.md`. Keep the project moving.
  110. - **$25/mo · Pro** — invite to the private `capcut-cli-pro` repo: premium template and caption-style packs, the full Claude viral-shorts pipeline, ready-to-run `compile` specs, and early-access builds. Plus priority issue triage.
  111. - **$100/mo · Team** — everything in Pro for up to 5 teammates, written commercial-use confirmation, your logo in this README, and priority fast-tracking of the features your team needs.
  112. [**Become a sponsor →**](https://github.com/sponsors/renezander030)
  113. > Using capcut-cli at work? The Team tier pays for itself the first afternoon it saves your engineers.
  114. ## Commercial work
  115. Separate from sponsorship: if you are building capcut-cli into a product, or you need it to do something it does not do yet, I take on a small number of integration engagements. Write to rene@renezander.com and say what you are building.
  116. ## How it works
  117. CapCut/JianYing store each project as local JSON. capcut-cli loads that store, validates against a version-aware schema, applies your edit, and writes it back atomically (with a `.bak`). No project files are uploaded anywhere, and only `caption --cloud` sends audio out; nothing runs as a service. See [docs/version-support.md](./docs/version-support.md) for the CapCut/JianYing versions and schema flags it understands.
  118. ## Docs & examples
  119. - [docs/command-reference.md](./docs/command-reference.md) — every command and flag ([简体中文](./docs/command-reference.zh-CN.md))
  120. - [docs/quickstart.zh-CN.md](./docs/quickstart.zh-CN.md) — 剪映快速上手 (JianYing-first quickstart, Simplified Chinese)
  121. - [examples/](./examples/) — end-to-end recipes (VO alignment, serve automation, batch subtitle correction)
  122. - [docs/version-support.md](./docs/version-support.md) · [docs/jianying-encryption.md](./docs/jianying-encryption.md)
  123. - [CHANGELOG.md](./CHANGELOG.md) · [Releases](https://github.com/renezander030/capcut-cli/releases) — what's new
  124. - [draftcat](https://github.com/renezander030/draftcat) — sibling project: governed AI pipelines (Go, MIT), same single-binary, no-API design
  125. - [skillgate](https://github.com/renezander030/skillgate) — sibling project: deterministic finish-line gates (Node, MIT), for when your agent reports "done" before the tests pass
  126. ## More from René
  127. capcut-cli is one of several CLIs I build so AI agents can do real work safely. If you script agents, these may help too:
  128. - [agentic-task-system](https://github.com/renezander030/agentic-task-system) gives your agent task and knowledge context over TickTick, Notion, GitHub, Obsidian and more (CLI + MCP), with reviewed writes and undo.
  129. - [skillgate](https://github.com/renezander030/skillgate) blocks commit or publish until your definition of done passes, for when an agent says "done" before the tests do.
  130. - [agent-approval-gate](https://github.com/renezander030/agent-approval-gate) lets an agent draft, a person approve, and only then dispatch, with an audit trail.
  131. [Follow René on GitHub](https://github.com/renezander030) to see the next ones.
  132. ## Trademarks
  133. CapCut™ and JianYing™ (剪映) are trademarks of ByteDance Ltd. This project is unofficial and is not affiliated with or endorsed by ByteDance; the marks are used nominatively to describe interoperability.
  134. ## License
  135. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.