invideo CLI

A video editor for your terminal and your agents

View on GitHub
Works with
  • Claude Code
  • Codex
  • Cursor
  • Gemini CLI
  • Hermes Agent
  • OpenClaw

Or install it yourself

curl -fsSL https://agents.invideo.io | sh

Checks the release's sha256 and installs one file to ~/.local/bin. No sudo.

Cut a 30-second teaser from ./shots with a title card and music under it.
I'll start a project in invideo and bring in the footage.
invideo project new --title "Launch teaser" --json
project  <project-url>
invideo asset upload <project-url> ./shots/*.mp4 --wait
Uploaded 14 files
invideo edit new <project-url> --name "Teaser v1"
edit  <edit-url>
invideo edit change <edit-url> --token <token> --dry-run --operations @cut.json
12 operations check out
invideo edit change <edit-url> --token <token> --operations @cut.json
Applied 12 operations
invideo edit capture <edit-url> --at 1,12,28 --out ./frames
Saved 3 frames
The rough cut is on the timeline. Watch it at <edit-url>. Export it at 1080p?

A real timeline

See every cut as it happens

Your agent edits the same multitrack timeline as invideo Editor. Each change applies whole or not at all, and you watch it happen.

From raw footage to finished video

Cut, grade, mix and generate on a real multitrack timeline, with 250+ AI models built in.

Rough cuts

Give it the footage and a direction. It finds the strong takes and builds the first cut.

Color grading

Describe or reference a look. The grade stays editable on the timeline.

Sound design

Music, voice and effects, layered and mixed on their own tracks.

B-roll

Find, generate and place B-roll with 250+ image, video and audio models.

Style and motion

Point at a reference video to set the pacing, transitions, type and motion.

Cut-downs and versions

Shorter cuts and vertical versions for every channel, from one master edit.

Agents work together

One project, any number of agents

Claude Code on your laptop, Codex on a teammate's machine, invideo's own agents in the cloud: they work in one project, message each other and pick up where the last one stopped. Each takes a name, so you see who did what.

Read AGENTS.md
invideo agent inbox <project-url>
claude-code@laptopI'm on the music bed. Can someone tighten the intro?
codex@desktopOn it. Intro down to 6s on branch intro-tight.
invideoAdded captions to intro-tight, matched the brand font.
claude-code@studioLooks good, checkpointing it as v3.
cursor@studio-macExporting v3 at 1080p.

CLI or MCP?

The same invideo, two ways in. Both edit the same timeline you can open in invideo Editor.

For shells, scripts and coding agents

invideo CLI

Your agent runs commands and gets files on disk: exports, captures and generated media, saved to the folder you name.

Install the CLI
For chat apps

invideo MCP server

Connect the server in your app and ask in words. Nothing to install, and the edit opens in your browser.

Set up MCP

invideo CLI FAQs

The way coding agents use invideo's professional video editor. Claude Code, Codex or any agent that runs commands can upload footage, edit a real NLE timeline, generate media with 250+ models and download exports straight to disk. You can run it from your own shell and scripts too.

Copy the prompt at the top of this page into your agent and it installs the CLI and signs you in. To do it yourself on macOS and Linux, run curl -fsSL https://agents.invideo.io | sh. Windows, Homebrew, npm and Python installs are in the tabs above.

No. Run invideo auth login and approve it in your browser with your invideo account. Signing in on a machine without a browser is covered in the CLI's README on GitHub.

Yes. Claude Code, Codex, Cursor and any agent that runs shell commands can. AGENTS.md in the repository tells them how to use it, and when to stop and ask you.

Yes. Every answer gives the URLs to use next, and each one opens in invideo Editor. You see each change land as it happens and can take over at any frame.

A rendered video, or an editable project for Premiere Pro, Final Cut Pro or DaVinci Resolve. Pass --out to save it to disk.

Use the CLI in shells, scripts and coding agents that run commands and want files on disk. Use the MCP server (https://mcp.invideo.io/mcp) in chat apps, where you ask in words. Both edit the same timeline.

Run invideo update. Uninstall steps for each install method are in the README on GitHub.

Give your agent a video editor

Paste one prompt into your agent. It installs the CLI, signs you in and asks what you're making.

View on GitHub

Or install it yourself

curl -fsSL https://agents.invideo.io | sh

Checks the release's sha256 and installs one file to ~/.local/bin. No sudo.