Installing Editz for the first time

Editz ships as a single command you run with npx, Node's "run without installing" tool. Open a terminal and run:

npx @editz/editz

This does two things at once:

• Starts a local MCP bridge on your machine (port 9317) — this is what your AI connects to.
• Opens the Editz web editor in your browser, where you manage projects and chat with AI.

What you need on your machine first

Editz checks for these and tells you exactly what's missing:

• ffmpeg and ffprobe — the actual video engine. On macOS: brew install ffmpeg. On Ubuntu/Debian: sudo apt install ffmpeg.
• python3 — used for captions/overlays. Usually already installed.
• Node.js 22 or newer.

Signing in

The editor starts locked — you'll see a "Sign in to Editz" screen. Sign in with Google once. This unlocks the local bridge for that session; quitting the command re-locks it. The full local editor is free; Pro unlocks the bundled in-app AI assistant so you don't need your own Claude/Cursor setup.

Next step

Once it's running, connect your AI tool of choice — see the per-agent guides below.