diff --git a/README.md b/README.md index 5625fd3..d2f84a5 100644 --- a/README.md +++ b/README.md @@ -1,22 +1,73 @@ -# ChatCut Agent Plugins -**ChatCut is an AI video editor for agents: an MCP server and plugin that lets Codex, ChatGPT, Claude Code, Cursor, Grok Bot, Gemini CLI, Google Antigravity, Kimi Work, WorkBuddy, Doubao Work and Qwen Work edit your own footage, add captions and subtitles, remove silences and filler words, create motion graphics, generate video, voiceovers and music, and export an editable timeline.**\ -[Website](https://chatcut.io) · [Setup guide](https://chatcut.io/desktop) · [ChatGPT and Codex](https://chatcut.io/chatgpt-plugin) · [Claude Code](https://chatcut.io/claude-code-plugin) · [Pricing](https://chatcut.io/pricing) +

ChatCut AI Video Editor

-[![ChatCut MCP server on Glama](https://glama.ai/mcp/connectors/io.chatcut/chatcut/badges/score.svg)](https://glama.ai/mcp/connectors/io.chatcut/chatcut) +

+ ChatCut — #1 Product of the Day on Product Hunt +

-AI video editing for your agent. The ChatCut Agent Plugins connect Codex, Claude Code, Grok Bot, Cursor, Google Antigravity, Kimi Work, WorkBuddy, Doubao Work and Qwen Work to ChatCut, so you can ask your agent to edit a video, add captions, clean up a talking-head recording, or recreate a viral video with your own footage, and get an editable timeline back. +

+ GitHub stars + Latest release + License + Discord members + ChatCut MCP server on Glama +

-Under the hood the plugins import media, change a project timeline, create motion graphics, generate assets, transcribe audio, add captions, export videos, and verify that edits are visible in the editor. +**ChatCut is an AI video editor for agents: an MCP server and plugin that lets Codex, ChatGPT, Claude Code, Cursor, Grok Bot, Gemini CLI, Google Antigravity, Kimi Work, WorkBuddy, Doubao Work and Qwen Work edit your own footage, add captions and subtitles, remove silences and filler words, create motion graphics, generate video, voiceovers and music, and export an editable timeline.** -## Quick install +
-**ChatCut Desktop (recommended).** Paste this into Codex, the ChatGPT desktop app, Claude Code or another local agent. The agent installs ChatCut Desktop, opens sign-in, and connects itself to Desktop's local `chatcut_desktop` MCP server: +[Website](https://chatcut.io/?utm_source=github&utm_medium=readme&utm_campaign=agent-plugin) · [Skills](https://chatcut.io/skills?utm_source=github&utm_medium=readme&utm_campaign=agent-plugin) · [Docs](https://chatcut.io/docs?utm_source=github&utm_medium=readme&utm_campaign=agent-plugin) · [Setup guide](https://chatcut.io/desktop?utm_source=github&utm_medium=readme&utm_campaign=agent-plugin) · [Pricing](https://chatcut.io/pricing?utm_source=github&utm_medium=readme&utm_campaign=agent-plugin) · [Discord](https://discord.com/invite/sMjQPvwZTT) · [X](https://x.com/chatcutapp) -```text -Read ChatCut.io/desktop to install ChatCut -``` +**Works with** + +[Codex](https://chatcut.io/chatgpt-plugin?utm_source=github&utm_medium=readme&utm_campaign=agent-plugin) +[ChatGPT](https://chatcut.io/chatgpt-plugin?utm_source=github&utm_medium=readme&utm_campaign=agent-plugin) +[Claude Code](https://chatcut.io/claude-code-plugin?utm_source=github&utm_medium=readme&utm_campaign=agent-plugin) +[Grok Bot](https://chatcut.io/grok-plugin?utm_source=github&utm_medium=readme&utm_campaign=agent-plugin) +[Google Antigravity](https://chatcut.io/antigravity-plugin?utm_source=github&utm_medium=readme&utm_campaign=agent-plugin) +[WorkBuddy](https://chatcut.io/workbuddy?utm_source=github&utm_medium=readme&utm_campaign=agent-plugin)
+[Cursor](#web-setup) +[Gemini CLI](#web-setup) +[Kimi Work](./kimi/README.md) +[Doubao Work](./doubao/README.md) +[Qwen Work](./qwen/README.md) + +
+ +

ChatCut demo: Viral Video Cloner, Speech Cleanup, Add captions, Talking-Head Edit Recreation and two MG Packaging styles

+ +

+ Speech Cleanup: removes retakes, long pauses and slips + Viral Video Cloner: keeps a viral video's moves, camera work and cuts, and swaps in your own people, product and setting + Add captions: readable captions in a style that fits + Talking-Head Edit Recreation: recreates a reference edit with your footage + MG Packaging · Runway Rebel: packages your talking-head video in bold white type and slim yellow numerals + MG Packaging · Editorial Explainer: packages your talking-head video with news-style motion graphics and data charts +

+ +## Install -Or run the official installer yourself: +ChatCut's plugin (MCP) works with ChatCut Desktop on your computer (recommended; your media stays local) or with hosted ChatCut Web. Find your agent below and follow its row. + +| Agent | How to install | Setup guide | +| --- | --- | --- | +| Codex | `Read ChatCut.io/desktop to install ChatCut` | [Codex guide](https://chatcut.io/chatgpt-plugin?utm_source=github&utm_medium=readme&utm_campaign=agent-plugin) | +| ChatGPT | `Read ChatCut.io/desktop to install ChatCut` in the desktop app, or open **Plugins** in the sidebar, search for **ChatCut** and select **Install** | [ChatGPT guide](https://chatcut.io/chatgpt-plugin?utm_source=github&utm_medium=readme&utm_campaign=agent-plugin) | +| Claude Code | `Read ChatCut.io/desktop to install ChatCut` | [Claude Code guide](https://chatcut.io/claude-code-plugin?utm_source=github&utm_medium=readme&utm_campaign=agent-plugin) | +| Cursor | Add ChatCut's MCP server to `~/.cursor/mcp.json` and sign in | [Cursor guide](#web-setup) | +| Grok Bot | `Read ChatCut.io/grok to connect the ChatCut app` | [Grok Bot guide](https://chatcut.io/grok-plugin?utm_source=github&utm_medium=readme&utm_campaign=agent-plugin) | +| Gemini CLI | `gemini extensions install https://github.com/ChatCut-Inc/agent-plugin` | [Gemini CLI guide](#web-setup) | +| Google Antigravity | `Read ChatCut.io/antigravity to install ChatCut` | [Antigravity guide](https://chatcut.io/antigravity-plugin?utm_source=github&utm_medium=readme&utm_campaign=agent-plugin) | +| Kimi Work | Type `/`, choose **Plugin Builder** and send it `https://github.com/ChatCut-Inc/agent-plugin/tree/main/kimi`. Install it under **Plugins → Personal** (插件 → 个人), then select **Login** on the ChatCut connector card | [Kimi Work guide](./kimi/README.md) | +| WorkBuddy | `Read ChatCut.io/desktop to install ChatCut`, or open **Experts · Skills · Connectors** (专家·技能·连接器) → **Experts** (专家), search **ChatCut**, open the official **ChatCut 视频剪辑师** expert and select **Summon** (召唤) | [WorkBuddy guide](https://chatcut.io/workbuddy?utm_source=github&utm_medium=readme&utm_campaign=agent-plugin) · [WorkBuddy expert guide](./workbuddy/README.md) | +| Doubao Work (豆包工作) | In the sidebar, open **Plugins · Skills** (插件 · 技能) → **Plugins** (插件), search **ChatCut** and open it, select **Install** (安装) on its ChatCut connector, then **Use in chat** (在对话中使用). It installs ChatCut Desktop if needed | [Doubao Work guide](./doubao/README.md) | +| Qwen Work (千问办公) | Open **Skills & extensions → Connectors → Market**, select **+** next to **ChatCut**, then **Install ChatCut** | [Qwen Work guide](./qwen/README.md) | + +### Desktop setup + +In Codex, the ChatGPT desktop app, Claude Code or another local agent, paste `Read ChatCut.io/desktop to install ChatCut`. The agent installs ChatCut Desktop, opens sign-in and connects itself to Desktop's local `chatcut_desktop` MCP server. + +To install Desktop yourself, run the official installer on the macOS or Windows computer. It needs a graphical desktop but not Node.js or npm, so a Linux or remote agent can't install Desktop there: ```sh # macOS 13 or newer (Apple Silicon or Intel) @@ -28,19 +79,17 @@ curl -fsSL https://chatcut.io/install.sh | sh irm https://chatcut.io/install.ps1 | iex ``` -In the ChatGPT or Codex desktop app you can also open **Plugins** in the sidebar, search for **ChatCut**, and select **Install**. - -Doubao Work (豆包工作) connects to ChatCut Desktop through a local connector: see [doubao/README.md](./doubao/README.md). - -Google Antigravity: install the Desktop package, then ask “Install ChatCut on this computer”. It installs and connects ChatCut Desktop only; see [antigravity-desktop/README.md](./antigravity-desktop/README.md). +Google Antigravity can also install the Desktop package directly. Then ask “Install ChatCut on this computer”. It installs and connects ChatCut Desktop only; see the [Antigravity Desktop guide](./antigravity-desktop/README.md). ```sh agy plugin install https://github.com/ChatCut-Inc/agent-plugin/tree/main/antigravity-desktop ``` -**Hosted Web plugin.** Use this for existing ChatCut Web projects or Web-only use. +### Web setup + +Web projects and their media aren't migrated to Desktop, and connecting Desktop to the same agent may replace its hosted connection. -Claude Code (`claude mcp login` needs Claude Code 2.1.210 or newer; [full guide](https://chatcut.io/web-plugin/claude)): +Claude Code (`claude mcp login` needs Claude Code 2.1.210 or newer; [full guide](https://chatcut.io/web-plugin/claude?utm_source=github&utm_medium=readme&utm_campaign=agent-plugin), [agent-executable copy](./docs/claude-code-web-install.md)): ```sh claude plugin marketplace add https://github.com/ChatCut-Inc/agent-plugin.git#main @@ -48,7 +97,7 @@ claude plugin install chatcut@chatcut-inc claude mcp login plugin:chatcut:chatcut ``` -Codex CLI (in the Codex desktop app, use its bundled Codex CLI; [full guide](https://chatcut.io/web-plugin/chatgpt)): +Codex CLI (in the Codex desktop app, use its bundled Codex CLI; [full guide](https://chatcut.io/web-plugin/chatgpt?utm_source=github&utm_medium=readme&utm_campaign=agent-plugin)): ```sh codex plugin marketplace add https://github.com/ChatCut-Inc/agent-plugin.git --ref main @@ -63,13 +112,25 @@ Gemini CLI: gemini extensions install https://github.com/ChatCut-Inc/agent-plugin ``` -Grok Bot: see [grok/README.md](./grok/README.md). Cursor: see [cursor/README.md](./cursor/README.md). Antigravity Web: see [antigravity/README.md](./antigravity/README.md). Kimi Work: see [kimi/README.md](./kimi/README.md). WorkBuddy: see [workbuddy/README.md](./workbuddy/README.md). Qwen Work (千问办公): see [qwen/README.md](./qwen/README.md). +Cursor: add the server to `~/.cursor/mcp.json` and sign in when Cursor asks: + +```json +{ + "mcpServers": { + "chatcut": { + "url": "https://api.chatcut.io/api/external-mcp/mcp" + } + } +} +``` + +Grok Bot and Antigravity Web: see the [Grok Bot Web guide](./grok/README.md) and the [Antigravity Web guide](./antigravity/README.md). Grok Bot signs in from its Plugins screen; in Antigravity, select **Customizations → Authenticate** next to the ChatCut MCP server. Other MCP clients that support remote servers with OAuth can connect to `https://api.chatcut.io/api/external-mcp/mcp` and sign in with a ChatCut account. -## What you can make +## Everything ChatCut can make -ChatCut edits your own footage and generates new media, and the result is an editable timeline. Items marked *(Desktop)* need ChatCut Desktop. Generation uses ChatCut credits, and the agent asks before spending them. +ChatCut edits your own footage and generates new media, and the result is an editable timeline. Under the hood the plugins import media, change a project timeline, create motion graphics, generate assets, transcribe audio, add captions, export videos, and verify that edits are visible in the editor. Items marked *(Desktop)* need ChatCut Desktop. Generation uses ChatCut credits, and the agent asks before spending them. **Editing** @@ -146,14 +207,6 @@ ChatCut edits your own footage and generates new media, and the result is an edi **Video types:** talking-head videos, podcasts and interviews, tutorials and lectures, product demos and app promos, UGC-style product ads, short-form videos, viral video remakes, presenter and avatar videos, screen-recorded demos *(Desktop)*, multicam shoots, music videos cut to the beat *(Desktop)* and translated videos. -## Install ChatCut Desktop (recommended) - -Ask your agent to read the complete [ChatCut Desktop setup guide](https://chatcut.io/desktop) using `curl -fsSL https://chatcut.io/desktop` (`curl.exe` on Windows), then install ChatCut and connect the current agent. The official macOS and Windows installers do not need Node.js or npm. Desktop owns its local tools and Skills. Run setup on a supported macOS or Windows computer with a graphical desktop. Linux and remote agents without access to that computer cannot install Desktop there; continue in a local agent on the supported computer. - -To recreate a reference video with your person or product while retaining its motion and timing, use Desktop’s bundled `video-gen` Skill and `submit_video_remake`. See the [video recreation guide](https://chatcut.io/viralvideocloner). Quotes use current account access and require approval before spending credits. - -The hosted packages below remain available for existing Web projects and explicit Web-only use. Web projects and original media remain separate and are not automatically migrated. Connecting Desktop to the same agent may disable or replace its conflicting hosted connection; do not promise that both connections stay active. - ## What Is Included - `codex/` - the Codex plugin package. @@ -189,18 +242,6 @@ Clone the complete repository with symlink support. When distributing a standalo - Codex with plugin support, Claude Code 2.x (CLI or desktop app), Grok Bot, Cursor, Google Antigravity (App, CLI, or IDE), Kimi Work, WorkBuddy, Doubao Work or Qwen Work. - Access to a ChatCut project you want to edit. -## Optional hosted Web plugin authentication - -The plugin connects to ChatCut through the hosted ChatCut MCP endpoint: - -```text -https://api.chatcut.io/api/external-mcp/mcp -``` - -The host handles authentication when the plugin is installed or first used (`codex mcp login chatcut`, or `claude mcp login plugin:chatcut:chatcut` in Claude Code). Grok Bot and Cursor users complete the authorization flow from the host's Plugins screen. Antigravity users select **Customizations → Authenticate** next to the ChatCut MCP server. Follow the sign-in flow to connect your ChatCut account. - -Install instructions per host: [Codex Web guide](https://chatcut.io/web-plugin/chatgpt) for Codex, [Claude Code Web guide](https://chatcut.io/web-plugin/claude) for Claude Code (agent-executable copy in [./docs/claude-code-web-install.md](./docs/claude-code-web-install.md)), [./grok/README.md](./grok/README.md) for Grok Bot, [./cursor/README.md](./cursor/README.md) for Cursor, and [./antigravity/README.md](./antigravity/README.md) for Antigravity. - ## Example Prompts After installing and authenticating the plugin, ask in your own words, for example: @@ -221,7 +262,7 @@ https://github.com/ChatCut-Inc/agent-plugin.git ## Support -For product information, visit [chatcut.io](https://chatcut.io). +For product information, visit [chatcut.io](https://chatcut.io/?utm_source=github&utm_medium=readme&utm_campaign=agent-plugin). ## License diff --git a/docs/media/brand/chatcut-logotype-dark-mode.svg b/docs/media/brand/chatcut-logotype-dark-mode.svg new file mode 100644 index 0000000..d33271d --- /dev/null +++ b/docs/media/brand/chatcut-logotype-dark-mode.svg @@ -0,0 +1,12 @@ + + + + + + + + + + + + diff --git a/docs/media/brand/chatcut-logotype-light-mode.svg b/docs/media/brand/chatcut-logotype-light-mode.svg new file mode 100644 index 0000000..5a9f887 --- /dev/null +++ b/docs/media/brand/chatcut-logotype-light-mode.svg @@ -0,0 +1,12 @@ + + + + + + + + + + + + diff --git a/docs/media/hero-demo.gif b/docs/media/hero-demo.gif new file mode 100644 index 0000000..00ff011 Binary files /dev/null and b/docs/media/hero-demo.gif differ diff --git a/docs/media/hosts/antigravity.png b/docs/media/hosts/antigravity.png new file mode 100644 index 0000000..0387081 Binary files /dev/null and b/docs/media/hosts/antigravity.png differ diff --git a/docs/media/hosts/chatgpt.png b/docs/media/hosts/chatgpt.png new file mode 100644 index 0000000..50bb3fe Binary files /dev/null and b/docs/media/hosts/chatgpt.png differ diff --git a/docs/media/hosts/claude-code.png b/docs/media/hosts/claude-code.png new file mode 100644 index 0000000..c9a3f8b Binary files /dev/null and b/docs/media/hosts/claude-code.png differ diff --git a/docs/media/hosts/codex.png b/docs/media/hosts/codex.png new file mode 100644 index 0000000..faad131 Binary files /dev/null and b/docs/media/hosts/codex.png differ diff --git a/docs/media/hosts/cursor.png b/docs/media/hosts/cursor.png new file mode 100644 index 0000000..5548e91 Binary files /dev/null and b/docs/media/hosts/cursor.png differ diff --git a/docs/media/hosts/doubao-work.png b/docs/media/hosts/doubao-work.png new file mode 100644 index 0000000..d7cdba4 Binary files /dev/null and b/docs/media/hosts/doubao-work.png differ diff --git a/docs/media/hosts/gemini-cli.png b/docs/media/hosts/gemini-cli.png new file mode 100644 index 0000000..b309080 Binary files /dev/null and b/docs/media/hosts/gemini-cli.png differ diff --git a/docs/media/hosts/grok-bot.png b/docs/media/hosts/grok-bot.png new file mode 100644 index 0000000..d50f8c3 Binary files /dev/null and b/docs/media/hosts/grok-bot.png differ diff --git a/docs/media/hosts/kimi-work.png b/docs/media/hosts/kimi-work.png new file mode 100644 index 0000000..9f54a0e Binary files /dev/null and b/docs/media/hosts/kimi-work.png differ diff --git a/docs/media/hosts/qwen-work.png b/docs/media/hosts/qwen-work.png new file mode 100644 index 0000000..8da3b74 Binary files /dev/null and b/docs/media/hosts/qwen-work.png differ diff --git a/docs/media/hosts/workbuddy.png b/docs/media/hosts/workbuddy.png new file mode 100644 index 0000000..00ba5df Binary files /dev/null and b/docs/media/hosts/workbuddy.png differ diff --git a/docs/media/skills/add-captions.jpg b/docs/media/skills/add-captions.jpg new file mode 100644 index 0000000..5992e1f Binary files /dev/null and b/docs/media/skills/add-captions.jpg differ diff --git a/docs/media/skills/mg-packaging-editorial-explainer.jpg b/docs/media/skills/mg-packaging-editorial-explainer.jpg new file mode 100644 index 0000000..c00b704 Binary files /dev/null and b/docs/media/skills/mg-packaging-editorial-explainer.jpg differ diff --git a/docs/media/skills/mg-packaging-runway-rebel.jpg b/docs/media/skills/mg-packaging-runway-rebel.jpg new file mode 100644 index 0000000..777b9d5 Binary files /dev/null and b/docs/media/skills/mg-packaging-runway-rebel.jpg differ diff --git a/docs/media/skills/recreate-a-video.jpg b/docs/media/skills/recreate-a-video.jpg new file mode 100644 index 0000000..4d72a03 Binary files /dev/null and b/docs/media/skills/recreate-a-video.jpg differ diff --git a/docs/media/skills/speech-cleanup.jpg b/docs/media/skills/speech-cleanup.jpg new file mode 100644 index 0000000..9c6663d Binary files /dev/null and b/docs/media/skills/speech-cleanup.jpg differ diff --git a/docs/media/skills/viral-video-cloner.jpg b/docs/media/skills/viral-video-cloner.jpg new file mode 100644 index 0000000..67bd0aa Binary files /dev/null and b/docs/media/skills/viral-video-cloner.jpg differ diff --git a/doubao/README.md b/doubao/README.md index 54cd2ec..bda78be 100644 --- a/doubao/README.md +++ b/doubao/README.md @@ -25,7 +25,7 @@ The Doubao Work package is a single Skill, **ChatCut 视频剪辑专家** (`chat From the Skill's own instructions: -1. Add ChatCut in Doubao Work. The listing binds the `chatcut_desktop` connector to this Skill, and Doubao Work starts it when a task begins. +1. In Doubao Work's sidebar, open **Plugins · Skills** (插件 · 技能) → **Plugins** (插件), search **ChatCut** and open it, select **Install** (安装) on its ChatCut connector, then **Use in chat** (在对话中使用). The listing binds the `chatcut_desktop` connector to this Skill, and Doubao Work starts it when a task begins. 2. Ask for a video edit. If ChatCut Desktop is missing, the Skill installs the official build for the computer from `https://api.chatcut.io/desktop/download/...`: macOS 13 or newer (Apple Silicon or Intel) or Windows x64. On macOS it verifies the disk image, code signature and notarization before installing. Linux is not supported. 3. If ChatCut asks you to sign in, do it in the ChatCut window. The Skill never asks for passwords, verification codes or tokens. 4. If the connector failed to start because Desktop was not installed yet, the agent asks you to retry the ChatCut connector once in Doubao Work, then continues the original request. The connection counts as working only after a successful `get_active_project` call inside the Doubao Work task. diff --git a/qwen/README.md b/qwen/README.md index a410218..b48b7f4 100644 --- a/qwen/README.md +++ b/qwen/README.md @@ -13,7 +13,7 @@ The Qwen Work package is an expert kit, **ChatCut 视频剪辑师 / ChatCut Vide From the kit's `CONNECTORS.md` and `references/connector-readiness.md`: -1. In Qwen Work, open **Extensions → Connectors** (「扩展 → 连接器」), turn on **ChatCut** from the market, and sign in to your own ChatCut account with OAuth. The kit's details page also links there through **Data connections** (「数据连接」). An existing authorization is reused. +1. In Qwen Work, open **Skills & extensions → Connectors → Market**, select **+** next to **ChatCut**, then **Install ChatCut**, and sign in to your own ChatCut account with OAuth. The kit's details page also links there through **Data connections** (「数据连接」). An existing authorization is reused. 2. Use the same ChatCut account in the web editor. 3. Start from one of the entry Skills, 口播精剪 (`talking-head-guide`), 制作 MG 动画 (`create-motion-graphics`) or 制作产品 / App 宣传片 (`app-promo-guide`), or describe the video in your own words. diff --git a/workbuddy/README.md b/workbuddy/README.md index ae4e355..5112eb0 100644 --- a/workbuddy/README.md +++ b/workbuddy/README.md @@ -1,6 +1,6 @@ # ChatCut for WorkBuddy -The WorkBuddy package is a ChatCut expert agent, shown in WorkBuddy as **All-in-one video creation expert** (一站式视频创作专家, profession: ChatCut Video Editor). It works in real, editable ChatCut timelines through the hosted ChatCut MCP server: media import, talking-head cleanup, captions, B-roll, transitions, effects and color, motion graphics, generated video, images, music, sound effects and voiceovers, and export of finished video, audio, subtitles, or Premiere Pro and DaVinci Resolve-compatible project files. +The WorkBuddy package is a ChatCut expert agent, shown in WorkBuddy as **ChatCut 视频剪辑师** (ChatCut Video Editor), subtitled 一站式视频创作专家 (all-in-one video creation expert). It works in real, editable ChatCut timelines through the hosted ChatCut MCP server: media import, talking-head cleanup, captions, B-roll, transitions, effects and color, motion graphics, generated video, images, music, sound effects and voiceovers, and export of finished video, audio, subtitles, or Premiere Pro and DaVinci Resolve-compatible project files. This folder is the expert package listed on WorkBuddy's official experts page, version **1.0.6**. @@ -15,7 +15,7 @@ This folder is the expert package listed on WorkBuddy's official experts page, v From the package's own instructions: -1. Add ChatCut from WorkBuddy's experts page, or install the package ZIP in WorkBuddy. +1. Open **Experts · Skills · Connectors** (专家·技能·连接器) → **Experts** (专家), search **ChatCut**, open the official **ChatCut 视频剪辑师** expert and select **Summon** (召唤). You can also install the package ZIP in WorkBuddy. 2. The first time you call the expert, sign in and authorize ChatCut in the inline connection card. 3. Pick an existing project or ask the expert to create one. The expert asks WorkBuddy to open the project in its built-in browser and always adds a plain "Open ChatCut editor" link as a fallback. 4. Provide your media and goal. The expert builds an editable timeline and exports only when you ask.