# openchatcut

Adopt this skill: https://proskills.md/skills/other/0xsline-openchatcut-skills-openchatcut

Page: https://proskills.md/skills/other/0xsline-openchatcut-skills-openchatcut
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: skills/openchatcut/SKILL.md
size: 2619
sha: f75149df76dc05075066740d9c8b40d5beacd548
upstream: https://github.com/0xsline/openchatcut/blob/main/skills/openchatcut/SKILL.md

````text
---
name: openchatcut
description: Connect an MCP-capable coding agent to OpenChatCut and edit local video projects. Use when the user asks to install, connect, or set up OpenChatCut; inspect or edit an OpenChatCut project; work with its timeline, transcript, captions, media, generation, motion graphics, audio, color, or export tools; or recover from an OpenChatCut MCP error.
---

# OpenChatCut

OpenChatCut is a local-first, agent-native video editor. This skill is the
single external entry point; specialized editing guidance remains inside the
running editor and is loaded on demand with `load_skill`.

## Route the task

- Install, connect, or diagnose the MCP server: read
  `references/getting-started.md`.
- Inspect or modify a project: read `references/editing-workflow.md`.
- Recover from a failed tool call, stale session, or missing editor:
  read `references/known-errors.md`.

## Essentials

1. Start OpenChatCut before connecting. The default MCP endpoint is
   `http://localhost:5199/api/external-mcp/mcp`.
2. Call `openchatcut_status`, then `list_projects`. Select a project only when
   the user names it or the current context identifies it.
3. Call `load_skill` before specialized work. It is read-only and requires
   neither `begin_edit_session` nor `editSessionId`; available names and support
   files come from the live MCP tool description.
   With progressive exposure enabled, this call reveals the skill's referenced
   tools and emits `tools/list_changed`; refresh the list before continuing.
4. Before project reads or edits, call `begin_edit_session`. Keep its
   `editSessionId` and pass it to every draft-safe editor tool.
5. Set `reuseExisting: true` on `begin_edit_session` to reuse your active draft
   or adopt an unchanged orphan. Existing operations and approval mode are kept.
   If reuse is rejected, call `list_edit_sessions`. Use `recover_edit_session`
   only with a listed `recoveryActions` value; another online owner must finish
   or discard its own session.
6. Use `approvalMode: "manual"` unless the user explicitly asks for unattended
   application. In manual mode, the user approves the complete proposal in
   OpenChatCut. In auto mode, `review_edit_session` applies the complete draft.
7. Finish with `review_edit_session`. Report success only after
   `get_edit_session` returns `applied`.

## Skill version

`2026-09-04.1`

The OpenChatCut MCP server announces its required skill baseline. If the server
baseline is newer, run:

```bash
npx skills update openchatcut
```

Fallback command:

```bash
npx skills add 0xsline/OpenChatCut --skill openchatcut
```
````

## File: skills/openchatcut/references/editing-workflow.md
size: 1891
sha: c4b9eaf2dc22d4c81ecdd0ca9c60c79ed19ee07d
upstream: https://github.com/0xsline/openchatcut/blob/main/skills/openchatcut/references/editing-workflow.md

```text
# Edit an OpenChatCut project

## Start with current state

1. Call `openchatcut_status`.
2. Call `list_projects` when the project is not already identified.
3. Call `target_project` with the selected project ID.
4. When specialized guidance applies, call `load_skill`; it requires no edit
   session or `editSessionId`.
5. Call `begin_edit_session` and keep the returned `editSessionId`.
6. Call `read_project` with that session ID before the first mutation.

Use `approvalMode: "manual"` by default. Use `"auto"` only when the user asks
for an unattended, atomic application.

## Load specialized guidance

Call `load_skill` after targeting the project and before specialized work. Common skill names include:

- `talking-head-guide`
- `transcription`
- `create-motion-graphics`
- `image-gen`
- `video-gen`
- `voice`
- `music`
- `shader-gen`
- `export`
- `verification`

Treat the live `load_skill` tool description as the current catalog. If a
loaded skill lists support files, request the relevant one with its `file`
argument.

## Apply edits

- Use IDs returned by `read_project`, discovery tools, or prior receipts.
- Keep every editor call in the same edit session.
- Re-read the project after a failed mutation or when the timeline may be
  stale.
- Use `view_timeline_frames`, `inspect_color`, or the verification skill after
  visual edits.
- Keep generation and other immediate side effects outside a proposal unless
  the exposed tool explicitly supports the draft session.

## Review and finish

1. Call `review_edit_session` after all draft edits are ready.
2. For manual mode, tell the user the proposal is ready inside OpenChatCut.
3. Poll `get_edit_session` when the client needs the final state.
4. Report completion only when the status is `applied`.
5. If the status is `rejected` or `discarded`, report that exact result.

Applied operations form one atomic undo step.
```

