WeftCut
以下摘录自该仓库的 README(片段) · 在 GitHub 读完整 README →
The video editor your AI agent can drive like you do.
Point Codex, Claude, or any MCP client at a real desktop NLE — and watch
every edit land on your timeline while it plays. Code renders as video, so
your agent can build editable clips.
> [!NOTE]
> WeftCut is still under active development, so some features and UI/UX may change before v1.0.0. Join us to improve the project!
An agent works over MCP while playback runs: restyling the
lower third, trimming the B-roll, then undoing both — every edit lands in the UI
in real time, every Agent action is recorded.
Most editors bolt AI on as a feature: a button that generates something, a sidebar that suggests a cut. WeftCut exposes the editor *itself* as a tool surface. A localhost MCP server publishes **all editing tools** — place, trim, split, restyle, keyframe, group, caption, mix, checkpoint — and whatever agent you already have open drives them. The intelligence lives outside the app: the installer bundles no model weights, and the local engines for speech and vision are an opt-in download when you want them.
None of that rides on a stripped-down editor. Everything an agent can reach, you can do by hand, in a full NLE: A/B-roll timeline, keyframes with a curve editor, effects, captions, a role-based audio mixer, and hardware-accelerated export.
Quick start
> [!NOTE]
>
> We don't have a verified macOS installer yet, so allow it under **System Settings → Privacy & Security → Open Anyway**
1. Download the installer for your platform from the releases page.
2. Install the app, open the settings panel, and copy the prompt that teaches your agent how to connect to WeftCut.
3. Enjoy your work.
Hand your timeline to an agent
Copy the prompt in settings into your client, and your agent is holding the editor.
- **It edits the project you are watching.** No import/export round trip, no separate headless copy.
- **You can always see what it did.** Every tool call becomes a row in the Agent panel — *Trimmed clip · Ember.mp4*, *Added marker · Needs a look* — and the status bar echoes it. Nothing happens off the record.
- **Every batch is reversible.** Agents checkpoint at logical boundaries, and each checkpoint is one click from being restored. The agent can also rehearse a whole multi-step edit against a throwaway clone first (dry_run) and find the collision before it touches your project.
- **Multi-agent, with rules.** Sessions are per-connection. An agent that is mid-batch can set_history_lock so a stray Ctrl-Z doesn't land in the middle of its work — and the lock, plus the reason it gave, is shown to you.
For a longer run, an agent can call begin_agent_session and fold the UI down to preview, scrub, and a record of what it is doing:
Code as video: Motifs
A **Motif** is an on-screen element written as code — a real web page (HTML, CSS, SVG, canvas, WebGL, whatever you reach for) dropped on the timeline as a layer. It isn't a fixed preset: the author declares the knobs, and the inspector builds the form from that declaration, so seconds, label and accent below are editable in the app.
The one rule that makes it an editor feature instead of a screen recording: **a Motif renders as a pure function of time.** It never advances itself. The harness owns the clock and drives the page to each composition frame, so the same t always yields the same pixels — when you scrub, when you re-export, and in preview and export alike.
Writing a web page is the thing coding agents are already best at — so an agent can author a brand-new overlay for your edit instead of picking one from a catalog. The authoring spec ships inside the app as an agent skill, so the model gets the contract without you pasting documentation.