# OpenEdit

> AI-native video editor driven as a local MCP server. Linux + Windows: ingest, transcribe, edit graph, melt/ffmpeg render, QC.

- **Type:** MCP server
- **Install:** `agentstack add mcp-ah64-dll-openedit`
- **Verified:** Pending review
- **Seller:** [AH64-dll](https://agentstack.voostack.com/s/ah64-dll)
- **Installs:** 0
- **Category:** [Databases](https://agentstack.voostack.com/c/databases)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [AH64-dll](https://github.com/AH64-dll)
- **Source:** https://github.com/AH64-dll/OpenEdit
- **Website:** https://ah64-dll.github.io/OpenEdit/

## Install

```sh
agentstack add mcp-ah64-dll-openedit
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Open Edit

**AI-native video editing, driven over MCP.**

*The Review Studio, live: preview a cut, inspect renders, and scrub the edit graph.*

*The timeline: clips on V1/A1/A2, edit markers, and a playhead that is ready to scrub.*

  
  Open Edit logo intro (animated GIF)

*The 60-second logo intro — animated in HTML/CSS with the HyperFrames engine and rendered entirely through Open Edit's own pipeline (the agent built the project, added the overlay, and ran the final 1080p30 GPU export).*

## What it is

Open Edit is an AI-native video editor that runs as a **local MCP server** over stdio.
An external agent (Cursor, Claude Code, OpenCode, any MCP client) owns the creative loop;
Open Edit owns the machinery: SHA-256 content-addressed ingest, word-level transcription
(faster-whisper), an append-only IR edit graph in SQLite (WAL), and melt + ffmpeg rendering
with a 640×360 proxy review artifact and a 1080p final export.

No cloud, no built-in LLM. The server is pinned to one project directory and executes
28 kinds of IR edit operations against it, each one recorded, reversible, and renderable.

## Downloads

**Python package (pip):**

```bash
pip install open-edit      # installs the open-edit CLI + open-edit-mcp server
```

**Linux / macOS — one command (full render stack):**

```bash
curl -fsSL https://github.com/AH64-dll/OpenEdit/releases/download/v1.3.1/install.sh | bash
```

**Windows (PowerShell):**

```powershell
irm https://github.com/AH64-dll/OpenEdit/releases/download/v1.3.1/install.ps1 | iex
```

**Source (v1.3.1):** [zip](https://github.com/AH64-dll/OpenEdit/archive/refs/tags/v1.3.1.zip) · [tar.gz](https://github.com/AH64-dll/OpenEdit/archive/refs/tags/v1.3.1.tar.gz)

Both installers also provision the render runtime (Node.js + the bundled HyperFrames overlay engine, plus ffmpeg/melt/Chrome checks) and print a readiness summary — see [INSTALL.md → Runtime requirements](INSTALL.md#runtime-requirements).

## The agent way

Open Edit is built to be operated by an agent, not a GUI. Paste the install prompt into
your agent and it will clone, install, verify end to end, and report back. Then paste the
configure prompt to register the MCP server in your host and confirm all six tools appear.

- [docs/agent-install.md](docs/agent-install.md) — agent-driven install prompt
- [docs/agent-configure.md](docs/agent-configure.md) — agent-driven MCP configuration

## The normal way

**Linux / macOS**

```bash
git clone https://github.com/AH64-dll/OpenEdit.git
cd OpenEdit
python3 -m venv .venv
source .venv/bin/activate
pip install -U pip
pip install -e ".[mcp]"        # extras: ,serve (review UI) · ,whisper (transcription)
```

**Windows (PowerShell)**

```powershell
git clone https://github.com/AH64-dll/OpenEdit.git C:\OpenEdit
cd C:\OpenEdit
python -m venv .venv
.\.venv\Scripts\Activate.ps1   # if blocked: Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
python -m pip install -U pip
pip install -e ".[mcp]"
```

Check the entry point, create a project, and start the review studio:

```bash
.venv/bin/open-edit-mcp --help            # Windows: .\.venv\Scripts\open-edit-mcp.exe --help
mkdir -p ~/OpenEditProjects               # Windows: New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\OpenEditProjects"
open_edit init ~/OpenEditProjects/my-talk
open_edit serve --review-only --port 8000 # → http://127.0.0.1:8000 (needs the ,serve extra)
```

Register the server in Cursor (`~/.cursor/mcp.json` on Linux/macOS, `%USERPROFILE%\.cursor\mcp.json` on Windows) and reload MCP:

```json
// Linux / macOS
{
  "mcpServers": {
    "open-edit": {
      "command": "/ABSOLUTE/PATH/TO/OpenEdit/.venv/bin/open-edit-mcp",
      "args": ["--project", "/home/YOU/OpenEditProjects/my-talk"],
      "env": { "OPEN_EDIT_RENDER_BACKEND": "cpu" }
    }
  }
}

// Windows
{
  "mcpServers": {
    "open-edit": {
      "command": "C:\\OpenEdit\\.venv\\Scripts\\open-edit-mcp.exe",
      "args": ["--project", "C:\\Users\\YOU\\OpenEditProjects\\my-talk"],
      "env": { "OPEN_EDIT_RENDER_BACKEND": "cpu" }
    }
  }
}
```

## What you get

| Tool | Role |
|---|---|
| `query_project` | Read-only project queries |
| `edit_project` | Mutations + creative generation |
| `run_script` | Free-form Python IR edits (bwrap sandbox on Linux, `dev` on Windows) |
| `trigger_render` | Enqueue proxy / final / preview-chunks renders |
| `get_render_job` | Poll a durable render job by `job_id` |
| `cancel_render_job` | Cancel queued or running jobs |

**Render modes:** `proxy` (640×360 review artifact, whole-file) → `final` (1080p).
Every render passes a deterministic 10-check QC gate before it is offered to you.

## Live guide

The product is documented and illustrated in the live guide: **[open-edit guide](https://ah64-dll.github.io/OpenEdit/)** — what it is, how it works, and how to install it on Linux and Windows.

## Docs

- [INSTALL.md](INSTALL.md) — full Linux + Windows setup, smoke checks, update/uninstall
- [docs/MCP.md](docs/MCP.md) — MCP tools, Cursor config, review UI, render workflow
- [skills/](skills/) — agent playbook and harness skills (also shipped in the wheel)
- [docs/REMOTION_LICENSE.md](docs/REMOTION_LICENSE.md) — Remotion licensing

## Contributing

Bugs, ideas, and pull requests are welcome — see [CONTRIBUTING.md](CONTRIBUTING.md)
(fork → branch → PR; CI runs tests on every pull request).

## License

MIT — see [LICENSE](LICENSE). Experimental prototype; behavior may change between
releases. Motion graphics use the bundled HyperFrames engine (HTML/CSS/JS,
pinned in this repo — no extra install). Remotion is legacy/migration-only.
Legacy Remotion templates may require a company license — see
[docs/REMOTION_LICENSE.md](docs/REMOTION_LICENSE.md).

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [AH64-dll](https://github.com/AH64-dll)
- **Source:** [AH64-dll/OpenEdit](https://github.com/AH64-dll/OpenEdit)
- **License:** MIT
- **Homepage:** https://ah64-dll.github.io/OpenEdit/

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: flagged — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-ah64-dll-openedit
- Seller: https://agentstack.voostack.com/s/ah64-dll
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.