## File: skills/openchatcut/references/getting-started.md
size: 3273
sha: 36c21f10b9c314b0e555863f122bd58f3886cf0e
upstream: https://github.com/0xsline/openchatcut/blob/main/skills/openchatcut/references/getting-started.md

````text
# Connect OpenChatCut

Use this flow when the user says “set up OpenChatCut”, when the `openchatcut`
MCP server is missing, or when its endpoint cannot be reached.

## 1. Find the endpoint

The default endpoint is:

```text
http://localhost:5199/api/external-mcp/mcp
```

Start OpenChatCut first. Open **Settings → MCP** in the trusted editor window,
copy the displayed bearer-token configuration, and use the endpoint shown there.
If desktop port 5199 was occupied, that page reflects the active fallback port.

## 2. Register the MCP server

### Codex

Check the existing entry:

```bash
codex mcp get openchatcut
```

If it is missing, export the token copied from **Settings → MCP** and register it:

```bash
export OPENCHATCUT_MCP_TOKEN='<token>'
codex mcp add openchatcut \
  --url http://localhost:5199/api/external-mcp/mcp \
  --bearer-token-env-var OPENCHATCUT_MCP_TOKEN
```

If an existing URL or token setting is stale, replace only that entry:

```bash
export OPENCHATCUT_MCP_TOKEN='<token>'
codex mcp remove openchatcut
codex mcp add openchatcut \
  --url http://localhost:5199/api/external-mcp/mcp \
  --bearer-token-env-var OPENCHATCUT_MCP_TOKEN
```

### Claude Code

```bash
claude mcp add --transport http \
  -H "Authorization: Bearer <token>" \
  openchatcut http://localhost:5199/api/external-mcp/mcp
```

For another client, register the endpoint as a Streamable HTTP MCP server and
set its `Authorization` header to `Bearer <token>`.
Clients that honor MCP `tools/list_changed` can reduce their initial prompt by
negotiating progressive exposure:

```text
http://localhost:5199/api/external-mcp/mcp?toolExposure=progressive
```

The equivalent request header is
`X-OpenChatCut-Tool-Exposure: progressive`. The initial list keeps connection,
session, project-read, `ToolSearch`, and `load_skill` tools. `ToolSearch` and
`load_skill` expand only that transport session's list. Clients that cache one
fixed tool list for the whole connection must use the default URL, which retains
the full compatibility surface.

## 3. Verify

When the MCP tools are available, call:

1. `openchatcut_status`
2. `list_projects`

Interpret the result:

- Editors listed: the live editor bridge is ready.
- Projects listed but no editor connected: project discovery works; open the
  intended project using its `editorUrl`.
- No projects: the connection works; ask whether to create a project.
- Connection error: follow `known-errors.md`.

Do not create or select a project just because one looks plausible.

## 4. Start the first task

Once the user has identified a project:

1. Call `target_project`.
2. Surface the URL returned by `get_editor_url`.
3. Follow `editing-workflow.md`.

## Token lifecycle

The endpoint always requires a bearer token, including on localhost. By default,
OpenChatCut generates it in private server memory and shows it only through the
trusted editor's **Settings → MCP** page. A server restart changes that generated
token, so reconnect clients using the newly displayed configuration.

`OPENCHATCUT_MCP_TOKEN` overrides the generated token when a stable deployment
secret is required. Keep it in the MCP client's secret/environment configuration;
never write it into a repository, project document, chat, or browser storage.
````

## File: skills/openchatcut/references/known-errors.md
size: 2145
sha: e89d77a2daa0f4c01c3d876c167ff27aac5ba66f
upstream: https://github.com/0xsline/openchatcut/blob/main/skills/openchatcut/references/known-errors.md

