capcutctl: Transactional CLI for Editing Native CapCut Projects

RepositoryRoXsaita/capcut-editor-cliTool

capcutctl is an open-source command-line tool for macOS designed to edit native CapCut desktop projects programmatically without flattening them into rendered video. Cuts, layouts, audio tracks, and effects remain fully editable in CapCut.

Key points

  1. Edits native CapCut project files on macOS programmatically while preserving full non-destructive timeline editability.
  2. Provides transactional edits with snapshots and automatic rollback to prevent project corruption caused by inconsistent internal files.
  3. Includes deterministic layout generation, A-roll analysis with acoustic boundary checks, and frame QA previews.
  4. Exposes a machine-readable CLI contract tailored for automation and coding agents.
  5. Requires macOS, Node.js 20+, Python 3.11+, ffmpeg, and ffprobe.

Why it matters

CapCut draft files rely on complex multi-file mirrors and local asset references; ad-hoc JSON modifications frequently corrupt the project. capcutctl introduces atomic operations and safety checks, enabling AI agents and developers to automate preliminary editing workflows while letting human editors refine the native project inside the desktop GUI.

Analysis

The project serves video creators, developers, and autonomous agent systems running on macOS. At version 0.1.1, it represents an early yet thoughtfully architected public release backed by over 300 automated tests covering transactions, rollbacks, and layouts. However, because CapCut's file format is proprietary and undocumented, users must remain cautious regarding future breaking changes from ByteDance.

Mentioned links

Found in

Summary generated by AI (Gemini 3.8 Flash, 27 September 2026). It may contain errors – the original source is authoritative.

Related entries

Similar in content, found by the AI search.

  • Repository:browser-use/video-use

    video-use: Automated Video Editing via Coding Agents

    The open-source project video-use enables automated video editing using coding agents such as Claude Code, Codex, or Hermes via natural language. Users place raw clips in a directory and instruct the agent to assemble, clean, subtitle, and render the final cut.

    23.8kstarsPython

    AI & LLMs· Tool

  • Repository:calesthio/OpenMontage

    OpenMontage: Open-Source Agentic Video Production System

    OpenMontage is an open-source video production framework designed to turn AI coding assistants such as Cursor or Claude into automated video production studios. Built with Python, it provides 12 production pipelines, over 100 tools, and 700+ skill and knowledge files connecting speech, image, and video generation services with programmatic editing engines.

    56.2kstarsPython

    AI & LLMs· Tool

  • X post:Riley Brown

    New Video Editor Translates Timeline Edits into Reusable Code

    Riley Brown highlights an open-source project by Konstantin Paulus: a video editor that converts every timeline edit into code. These sequences of changes can subsequently be turned into reusable skills.

    624bookmarks42.7kviews

    AI & LLMs· Opinion

  • Repository:a2aproject/a2a-cli

    A2A CLI: Official Terminal Tool for the Agent2Agent Protocol

    The A2A CLI is a Go-based command-line client designed to interact with Agent2Agent (A2A) agents. It provides a standardised way to discover, message, and manage AI agents directly from the terminal without throwaway scripts.

    116starsGo

    AI & LLMs· Tool

Back to the knowledge base

Let's talk about your project

Get in touch

Locations

  • Mattersburg
    Johann Nepomuk Bergerstraße 7/2/14
    7210 Mattersburg, Austria
  • Vienna
    Ungargasse 64-66/3/404
    1030 Wien, Austria

Parts of this content were created with the assistance of AI.