Skip to content
Back to search

openchatcut

Open-source, local-first conversational AI video editor with a professional multi-track timeline, Agent Skills, MCP integration, and Remotion rendering.

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.

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/0xsline/openchatcut 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/0xsline/openchatcut'

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/0xsline--openchatcut/badge.svg)](/listings/0xsline--openchatcut)

HTML

<a href="/listings/0xsline--openchatcut"><img src="/api/listings/0xsline--openchatcut/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

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

Desktop installers

Download the latest macOS, Windows, and Linux builds from [GitHub Releases](https://github.com/0xsline/OpenChatCut/releases/latest). The release currently includes DMG installers for Apple Silicon and Intel Macs, an x64 Windows installer, and an x64 Linux AppImage.

These are early builds. The macOS packages are not yet signed or notarized, so the operating system may require manual approval on first launch.

Run from source

Requires Node.js 24.x and npm. The supported Node.js range is enforced by `package.json`, and `.nvmrc` selects the matching major version for Node version managers.

On Linux x64, `npm install` also downloads ONNX Runtime's optional CUDA provider (several hundred MB from NuGet). For a CPU-only install, run `ONNXRUNTIME_NODE_INSTALL=skip npm install` instead.

git clone https://github.com/0xsline/OpenChatCut.git
cd OpenChatCut
npm install
cp .env.example .env.local
npm run dev

Open:

http://localhost:5199

The editor needs a browser [secure context](https://developer.mozilla.org/en-US/docs/Web/Security/Defenses/Secure_Contexts): open OpenChatCut at `http://localhost` or `http://127.0.0.1` on the machine running it, or serve it over HTTPS. Over plain HTTP from another device (a LAN IP or reverse proxy), browsers disable Web Crypto, WebCodecs, and the clipboard, so the project list still loads but the editor shows this requirement instead of opening.

Only add the model or media-service credentials you actually use to `.env.local`. Features without configured third-party credentials report the missing key explicitly; local timeline editing, built-in media, and other configured capabilities continue to work.

Development launches are isolated per Git checkout/worktree by default. `npm run dev` and `npm run desktop:dev` keep that checkout's projects, imported media, generation jobs, credentials, settings, and local authorization state under its own profile in `~/.openchatcut/dev-profiles/`. Use `npm run dev:shared` only when you intentionally need the legacy shared development store.

Built-in Agent authentication

- **API keys:** open **Settings → Agent model**, choose a provider, and save its API key and model. Keys remain server-side. - **ChatGPT subscription:** install the official Codex CLI 0.146.0 or newer, then open **Settings → Agent model → OpenAI · Codex**. Sign in through the browser or device-code flow, load the account's models, choose a model-specific reasoning effort (or keep its default), and select Codex from the chat model picker. OpenChatCut uses a dedicated Codex profile; the official CLI owns credential storage, token renewal, and logout, while OAuth tokens are never exposed to the browser. - **Claude subscription:** OpenChatCut does not collect Claude OAuth credentials. Use Claude Code through the local MCP connection below. The built-in Agent can use Anthropic through an API key.

The built-in Agent always runs the model loop on the local server. Chat, drafts, and proposals survive page refreshes and local service restarts. Timeline changes still go through the active editor's validated, undoable commands.

Agent local-path access (advanced)

Desktop agents can browse any local directory allowed by the operating system by default, including mounted media drives. `browse_local_media` lists folders and supported media, searches by filename or relative path and media type, and returns paginated results without importing. The agent can then use `import_assets` for up to 100 selected paths, `import_asset` for one path, or `import_folder` for a whole folder. Imports reuse media probing and reference registration, preserve source files, and skip duplicate content, including duplicates within one batch. Document files such as TXT, Markdown, DOCX, and PDF should be attached to chat instead. These tools require the desktop app.

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.

README.md · README · 635 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="public/openchatcut-icon.png" width="96" alt="OpenChatCut" />
  3. </p>
  4. <h1 align="center">OpenChatCut</h1>
  5. <p align="center">
  6. <a href="README_ZH.md">简体中文</a> · <strong>English</strong>
  7. </p>
  8. <p align="center">
  9. <strong>Open-source ChatCut alternative · agent-native · local-first AI video editor</strong>
  10. </p>
  11. <p align="center">
  12. Let Codex, Claude Code, and the built-in agent read, edit, and export real video projects that remain fully editable.
  13. Website: <a href="https://openchatcut.com">openchatcut.com</a>
  14. </p>
  15. <p align="center">
  16. <a href="https://openchatcut.com/pro"><strong>OpenChatCut Pro</strong></a> · Desktop edition: install it and start cutting
  17. </p>
  18. <p align="center">
  19. <a href="#what-is-openchatcut">Introduction</a> ·
  20. <a href="#product-tour">Product Tour</a> ·
  21. <a href="#quick-start">Quick Start</a> ·
  22. <a href="#using-openchatcut-with-codex--claude-code">Agent / MCP</a> ·
  23. <a href="#community">Community</a> ·
  24. <a href="#sponsors">Sponsors</a> ·
  25. <a href="#changelog">Changelog</a> ·
  26. <a href="#star-growth">Star Growth</a> ·
  27. <a href="#contributing">Contributing</a>
  28. </p>
  29. <p align="center">
  30. <a href="https://github.com/0xsline/OpenChatCut"><img alt="GitHub Repository" src="https://img.shields.io/badge/GitHub-Repository-181717?style=flat&logo=github" /></a>
  31. <a href="https://discord.gg/bSGUAeWYkh"><img alt="Discord Community" src="https://img.shields.io/badge/Discord-Join_Community-5865F2?style=flat&logo=discord&logoColor=white" /></a>
  32. <img alt="Status" src="https://img.shields.io/badge/status-active_development-FF8A3D?style=flat" />
  33. <img alt="Local First" src="https://img.shields.io/badge/data-local_first-111827?style=flat" />
  34. <img alt="TypeScript" src="https://img.shields.io/badge/TypeScript-6-3178C6?style=flat&logo=typescript&logoColor=white" />
  35. <img alt="React" src="https://img.shields.io/badge/React-19-149ECA?style=flat&logo=react&logoColor=white" />
  36. <img alt="Remotion" src="https://img.shields.io/badge/Remotion-4-0B84F3?style=flat" />
  37. <img alt="Electron" src="https://img.shields.io/badge/Electron-43-47848F?style=flat&logo=electron&logoColor=white" />
  38. <img alt="MCP" src="https://img.shields.io/badge/MCP-Agent_native-7C3AED?style=flat" />
  39. <a href="https://atomgit.com/Oxsline/openchatcut"><img alt="AtomGit G-Star" src="https://img.shields.io/badge/AtomGit-G--Star-DA203E?logo=gitcode&logoColor=white" /></a>
  40. </p>
  41. <p align="center">
  42. <a href="https://linux.do" alt="LINUX DO"><img src="https://shorturl.at/ggSqS" /></a>
  43. </p>
  44. <p align="center">
  45. <a href="https://www.producthunt.com/products/openchatcut?embed=true&amp;utm_source=badge-featured&amp;utm_medium=badge&amp;utm_campaign=badge-openchatcut" target="_blank" rel="noopener noreferrer"><img alt="OpenChatCut - Open-source AI agent video editor with a real timeline | Product Hunt" width="250" height="54" src="https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=1201995&amp;theme=light&amp;t=1784645557617" /></a>
  46. </p>
  47. <p align="center">
  48. <img src="assets/readme-pic/01-editor-overview.png" alt="OpenChatCut editor overview with the agent workspace, media pool, preview, and multitrack timeline" />
  49. </p>
  50. <p align="center">
  51. <sub>From a single instruction to a real timeline: agents, media, previews, motion graphics, transitions, effects, and multitrack audio all work together in one project.</sub>
  52. </p>
  53. ---
  54. ## Sponsors
  55. <p align="center">
  56. <a href="https://ofox.ai/?utm_source=github&utm_medium=sponsorship&utm_content=openchatcut"><img src="assets/readme-pic/ofox-logo.svg" width="300" alt="OfoxAI" /></a>
  57. </p>
  58. **OfoxAI: Text, image, and video AI in one platform**
  59. OfoxAI is a unified API platform for text, image, and video AI, with video models from the Seedance, MiniMax (Hailuo), and Wan families. Choose models for AI applications, agents, creative ideation, image generation, and video assets through one platform.
  60. [Explore OfoxAI models and APIs →](https://ofox.ai/?utm_source=github&utm_medium=sponsorship&utm_content=openchatcut)
  61. <br />
  62. <p align="center">
  63. <a href="https://apixo.ai/?utm_source=github&utm_medium=sponsorship&utm_campaign=0xsline&utm_content=openchatcut_logo"><img src="assets/readme-pic/apixo-seedream-en.svg" width="170" alt="APIXO AI" /></a>
  64. </p>
  65. **[APIXO AI](https://apixo.ai/?utm_source=github&utm_medium=sponsorship&utm_campaign=0xsline&utm_content=openchatcut_text_brand): AI Image & Video Creation in One Place**
  66. Create cover images and video assets with **APIXO AI**. Work directly in your browser with no coding required, or connect your apps and automated workflows through the API.
  67. **[Seedream 5.5](https://apixo.ai/models/seedream-5-5?utm_source=github&utm_medium=sponsorship&utm_campaign=0xsline&utm_content=openchatcut_text_model) text-to-image API: from $0.014/image, 30% off the official starting price for a limited time.** The discount applies automatically; no promo code needed.
  68. [Explore APIXO AI Models & Deals →](https://apixo.ai/deals/black-friday?utm_source=github&utm_medium=sponsorship&utm_campaign=0xsline&utm_content=openchatcut_text_deals)
  69. <br />
  70. If OpenChatCut helps you, you can support its continued development on Ko-fi or Afdian.
  71. <p align="center">
  72. <a href="https://ko-fi.com/Y5N2241IP5">
  73. <img alt="Support me on Ko-fi" src="https://img.shields.io/badge/Support_me_on-Ko--fi-72a4f2?logo=kofi&amp;logoColor=white" />
  74. </a>
  75. <a href="https://www.ifdian.net/a/sline?utm_source=copylink&amp;utm_medium=link">
  76. <img alt="Support OpenChatCut on Afdian" src="https://img.shields.io/badge/Support_on-Afdian-946CE6" />
  77. </a>
  78. </p>
  79. ---
  80. ## What is OpenChatCut?
  81. OpenChatCut is an **open-source ChatCut alternative**: a video editor that brings **conversational agents** and **professional timeline editing** into the same workspace. It is independent open source (AGPL), not affiliated with the commercial ChatCut product.
  82. **OpenChatCut = local video projects + multitrack timeline + AI agents + MCP + production-ready exports.**
  83. It does not merely generate a video that can no longer be changed. Every edit is written to real tracks, clips, transitions, captions, effects, and media inside the project. You can continue editing manually, undo or redo changes, save versions, or hand the project to another agent.
  84. OpenChatCut is built for creators and developers who want AI to participate in the actual editing workflow without giving up professional control, rather than starting over from an empty chat box or an immutable generated result.
  85. - Website: [https://openchatcut.com](https://openchatcut.com)
  86. - Open-source ChatCut alternative guide: [https://openchatcut.com/blog/open-source-chatcut-alternative](https://openchatcut.com/blog/open-source-chatcut-alternative)
  87. - ChatCut vs OpenChatCut: [https://openchatcut.com/blog/chatcut-vs-openchatcut](https://openchatcut.com/blog/chatcut-vs-openchatcut)
  88. - 🤖 **Agent-native**: the built-in agent and external MCP agents share the same editing tools.
  89. - 🎞️ **Real timeline**: multiple video and audio tracks, transitions, effects, LUTs, zooms, and keyframes.
  90. - 📝 **Transcript-driven editing**: word-level transcription, text-based cuts, pause handling, speakers, and linked captions.
  91. - ✨ **Generation and media**: images, video, speech, music, sound effects, and online media search.
  92. - 🧩 **Motion Graphics and WebGL**: editable motion templates, custom shaders, visual effects, and transitions.
  93. - 👁️ **Visual geometry**: in-browser person segmentation and face-safe zones — captions avoid the speaker automatically, reframe follows the subject, and overlay graphics land in empty space.
  94. - 📦 **Production-ready exports**: MP4, audio, captions, FCPXML, and complete project data.
  95. - 🖥️ **Local-first**: projects and media stay on your machine by default, while API keys remain server-side.
  96. ## Community
  97. Join the OpenChatCut community to discuss workflows, share feedback, and follow development:
  98. - [Join Discord](https://discord.gg/bSGUAeWYkh)
  99. - Scan the QR code below with WeChat.
  100. <p align="center">
  101. <br />
  102. <img src="assets/readme-pic/wechat-community.jpg" width="220" alt="OpenChatCut WeChat community QR code" />
  103. </p>
  104. ---
  105. ## Product Tour
  106. The following screenshots show real OpenChatCut projects and editor states, not static mockups.
  107. <table>
  108. <tr>
  109. <td width="50%" valign="top" align="center">
  110. <img src="assets/readme-pic/02-project-dashboard.png" alt="OpenChatCut local project dashboard" /><br />
  111. <sub><b>Local project management</b> — Create, import, duplicate, export, and continue editing multiple real projects.</sub>
  112. </td>
  113. <td width="50%" valign="top" align="center">
  114. <img src="assets/readme-pic/03-agent-transitions.png" alt="An agent generating music and editing transitions on a multitrack timeline" /><br />
  115. <sub><b>Complete agent-driven editing</b> — Generate music, invoke tools, and write transitions, captions, and multitrack media directly to the timeline.</sub>
  116. </td>
  117. </tr>
  118. <tr>
  119. <td width="50%" valign="top" align="center">
  120. <img src="assets/readme-pic/04-motion-graphics.png" alt="Agent tool execution history and the Motion Graphics library" /><br />
  121. <sub><b>Motion Graphics and agents</b> — Browse motion templates or let an agent generate and assemble editable MG clips.</sub>
  122. </td>
  123. <td width="50%" valign="top" align="center">
  124. <img src="assets/readme-pic/05-effects.png" alt="OpenChatCut WebGL visual effects library" /><br />
  125. <sub><b>WebGL visual effects</b> — Apply pixelation, duotone, fisheye, kaleidoscope, softening, light leaks, and more directly to clips.</sub>
  126. </td>
  127. </tr>
  128. <tr>
  129. <td width="50%" valign="top" align="center">
  130. <img src="assets/readme-pic/06-zoom.png" alt="OpenChatCut camera movement and zoom effects library" /><br />
  131. <sub><b>Camera movement and zoom</b> — Push, pull, slow zoom, fast zoom, and eased camera effects work directly with the timeline.</sub>
  132. </td>
  133. <td width="50%" valign="top" align="center">
  134. <img src="assets/readme-pic/07-lut.png" alt="Comparing LUT color styles in OpenChatCut using a Tokyo Tower reference image" /><br />
  135. <sub><b>LUTs and color styles</b> — Compare camera transforms and film looks in real time against a consistent reference frame.</sub>
  136. </td>
  137. </tr>
  138. </table>
  139. ---
  140. ## Why OpenChatCut?
  141. Traditional editors excel at precise control. One-shot AI video generators excel at producing results quickly. OpenChatCut connects both approaches through one continuously editable project:
  142. | Capability | Traditional timeline editor | One-shot AI video generation | **OpenChatCut** |
  143. |---|:---:|:---:|:---:|
  144. | Track- and clip-level precision | ✅ | ❌ | **✅** |
  145. | Modify a project with natural language | ❌ | ✅ | **✅** |
  146. | Inspectable and undoable changes | ✅ | Usually unavailable | **✅** |
  147. | Linked transcript and visuals | Partial | ❌ | **✅** |
  148. | Direct control from Codex / Claude Code | ❌ | ❌ | **✅ MCP** |
  149. | Built-in and external agent collaboration | ❌ | ❌ | **✅ Shared tools** |
  150. | Local projects and BYOK | Product-dependent | Usually cloud-based | **✅** |
  151. The core editing loop:
  152. ```text
  153. Describe the goal → Agent reads the project → Produces verifiable edits → Writes to the timeline
  154. → Preview / adjust / undo → Captions and mixing → Export
  155. ```
  156. ---
  157. ## Core Capabilities
  158. | Area | Implemented capabilities |
  159. |---|---|
  160. | Timeline | Multitrack editing, move, trim, split, ripple edits, snapping, keyframes, markers, undo, and redo |
  161. | Visuals | WebGL effects, LUTs, chroma key, zoom, transitions, and custom shaders |
  162. | Audio | Multiple audio tracks, sound effects, background music, voice-over recording, loudness, auto-ducking, and vocal isolation |
  163. | Transcript | Transcription jobs, word-level editing, pause compression, search, speakers, and clip views |
  164. | Captions | Automatic captions, named styles, translation, timeline overlays, and SRT export |
  165. | Motion Graphics | Built-in templates, a secure sandbox, custom templates, and video rendering |
  166. | AI generation | Image, video, speech, music, and sound-effect jobs with progress tracking |
  167. | Media | Uploads, folders, online image/video/audio search, and Firecrawl visual-media fallback |
  168. | Export | MP4, audio, captions, FCPXML, project import/export, export history, hardware-aware H.264 acceleration, and resource-aware export queueing |
  169. | Publishing | Agent-driven publishing of finished renders to TikTok, Instagram, YouTube, LinkedIn, Facebook, X, Threads, Pinterest, and Bluesky via Upload-Post, with a preview and explicit confirmation first |
  170. | Agent | Built-in conversational agent, skills, proposal-based edits, and external Streamable HTTP MCP |
  171. ---
  172. ## Community Resources
  173. The [OpenChatCut resource library](https://openchatcut.com/resources) is a shared catalog for reusable MG animations, sound effects, transitions, visual effects, zooms, and LUTs.
  174. <p align="center">
  175. <a href="https://openchatcut.com/resources">
  176. <img src="assets/readme-pic/08-community-resources.en.png" alt="OpenChatCut community resource library" />
  177. </a>
  178. </p>
  179. ### Discover and install
  180. - Hover visual cards to watch the complete result, or play audio resources before downloading.
  181. - Copy a resource's install URL into OpenChatCut's Extension Center, or download its original package.
  182. - Browse the website catalog inside the editor and manage installed extensions locally.
  183. ### Contribute a resource
  184. 1. Open [Contribute a resource](https://openchatcut.com/resources/submit) and choose its category.
  185. 2. Upload the resource and the category-specific preview inputs; the site renders the published preview.
  186. 3. Add the creator and license information, then submit it for review and publication.
  187. Installable visual resources use the editor's `openchatcut-plugin@1` format and runtime validation. Official OpenChatCut resources use the MIT license; community contributors select a license during submission, and each published card identifies its creator and license.
  188. ---
  189. ## Use Cases
  190. - **Talking-head and interview editing**: transcribe audio or video, remove mistakes, pauses, and repetition through text, then generate captions automatically.
  191. - **Fast multiformat assembly**: import video, images, and audio, then let an agent create the rough cut, transitions, soundtrack, and pacing.
  192. - **Short-form and social content**: reframe the canvas and generate titles, captions, voice-over, music, and visual packaging.
  193. - **Motion Graphics**: use built-in templates or ask an agent to create editable motion-graphics clips.
  194. - **Developer automation**: use MCP to let Codex, Claude Code, or another compatible client inspect and modify a real project.
  195. ## Workflow
  196. 1. Create a project and import local media.
  197. 2. Edit manually on the timeline or describe the result you want.
  198. 3. The agent reads project context and invokes editing tools.
  199. 4. Review the proposal and preview the result, then apply, adjust, or undo it.
  200. 5. Finish captions, audio, effects, and color.
  201. 6. Export video, audio, captions, FCPXML, or the complete project.
  202. ---
  203. ## Quick Start
  204. ### Desktop installers
  205. Download the latest macOS, Windows, and Linux builds from [GitHub Releases](https://github.com/0xsline/OpenChatCut/releases/latest). The release currently includes DMG installers for Apple Silicon and Intel Macs, an x64 Windows installer, and an x64 Linux AppImage.
  206. These are early builds. The macOS packages are not yet signed or notarized, so the operating system may require manual approval on first launch.
  207. ### Run from source
  208. Requires Node.js 24.x and npm. The supported Node.js range is enforced by `package.json`, and `.nvmrc` selects the matching major version for Node version managers.
  209. On Linux x64, `npm install` also downloads ONNX Runtime's optional CUDA provider (several hundred MB from NuGet). For a CPU-only install, run `ONNXRUNTIME_NODE_INSTALL=skip npm install` instead.
  210. ```bash
  211. git clone https://github.com/0xsline/OpenChatCut.git
  212. cd OpenChatCut
  213. npm install
  214. cp .env.example .env.local
  215. npm run dev
  216. ```
  217. Open:
  218. ```text
  219. http://localhost:5199
  220. ```
  221. The editor needs a browser [secure context](https://developer.mozilla.org/en-US/docs/Web/Security/Defenses/Secure_Contexts): open OpenChatCut at `http://localhost` or `http://127.0.0.1` on the machine running it, or serve it over HTTPS. Over plain HTTP from another device (a LAN IP or reverse proxy), browsers disable Web Crypto, WebCodecs, and the clipboard, so the project list still loads but the editor shows this requirement instead of opening.
  222. Only add the model or media-service credentials you actually use to `.env.local`. Features without configured third-party credentials report the missing key explicitly; local timeline editing, built-in media, and other configured capabilities continue to work.
  223. Development launches are isolated per Git checkout/worktree by default. `npm run dev` and
  224. `npm run desktop:dev` keep that checkout's projects, imported media, generation jobs,
  225. credentials, settings, and local authorization state under its own profile in
  226. `~/.openchatcut/dev-profiles/`. Use `npm run dev:shared` only when you intentionally need
  227. the legacy shared development store.
  228. ### Built-in Agent authentication
  229. - **API keys:** open **Settings → Agent model**, choose a provider, and save its API key and model. Keys remain server-side.
  230. - **ChatGPT subscription:** install the official Codex CLI 0.146.0 or newer, then open **Settings → Agent model → OpenAI · Codex**. Sign in through the browser or device-code flow, load the account's models, choose a model-specific reasoning effort (or keep its default), and select Codex from the chat model picker. OpenChatCut uses a dedicated Codex profile; the official CLI owns credential storage, token renewal, and logout, while OAuth tokens are never exposed to the browser.
  231. - **Claude subscription:** OpenChatCut does not collect Claude OAuth credentials. Use Claude Code through the local MCP connection below. The built-in Agent can use Anthropic through an API key.
  232. The built-in Agent always runs the model loop on the local server. Chat, drafts, and proposals survive page refreshes and local service restarts. Timeline changes still go through the active editor's validated, undoable commands.
  233. ### Agent local-path access (advanced)
  234. Desktop agents can browse any local directory allowed by the operating system by default, including mounted media drives. `browse_local_media` lists folders and supported media, searches by filename or relative path and media type, and returns paginated results without importing. The agent can then use `import_assets` for up to 100 selected paths, `import_asset` for one path, or `import_folder` for a whole folder. Imports reuse media probing and reference registration, preserve source files, and skip duplicate content, including duplicates within one batch. Document files such as TXT, Markdown, DOCX, and PDF should be attached to chat instead. In the desktop app these tools are enabled by default; in a browser session they also work, but only for directories listed in `AGENT_IMPORT_ROOTS` and while the editor is served from the same machine that runs OpenChatCut.
  235. To restrict local access, set a comma-separated value such as `AGENT_IMPORT_ROOTS=/Volumes/Media,D:\Projects` in `.env.local`; leave it empty for default unrestricted directory access in the desktop app (a browser session requires the allowlist and refuses these tools while it is empty). Explicit restrictions apply to both browsing and import. Source checkouts read the repository file at startup. Packaged desktop builds read it from Electron's user-data directory: `~/Library/Application Support/OpenChatCut/` on macOS, `%APPDATA%\OpenChatCut\` on Windows, and `$XDG_CONFIG_HOME/OpenChatCut/` (normally `~/.config/OpenChatCut/`) on Linux. Restart after editing the file.
  236. Local H.264 exports automatically prefer VideoToolbox on macOS and NVENC on compatible Windows systems, then fall back to software encoding. Tune render concurrency and the heavy-export limit with `OPENCHATCUT_RENDER_CONCURRENCY` and `OPENCHATCUT_MAX_ACTIVE_EXPORTS`, disable hardware encoding with `OPENCHATCUT_DISABLE_HARDWARE_ENCODING`, or override FFmpeg-side encoder selection with `OPENCHATCUT_H264_ENCODER`; see [`.env.example`](.env.example).
  237. On Apple Silicon, more render workers can slow down video-heavy exports even when VideoToolbox encoding is active. See [macOS render tuning](MACOS-RENDER-TUNING.md) for an M4 Max benchmark and a way to test your own workload. These measurements do not establish a default for other Macs or Windows.
  238. ### Desktop development
  239. ```bash
  240. npm run desktop:dev
  241. ```
  242. The desktop app uses an Electron shell with the same embedded services. The web development build and desktop build share project, agent, generation, and export logic.
  243. ---
  244. ## Project Status
  245. OpenChatCut is under active development. The editor, project format, and agent tools will continue to evolve. Prebuilt macOS, Windows, and Linux installers are published on [GitHub Releases](https://github.com/0xsline/OpenChatCut/releases); running from source remains the most transparent option for development and troubleshooting.
  246. The core timeline, local projects, built-in media, and manual editing do not depend on cloud services. Connected features such as AI models, online media, generation, and transcription are enabled only after you configure the corresponding services.
  247. ---
  248. ## Using OpenChatCut with Codex / Claude Code
  249. Install the single OpenChatCut Agent Skill:
  250. ```bash
  251. npx skills add 0xsline/OpenChatCut
  252. ```
  253. Then tell the agent `Set up OpenChatCut`. The installed router registers the
  254. local MCP connection and loads the editor's 26 specialized skills on demand,
  255. so the agent's skill list stays compact.
  256. Custom skills live in a user-visible directory with the same layout as
  257. `~/.codex/skills` / `~/.claude/skills`:
  258. ```text
  259. ~/.openchatcut/skills/<slug>/SKILL.md (Windows: %USERPROFILE%\.openchatcut\skills\...)
  260. ```
  261. Ask the agent to `manage_skill create` (or use the bundled *skill-creator*
  262. workflow) and it writes the SKILL.md there — editable and shareable by hand.
  263. Dropping a SKILL.md into that directory makes it available to the agent, and
  264. selecting a workflow from the chat's `/` command or the creative-mode picker
  265. activates it for the next message.
  266. OpenChatCut exposes a Streamable HTTP MCP endpoint:
  267. ```text
  268. http://localhost:5199/api/external-mcp/mcp
  269. ```
  270. The repository's root `.mcp.json` already contains the local connection. Before using timeline tools, run OpenChatCut and open the target project. Project listing, creation, and navigation tools do not require the editor to remain open.
  271. Codex app/CLI and Claude Code use the same session workflow:
  272. 1. Call `begin_edit_session` and keep the returned `editSessionId`. Set `approvalMode` to `manual` (the default) or `auto`.
  273. 2. Pass that id to every project read/edit tool. Changes are applied only to an isolated draft.
  274. 3. Call `review_edit_session` when the draft is ready.
  275. 4. In `manual` mode, review, preview, select, and approve or reject the proposal inside the open OpenChatCut project. In `auto` mode, `review_edit_session` applies the complete draft immediately. The client can poll `get_edit_session` for `applied`, `rejected`, or `discarded` status.
  276. Approval in Codex or Claude controls whether the client may call a tool. OpenChatCut project approval is required only for `manual` sessions; `auto` sessions explicitly bypass that review. Either mode commits the applied operations atomically as one undo step.
  277. If an `auto` session becomes stale, it returns an error instead of falling back to manual approval; discard it and start a new session.
  278. Only draft-safe project read/edit tools are exposed in these sessions. Generation, export, project deletion, and other immediate side-effect tools stay unavailable because a rejected proposal could not roll them back.
  279. ### Codex
  280. Add the following to your Codex configuration:
  281. ```toml
  282. [mcp_servers.openchatcut]
  283. url = "http://localhost:5199/api/external-mcp/mcp"
  284. ```
  285. ### Claude Code
  286. ```bash
  287. claude mcp add --transport http openchatcut \
  288. http://localhost:5199/api/external-mcp/mcp
  289. ```
  290. You can then describe an editing task directly to the agent:
  291. ```text
  292. Start an OpenChatCut edit session. Read the draft, add a scratch sound effect
  293. at 8 seconds on the second audio track, and add a glitch transition between
  294. the adjacent video clips. Submit the draft for review and wait for the user to
  295. approve it in OpenChatCut before reporting that the edit was applied.
  296. ```
  297. External agents invoke the same internal editing tools and `EditorCore` commands as the editor itself. There are no separate project formats that can drift apart, and the live timeline is not changed while an external draft is being prepared.
  298. ### Qoder
  299. Qoder is one-click too: the guide's **Connect** button writes the endpoint and
  300. bearer token into Qoder's own settings file, keeping any unrelated settings and
  301. MCP servers already there.
  302. ```text
  303. ~/.qoder/settings.json (international build)
  304. ~/.qoder-cn/settings.json (China build — written as well when installed)
  305. ```
  306. ```json
  307. {
  308. "mcpServers": {
  309. "openchatcut": {
  310. "type": "http",
  311. "url": "http://localhost:5199/api/external-mcp/mcp",
  312. "headers": { "Authorization": "Bearer <token>" }
  313. }
  314. }
  315. }
  316. ```
  317. Restart Qoder afterwards to load the server.
  318. ### Qwen Work (千问办公)
  319. 千问办公 keeps custom MCP servers inside its own connector store rather than a
  320. config file, so OpenChatCut cannot write this one for you. In the guide, use
  321. **Copy config** on the 千问办公 card, then in 千问办公 open
  322. 连接器 → 自定义 MCP → 添加, paste the JSON, and save:
  323. ```json
  324. {
  325. "mcpServers": {
  326. "openchatcut": {
  327. "type": "streamable-http",
  328. "url": "http://localhost:5199/api/external-mcp/mcp",
  329. "headers": { "Authorization": "Bearer <token>" }
  330. }
  331. }
  332. }
  333. ```
  334. ### Protecting MCP access
  335. When exposing the MCP endpoint yourself, configure:
  336. ```bash
  337. OPENCHATCUT_MCP_TOKEN=your-token
  338. OPENCHATCUT_EDITOR_URL=https://your-editor.example.com
  339. ```
  340. Clients must send `Authorization: Bearer <token>`. The current bridge is designed for a single user on one machine, not as a multi-tenant service.
  341. ---
  342. ## Architecture
  343. <p align="center">
  344. <img src="assets/readme-pic/openchatcut-runtime.en.svg" alt="OpenChatCut runtime architecture connecting agents, MCP, EditorCore, local storage, preview, rendering, and export" />
  345. </p>
  346. <p align="center">
  347. <sub>One shared set of agent tools and EditorCore commands connects the built-in agent, external MCP clients, the real timeline, local data, and production exports.</sub>
  348. </p>
  349. | Layer | Technology |
  350. |---|---|
  351. | Frontend | React 19, TypeScript 6, Vite 8 |
  352. | Editing core | Immutable timeline state, command layer, and proposal-based application |
  353. | Agent | Vercel AI SDK 7 (Anthropic, OpenAI, Gemini, Kimi, Qwen, GLM, DeepSeek, MiniMax, Xiaomi MiMo, Mistral, xAI Grok by API key or SuperGrok/X Premium+ subscription sign-in, OpenRouter, OrcaRouter, OFox, Requesty, Cheaper Inference, Runcrate, and compatible APIs), Agent Skills, MCP SDK |
  354. | Preview and visuals | Remotion Player, WebGL / GLSL |
  355. | Server | Dual-host Vite / Electron plugins and a server-side keystore |
  356. | Persistence | Shared local project store under `~/.openchatcut`, IndexedDB cache, configurable local media directory, optional Cloudflare R2 |
  357. | Desktop | Electron 43 |
  358. | Export | Remotion, FFmpeg, FCPXML, SRT |
  359. ### Directory Overview
  360. | Directory | Responsibility |
  361. |---|---|
  362. | `src/editor/` | Timeline state and commands, independent of UI and LLMs |
  363. | `src/agent/` | Agent assembly, tools, skills, progress, and settings |
  364. | `src/library/` | Library UI for Motion Graphics, sound effects, transitions, effects, LUTs, and more |
  365. | `src/transcript/` | Transcription, word-level editing, and transcript UI |
  366. | `src/captions/` | Caption models, styles, controls, and preview layer |
  367. | `src/gl/` | WebGL effects, transitions, and shader runtime |
  368. | `src/generate/` | Clients for image, video, speech, music, and sound-effect generation |
  369. | `src/persist/` | Project, chat, version, and media persistence |
  370. | `server/plugins/` | Generation, transcription, media, export, and storage services |
  371. | `desktop/` | Electron main process and embedded services |
  372. | `remotion/` | Headless rendering and export pipeline |
  373. ---
  374. ## Data and Privacy
  375. - Projects, chat history, and version data are stored in the shared local store under `~/.openchatcut`; IndexedDB provides a browser-side cache and legacy-data migration.
  376. - User media is stored in a local media directory that you can back up or migrate.
  377. - Whether AI requests leave your machine depends on the model, generation, or media services you configure.
  378. - Unconfigured cloud features do not affect the local timeline or editing of existing media.
  379. - When exposing MCP externally, configure a Bearer Token and restrict network access to the editor endpoint.
  380. ---
  381. ## Security Model
  382. - API keys are only available to server-side configuration; vendor credentials must never be exposed to the browser through `VITE_`.
  383. - LLM output, plugin packages, template code, and user input are validated at trust boundaries.
  384. - Motion Graphics and shader code run in a restricted sandbox, with dedicated checks blocking malicious templates.
  385. - Agents modify projects only through `EditorCore` commands, making edits traceable and undoable.
  386. - MCP binds locally by default; public endpoints support Bearer Token authentication.
  387. - Local media directories and R2 credentials are managed by the server and never written into project JSON.
  388. ---
  389. ### Fal.ai image and video generation
  390. Fal.ai is an optional generation provider with an explicit image/video model catalog.
  391. Configure it under **Settings → AI Generation → Image or Video → Fal.ai**.
  392. See [Fal setup, supported models, and extension guide](FAL.md) for supported modes,
  393. server-only credentials, and checks that do not spend generation credits.
  394. ## Development and Verification
  395. ```bash
  396. # Type checking and production build
  397. npm run build
  398. # Core regression checks
  399. npm test
  400. # Static analysis
  401. npm run lint
  402. ```
  403. After changing the agent, timeline, preview, or export paths, run at least:
  404. ```bash
  405. npx tsc -b --force
  406. npm test
  407. npm run build
  408. ```
  409. ---
  410. ## Technical Foundations
  411. OpenChatCut is built with the following core projects and specifications:
  412. | Project / specification | Role in OpenChatCut |
  413. |---|---|
  414. | [ChatCut-Inc/agent-plugin](https://github.com/ChatCut-Inc/agent-plugin) | Agent Skills foundation. OpenChatCut adapts the plugin's skill structure and workflows for its local editor, storage, MCP, and tool architecture. See the [Agent Skills attribution notice](src/agent/skills/NOTICE.md). |
  415. | [Remotion](https://www.remotion.dev/) | Core foundation for React-based video preview, composition, and server-side rendering. |
  416. | [Model Context Protocol](https://modelcontextprotocol.io/) | Protocol foundation that enables Codex, Claude Code, and other external agents to access projects and timeline tools. |
  417. | [Vercel AI SDK](https://ai-sdk.dev/) | Provider-neutral model streaming and tool calling for the built-in Agent. |
  418. | [tt-a1i/archify](https://github.com/tt-a1i/archify) | Tool used to define, validate, and generate the README's runtime architecture diagram. |
  419. JianYing / CapCut draft export is powered by [capcut-cli](https://github.com/renezander030/capcut-cli).
  420. This list covers the project's major technical foundations. It does not replace the licenses bundled with individual dependencies, fonts, or binaries. See `package-lock.json` for JavaScript dependency versions and [`assets/fonts/LICENSES.md`](assets/fonts/LICENSES.md) for font licenses.
  421. ---
  422. ## Changelog
  423. See the bilingual [`CHANGELOG.md`](CHANGELOG.md) for notable changes, or browse all published packages on [GitHub Releases](https://github.com/0xsline/OpenChatCut/releases).
  424. ---
  425. ## Star Growth
  426. <p align="center">
  427. <a href="https://www.star-history.com/?type=date&repos=0xsline%2FOpenChatCut">
  428. <picture>
  429. <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=0xsline/OpenChatCut&type=date&theme=dark&legend=top-left&sealed_token=KKfeYtGGCjyG1QN9_Ev6Tvyyrcp5LW6bzOT8ZKED1EE0qNRqM3KrThzzbXWdcP6K-sr3vKbmoFZYDviSMtf8SI5UqAPYQf9v8qXCpM04S2C4LQTAKPbexT66SI3Q8pcHJJoMT7VCZnGp93LqIXZchAyYfTMmKy_y_LFOJ-_ruEq8GP1kVESXshaFzJfC" />
  430. <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=0xsline/OpenChatCut&type=date&legend=top-left&sealed_token=KKfeYtGGCjyG1QN9_Ev6Tvyyrcp5LW6bzOT8ZKED1EE0qNRqM3KrThzzbXWdcP6K-sr3vKbmoFZYDviSMtf8SI5UqAPYQf9v8qXCpM04S2C4LQTAKPbexT66SI3Q8pcHJJoMT7VCZnGp93LqIXZchAyYfTMmKy_y_LFOJ-_ruEq8GP1kVESXshaFzJfC" />
  431. <img alt="OpenChatCut Star History Chart" src="https://api.star-history.com/chart?repos=0xsline/OpenChatCut&type=date&legend=top-left&sealed_token=KKfeYtGGCjyG1QN9_Ev6Tvyyrcp5LW6bzOT8ZKED1EE0qNRqM3KrThzzbXWdcP6K-sr3vKbmoFZYDviSMtf8SI5UqAPYQf9v8qXCpM04S2C4LQTAKPbexT66SI3Q8pcHJJoMT7VCZnGp93LqIXZchAyYfTMmKy_y_LFOJ-_ruEq8GP1kVESXshaFzJfC" />
  432. </picture>
  433. </a>
  434. </p>
  435. ---
  436. ## License
  437. OpenChatCut is licensed under the [GNU Affero General Public License v3.0 or later](LICENSE).
  438. Third-party components and assets remain subject to their respective licenses.
  439. ---
  440. ## Web research in the built-in agent
  441. `web_search` and basic `web_browser` page reading use Firecrawl, which needs a
  442. `FIRECRAWL_API_KEY`. To use [Parallel Search MCP](https://docs.parallel.ai/integrations/mcp/search-mcp)
  443. instead, which needs no account or API key, set `WEB_SEARCH_PROVIDER=parallel` in
  444. `.env.local` and restart. Parallel search returns source URLs, titles and relevant
  445. excerpts; its page reading returns markdown excerpts rather than full-page HTML or
  446. screenshots. Queries and requested URLs are sent to the selected provider. Anonymous
  447. access has service quotas; provider errors are returned without switching providers.
  448. Leaving `WEB_SEARCH_PROVIDER` empty or setting `firecrawl` keeps Firecrawl, and
  449. `disabled` turns basic search and page reading off. A tool call can pick
  450. `provider: "firecrawl"`, and `"parallel"` only once Parallel is enabled. Search
  451. locale and time filters, screenshots, browser actions, structured extraction,
  452. full-page formats, mapping, crawling and batch scraping always need Firecrawl and its key.
  453. Related search and page-reading calls reuse an opaque conversation ID. Clearing
  454. the chat starts a new ID; the project ID and chat text are never used as that ID.
  455. ## Contributing
  456. 1. Create a branch from `main`.
  457. 2. Add an executable check for non-trivial logic.
  458. 3. Run `npm test`, `npm run lint`, and `npm run build` before committing.
  459. 4. Open a Pull Request and include screenshots or acceptance evidence for UI or video-behavior changes.
  460. Use [GitHub Issues](https://github.com/0xsline/OpenChatCut/issues) for bug reports and feature requests.

Ratings and comments

Sign in to rate this skill.

Sign in

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