````text
# OpenChatCut MCP recovery

## Connection refused

OpenChatCut is closed, the configured URL is stale, or desktop port 5199 fell
back to another port.

1. Start OpenChatCut.
2. Read the endpoint from **Settings → MCP** or the startup log.
3. Update the single `openchatcut` MCP entry.
4. Call `openchatcut_status` again.

## Projects exist but no editor is connected

Call `get_editor_url` for the intended project and have the user open it.
Project listing and creation can work without a live editor, while timeline
tools require the target project to be open.

## Tool missing

The editor registers project tools after its bridge connects. Open the target
project, call `openchatcut_status`, and refresh the MCP tool list.

## Active edit session

`begin_edit_session` rejects an existing draft unless `reuseExisting: true` is
set. Reuse keeps the session ID, staged operations and approval mode. It can
reuse a draft owned by the same MCP transport or adopt an unchanged orphan.
It cannot take a draft from another online transport or a recovery in progress,
and it does not bypass stale-project checks.

## Stale edit session

Call `list_edit_sessions` before starting another session. For an entry marked
`orphaned: true`, call `recover_edit_session` with one of its `recoveryActions`:

- `resume` continues a draft only when its checkpoint still matches the project.
- `discard` removes the abandoned draft without changing the live project.

An online owner must finish or discard its own session. Terminal `stale`,
`cancelled`, and `failed` sessions cannot be resumed; begin a fresh session.
An auto session stays auto and does not fall back to manual review.

## Proposal awaiting review

The draft is ready, but manual approval is still pending in OpenChatCut. Keep
polling `get_edit_session` only when the client needs the final state. Report
`applied`, `rejected`, or `discarded` exactly as returned.

## Skill baseline is newer

Update the installed skill, then re-read its files:

```bash
npx skills update openchatcut
```

If the source alias is unavailable:

```bash
npx skills add 0xsline/OpenChatCut --skill openchatcut
```
````

## File: skills/openchatcut/assets/openchatcut-icon.png
size: 191822
sha: dfef9a41d00941a2340fa4f400a896bb1616b633
upstream: https://github.com/0xsline/openchatcut/blob/main/skills/openchatcut/assets/openchatcut-icon.png

Content is not inlined in the catalog. Read the upstream file: https://github.com/0xsline/openchatcut/blob/main/skills/openchatcut/assets/openchatcut-icon.png

## File: skills/openchatcut/agents/openai.yaml
size: 594
sha: 84c2450efae76ac96091928b22ec06256b60c454
upstream: https://github.com/0xsline/openchatcut/blob/main/skills/openchatcut/agents/openai.yaml

```text
interface:
  display_name: "OpenChatCut"
  short_description: "Connect and edit local OpenChatCut video projects"
  brand_color: "#7C3AED"
  icon_small: "./assets/openchatcut-icon.png"
  icon_large: "./assets/openchatcut-icon.png"
  default_prompt: "Use $openchatcut to connect to OpenChatCut and inspect the selected video project."

dependencies:
  tools:
    - type: "mcp"
      value: "openchatcut"
      description: "OpenChatCut local editor MCP server"
      transport: "streamable_http"
      url: "http://localhost:5199/api/external-mcp/mcp"

policy:
  allow_implicit_invocation: true
```

## File: README.md
upstream: https://github.com/0xsline/openchatcut/blob/main/README.md

