Skip to content
Back to search

WeftCut

Free, open-source AI video editor for macOS, Windows and Linux — drive the whole timeline from any MCP client.

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/WeftCut/WeftCut 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/WeftCut/WeftCut'

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

HTML

<a href="/listings/weftcut--weftcut"><img src="/api/listings/weftcut--weftcut/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.

> [!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](https://github.com/WeftCut/WeftCut/releases/latest). 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.

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 · 218 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="apps/desktop/src/renderer/public/icons/icon.svg" alt="WeftCut" width="128" height="128" />
  3. </p>
  4. <h1 align="center">WeftCut</h1>
  5. <p align="center">
  6. <strong>The video editor your AI agent can drive like you do.</strong><br/>
  7. Point Codex, Claude, or any MCP client at a real desktop NLE — and watch
  8. every edit land on your timeline while it plays. Code renders as video, so
  9. your agent can build editable clips.
  10. </p>
  11. > [!NOTE]
  12. > WeftCut is still under active development, so some features and UI/UX may change before v1.0.0. Join us to improve the project: start with the [contributing guide](CONTRIBUTING.md).
  13. <p align="center">
  14. <a href="https://github.com/WeftCut/WeftCut/releases/latest"><img alt="Download the latest release" src="https://img.shields.io/github/v/release/WeftCut/WeftCut?style=flat-square&label=Download&labelColor=475569&color=6696E6&logo=github&logoColor=white" /></a>
  15. <img alt="Runs on Windows, macOS and Linux" src="https://img.shields.io/badge/Platform-Windows%20%7C%20macOS%20%7C%20Linux-5B7196?style=flat-square&labelColor=475569" />
  16. <a href="LICENSE"><img alt="License" src="https://img.shields.io/github/license/WeftCut/WeftCut?style=flat-square&label=License&labelColor=475569&color=5B7196" /></a>
  17. <a href="https://discord.gg/SjsFCpzDe"><img alt="Join the WeftCut Discord community" src="https://img.shields.io/badge/Discord-Join%20the%20community-5865F2?style=flat-square&labelColor=475569&logo=discord&logoColor=white" /></a>
  18. <a href="https://glama.ai/mcp/servers/WeftCut/WeftCut"><img alt="Glama MCP server score" src="https://glama.ai/mcp/servers/WeftCut/WeftCut/badges/score.svg" /></a>
  19. </p>
  20. <p align="center">
  21. <a href="https://www.producthunt.com/products/weftcut?embed=true&amp;utm_source=badge-featured&amp;utm_medium=badge&amp;utm_campaign=badge-weftcut" target="_blank" rel="noopener noreferrer"><img alt="WeftCut - The open-source video editor your AI agent can drive | Product Hunt" width="250" height="54" src="https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=1266067&amp;theme=neutral&amp;t=1791466936489" /></a>
  22. </p>
  23. ![An agent editing the timeline live over MCP](docs/assets/agent-edit.gif)
  24. <p align="center"><em>An agent works over MCP while playback runs: restyling the
  25. lower third, trimming the B-roll, then undoing both — every edit lands in the UI
  26. in real time, every Agent action is recorded.</em></p>
  27. 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.
  28. 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.
  29. ## Quick start
  30. 1. Install WeftCut:
  31. - **macOS** (Apple silicon, macOS 13 or later) with [Homebrew](https://brew.sh):
  32. ```bash
  33. brew install --cask weftcut
  34. ```
  35. This also puts the `weftcut` command on your `PATH`. The app updates itself, so `brew upgrade` leaves it alone.
  36. - **Windows, Linux, or macOS without Homebrew**: download the installer for your platform from the [releases page](https://github.com/WeftCut/WeftCut/releases/latest).
  37. 2. Open the app's settings panel and copy the prompt that teaches your agent how to connect to WeftCut.
  38. 3. Enjoy your work.
  39. ## Hand your timeline to an agent
  40. Copy the prompt in settings into your client, and your agent is holding the editor.
  41. - **It edits the project you are watching.** No import/export round trip, no separate headless copy.
  42. - **Every batch is reversible.** A work session begins with a checkpoint that is one click from being restored, and every edit the agent commits is a step of your undo history.
  43. - **Multi-agent, with rules.** Sessions are per-connection. A work session locks undo for everyone but its agent, so a stray Ctrl-Z doesn't land in the middle of its work — the lock and the reason it gave are shown to you, and Unlock is yours.
  44. ### Watch and review in Agent view
  45. For a longer run, the agent can call `begin_agent_session` to open **Agent view**: a preview, a compact review timeline, and an Agent panel with **Activity**, **Tacks** and **Changes** tabs. Follow its tool calls in Activity while you watch the edit play, discuss specific passages with Tacks, then audit the result with **Timeline diff** in Changes. You can return to the full editor at any time.
  46. ![Agent view with added, removed and modified clips and titles in the Changes panel, plus change and Tack ranges across the review timeline](docs/assets/timeline-review.png)
  47. *Agent view after an editing pass: Changes lists additions, removals and modifications. The timeline shows them in green, red and yellow, with Tack ranges in teal.*
  48. **Tacks** give the conversation a place. An agent leaves a note, issue or question on a time range; you locate and play it, then resolve, dismiss or convert the Tack into a marker to keep. Tacks follow the content they cover and become **outdated** when what plays there changes, including on other tracks. The agent can read their statuses and receives feedback when its edits affect its open Tacks.
  49. **Timeline diff** shows the result of the work. Open **Changes** to compare the current project with the state when you opened it or last chose **Approve all**. Inspect additions, removals and modifications, with before/after details and timeline highlights. **Approve all** makes the result your new review baseline; **Revert all** restores that baseline in one undoable step. Both include your own edits since the baseline.
  50. Try: *“Find the pauses in this interview and leave Tacks on the ones worth cutting. Let me review them before you edit.”* Review the passages, tell the agent which cuts to make, then use Timeline diff to approve or revert the result.
  51. Tacks last only for the current project opening. They are not saved or exported, and managing them adds nothing to undo history.
  52. <sub>Agent: `create_tacks` · `read_project { view: "tacks" }` · `update_tack` · `delete_tacks`</sub>
  53. ## Code as video: Motifs
  54. 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.
  55. 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.
  56. ```js
  57. // The built-in Countdown's whole script, near enough verbatim — the rest of the
  58. // file is the SVG ring it animates. `props` is whatever the manifest declares;
  59. // `frame` runs once per composition frame and keeps no state of its own.
  60. motif.define({
  61. setup: async function (props, ctx) {
  62. _label = props.label != null ? String(props.label) : "GO";
  63. num.style.color = props.accent;
  64. ring.style.stroke = props.accent;
  65. ring.setAttribute("stroke-dasharray", C);
  66. ring.animate([{ strokeDashoffset: 0 }, { strokeDashoffset: C }],
  67. { duration: ctx.duration * 1000, easing: "linear", fill: "both" });
  68. },
  69. frame: function (t, ctx) {
  70. var n = Math.max(0, Math.ceil(ctx.duration - t));
  71. num.textContent = n > 0 ? String(n) : _label;
  72. },
  73. });
  74. ```
  75. ![A Motif on the timeline, with its props in the inspector](docs/assets/motif.png)
  76. 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.
  77. Lower thirds, countdowns, karaoke text and animated title cards are the obvious uses. Anything you can build on a page is the actual limit.
  78. ## A complete editor underneath
  79. ![WeftCut editor](docs/assets/editor.png)
  80. **Timeline** — A/B-roll rows with filmstrips and waveforms, frame-accurate SMPTE editing, ripple delete that closes the gap behind it, linked A/V that trims as one clip, cross-track groups, and nested compositions.
  81. <br/><sub>Agent: `move_layers` · `trim_layer` · `split_layer` · `shift_layers` · `create_link` · `create_group` · `move_layers_to_composition`</sub>
  82. **Keyframes** — animate any parameter, with bézier easing, a curve editor, tangent control, motion paths and extrapolation.
  83. <br/><sub>Agent: `set_keyframe` · `update_keyframe` · `set_param_track` · `get_param_track`</sub>
  84. **Speech and captions** — transcribe a clip and get editable caption layers packed onto your caption tracks; import SRT/VTT/ASS into the media pool and drop it where it starts. Transcription runs against a cloud provider, or entirely on your machine once you let the app fetch a local engine (whisper.cpp, FunASR) — or an agent can pull the raw audio out and run its own model. Text-to-speech for scratch voiceover.
  85. <br/><sub>Agent: `transcribe_clip` · `extract_clip_audio` · `apply_transcripts` · `apply_subtitles` · `synthesize_speech`</sub>
  86. **Audio** — role-based mixing (dialogue / music / SFX / voiceover) with live per-role metering, gain, pan, fades and denoise. **Pauses** finds the dead air in a take and cuts it as one undoable edit, keeping a pad so speech still breathes.
  87. <br/><sub>Agent: `detect_pauses` · `remove_pauses` · `set_role_gain` · `set_role_flags`</sub>
  88. ![The Role Mixer console, metering during playback](docs/assets/mixer.png)
  89. **Understanding the footage** — shot-boundary detection with per-shot brightness, motion and sharpness, frame comparison, and vision-model descriptions of what a clip actually contains. An agent can cut on content, not just on timecode.
  90. <br/><sub>Agent: `analyze_clip` · `auto_split_by_shot` · `describe_clip` · `compare_frames`</sub>
  91. **Titles, effects and transitions** — styled text layers with outlines, per-layer effect chains including chroma key with an eyedropper that picks from the live frame, and transitions between clips.
  92. <br/><sub>Agent: `add_effect` · `update_effect` · `add_transition` · `update_transition`</sub>
  93. **Export** — H.264 / HEVC / AV1, hardware or software encoders, resolution / fps / quality controls, and streamed muxing.
  94. **Find anything** — one `Ctrl+K` palette over commands, media, clips, captions and markers, search for whatever you want.
  95. ![Search palette](docs/assets/search-palette.png)
  96. ## Tech stack
  97. | Layer | Stack |
  98. |---|---|
  99. | **Shell** | Electron 44 · TypeScript 7 · electron-vite · Vite 8 · Node 24 |
  100. | **UI** | React 19 · Zustand · Immer · Tailwind CSS v4 · Base UI · shadcn/ui · Dockview · lucide · i18next (`en-US` / `zh-CN`) · fuzzysort |
  101. | **Preview** | PixiJS v8 · WebGPU / WebGL · WebCodecs `VideoDecoder` pool · mediabunny · own YUV→RGB shaders · Web Audio clock |
  102. | **Export** | Worker + `OffscreenCanvas` · GPU YUV pack pass · PBO readback · rawvideo over IPC · native ffmpeg sink · WebCodecs encoder (pin) · stream-copy mux |
  103. | **Native core** | Rust · napi-rs 3 · Tokio · imbl · serde · schemars · blake3 · reqwest · ffmpeg-sidecar |
  104. | **Native decode** | `@weftcut/native-decode` · ffmpeg-next · software + GPU lanes · `sharedTexture` (Windows) |
  105. | **Shared math** | `weftcut-eval` crate · native + wasm32 · snap · keyframe eval · envelope · role gate |
  106. | **ffmpeg** | GPL CLI sidecar (jobs, encode, mux) · LGPL shared libs (in-process decode) |
  107. | **Agent surface** | MCP · streamable HTTP on localhost · stdio through the `weftcut` binary (Go, standard library only) · `@modelcontextprotocol/sdk` · bearer token · TS + Rust tool catalog |
  108. | **Motifs** | Offscreen BrowserWindow · Chrome DevTools Protocol · `motif:` scheme · CSP `default-src 'none'` |
  109. | **Speech & vision** | Cloud providers over reqwest · whisper.cpp · FunASR · on-demand model download |
  110. | **Tests & CI** | Vitest · cargo test · go test · Playwright · `node --test` · Stryker · GitHub Actions (Windows / macOS / Linux) |
  111. Design decisions: [ADRs](docs/adr/).
  112. ## Build from source
  113. Prerequisites: **Node 24+**, **Rust** (version pinned by `rust-toolchain.toml`, installed via `rustup`), **Go** (version named by `apps/desktop/cli/go.mod`), and your platform's C/C++ build tools and libclang — per-OS commands in [docs/setup.md](docs/setup.md).
  114. ```sh
  115. npm install # JS dependencies
  116. npm run bootstrap # one-time: fetch ffmpeg + build the Rust addons
  117. npm run dev # start the editor
  118. ```
  119. Also useful: `npm run typecheck`, `npm test`, `npm run e2e`, `npm run build`, `npm run package` (installers).
  120. ## Documentation
  121. Start with **[architecture](docs/architecture.md)** for the system map, or **[MCP server & agent UX](docs/mcp.md)** for the tool surface, resources and multi-agent behavior. **[Motifs](docs/motifs.md)** and **[motif authoring](docs/motif-authoring.md)** cover the overlay engine and its contract.
  122. <details>
  123. <summary>Everything else</summary>
  124. - **[Data model](docs/data-model.md)** — project state schema, history, persistence, validation.
  125. - **[Render](docs/render.md)** — PixiJS + WebCodecs renderer architecture.
  126. - **[Preview](docs/preview.md)** — interactive preview surface and transport.
  127. - **[Export](docs/export.md)** — export pipeline, settings and range, audio, finalization, export jobs and presets.
  128. - **[Captions](docs/captions.md)** · **[Audio](docs/audio.md)** — caption ingestion and the audio engine.
  129. - **[Conformance](docs/conformance.md)** — E2E gates that export real media and check frame alignment, audio sync and colour.
  130. - **[Features](docs/features.md)** — the concrete behavior of each editor capability: selection, links, groups, ripple delete, markers, shot review, pauses, search, gizmo, crop.
  131. - **[Status / log system](docs/status-log.md)** — the bottom-of-editor log bus.
  132. - **[Setup](docs/setup.md)** — per-OS toolchain prerequisites and first-run flow.
  133. - **[Licensing](docs/licensing.md)** — MIT app plus the two FFmpeg lanes and their build-time compliance gates.
  134. - **[v1 target](https://github.com/WeftCut/WeftCut/issues/11)** — release scope and open work, tracked as an issue: `docs/` describes what exists today.
  135. </details>
  136. ## Community
  137. Join the [WeftCut Discord community](https://discord.gg/SjsFCpzDe) to share feedback, discuss feature ideas, and get help. Please use [GitHub Issues](https://github.com/WeftCut/WeftCut/issues) for bug reports and feature requests so they can be tracked. Before opening a pull request, read the [contributing guide](CONTRIBUTING.md).
  138. ## Maintainer
  139. WeftCut is built and maintained by [UncleChair](https://github.com/UncleChair).
  140. It exists to speed up my own video work. I wanted an editor an agent could actually drive, and a timeline I could keep watching while it did — so the MCP surface is the part I use daily, not a demo bolted onto the side. Motifs came from the other half of that: the overlays I wanted were easier to *write* than to find, and an agent that can write a web page can write one for the shot in front of it.
  141. The project sits under the [WeftCut](https://github.com/WeftCut) organization so the name, domain and releases have a stable home, but it is a one-person project — issues and pull requests all reach me.
  142. ## Star History
  143. <p align="center">
  144. <a href="https://www.star-history.com/?repos=WeftCut%2FWeftCut&amp;type=date&amp;legend=top-left">
  145. <picture>
  146. <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=WeftCut/WeftCut&amp;type=date&amp;theme=dark&amp;legend=top-left" />
  147. <img alt="WeftCut GitHub Star History Chart" src="https://api.star-history.com/chart?repos=WeftCut/WeftCut&amp;type=date&amp;legend=top-left" />
  148. </picture>
  149. </a>
  150. </p>
  151. ## License
  152. WeftCut is licensed under the [MIT License](LICENSE). Packaged installers bundle FFmpeg binaries under their own licenses (LGPL shared libraries for in-process decode, GPL command-line tools run as a separate process) — see [THIRD-PARTY-NOTICES.md](THIRD-PARTY-NOTICES.md) and [docs/licensing.md](docs/licensing.md) for the full model.

Ratings and comments

Sign in to rate this skill.

Sign in

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