```text
<p align="center">
  <img src="public/openchatcut-icon.png" width="96" alt="OpenChatCut" />
</p>

<h1 align="center">OpenChatCut</h1>

<p align="center">
  <a href="README_ZH.md">简体中文</a> · <strong>English</strong>
</p>

<p align="center">
  <strong>Open-source ChatCut alternative · agent-native · local-first AI video editor</strong>
</p>

<p align="center">
  Let Codex, Claude Code, and the built-in agent read, edit, and export real video projects that remain fully editable.
  Website: <a href="https://openchatcut.com">openchatcut.com</a>
</p>

<p align="center">
  <a href="https://openchatcut.com/pro"><strong>OpenChatCut Pro</strong></a> · Desktop edition: install it and start cutting
</p>

<p align="center">
  <a href="#what-is-openchatcut">Introduction</a> ·
  <a href="#product-tour">Product Tour</a> ·
  <a href="#quick-start">Quick Start</a> ·
  <a href="#using-openchatcut-with-codex--claude-code">Agent / MCP</a> ·
  <a href="#community">Community</a> ·
  <a href="#sponsors">Sponsors</a> ·
  <a href="#changelog">Changelog</a> ·
  <a href="#star-growth">Star Growth</a> ·
  <a href="#contributing">Contributing</a>
</p>

<p align="center">
  <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>
  <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>
  <img alt="Status" src="https://img.shields.io/badge/status-active_development-FF8A3D?style=flat" />
  <img alt="Local First" src="https://img.shields.io/badge/data-local_first-111827?style=flat" />
  <img alt="TypeScript" src="https://img.shields.io/badge/TypeScript-6-3178C6?style=flat&logo=typescript&logoColor=white" />
  <img alt="React" src="https://img.shields.io/badge/React-19-149ECA?style=flat&logo=react&logoColor=white" />
  <img alt="Remotion" src="https://img.shields.io/badge/Remotion-4-0B84F3?style=flat" />
  <img alt="Electron" src="https://img.shields.io/badge/Electron-43-47848F?style=flat&logo=electron&logoColor=white" />
  <img alt="MCP" src="https://img.shields.io/badge/MCP-Agent_native-7C3AED?style=flat" />
  <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>
</p>

<p align="center">
  <a href="https://linux.do" alt="LINUX DO"><img src="https://shorturl.at/ggSqS" /></a>
</p>

<p align="center">
  <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>
</p>

<p align="center">
  <img src="assets/readme-pic/01-editor-overview.png" alt="OpenChatCut editor overview with the agent workspace, media pool, preview, and multitrack timeline" />
</p>

<p align="center">
  <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>
</p>

---
## Sponsors

<p align="center">
  <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>
</p>

**OfoxAI: Text, image, and video AI in one platform**

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.

[Explore OfoxAI models and APIs →](https://ofox.ai/?utm_source=github&utm_medium=sponsorship&utm_content=openchatcut)

<br />

<p align="center">
  <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>
</p>

**[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**

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.

**[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.

[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)

<br />

If OpenChatCut helps you, you can support its continued development on Ko-fi or Afdian.

<p align="center">
  <a href="https://ko-fi.com/Y5N2241IP5">
    <img alt="Support me on Ko-fi" src="https://img.shields.io/badge/Support_me_on-Ko--fi-72a4f2?logo=kofi&amp;logoColor=white" />
  </a>
  <a href="https://www.ifdian.net/a/sline?utm_source=copylink&amp;utm_medium=link">
    <img alt="Support OpenChatCut on Afdian" src="https://img.shields.io/badge/Support_on-Afdian-946CE6" />
  </a>
</p>

---

## What is OpenChatCut?

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.

**OpenChatCut = local video projects + multitrack timeline + AI agents + MCP + production-ready exports.**

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.

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.

- Website: [https://openchatcut.com](https://openchatcut.com)
- Open-source ChatCut alternative guide: [https://openchatcut.com/blog/open-source-chatcut-alternative](https://openchatcut.com/blog/open-source-chatcut-alternative)
- ChatCut vs OpenChatCut: [https://openchatcut.com/blog/chatcut-vs-openchatcut](https://openchatcut.com/blog/chatcut-vs-openchatcut)

- 🤖 **Agent-native**: the built-in agent and external MCP agents share the same editing tools.
- 🎞️ **Real timeline**: multiple video and audio tracks, transitions, effects, LUTs, zooms, and keyframes.
- 📝 **Transcript-driven editing**: word-level transcription, text-based cuts, pause handling, speakers, and linked captions.
- ✨ **Generation and media**: images, video, speech, music, sound effects, and online media search.
- 🧩 **Motion Graphics and WebGL**: editable motion templates, custom shaders, visual effects, and transitions.
- 👁️ **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.
- 📦 **Production-ready exports**: MP4, audio, captions, FCPXML, and complete project data.
- 🖥️ **Local-first**: projects and media stay on your machine by default, while API keys remain server-side.

## Community

Join the OpenChatCut community to discuss workflows, share feedback, and follow development:

- [Join Discord](https://discord.gg/bSGUAeWYkh)
- Scan the QR code below wi
```
