Video Edit CLI
A video-editing tool for AI agents. Your agent gets a headless editing workbench — inspect, transcribe, cut, master, and package video — plus a bundled skill that teaches it how to edit well.
Works with any coding agent that supports skills: Claude Code · Codex · Cursor · GitHub Copilot · Pi · and others.
Get started
Install the skill into your project with skills.sh:
npx skills add computerlovetech/video-edit-cli --skill video-edit-cli
Then ask your agent to edit a recording:
Make clips for YouTube Shorts from this video, with burned-in subtitles: https://youtu.be/r1Kh5WssSPg
That's it. The skill guides the agent through the whole workflow, including
installing the CLI itself. Only ffmpeg/ffprobe must be present.
More prompts that work well: example prompts. Have a good one? Add it.
How it works
The CLI exposes atomic, deterministic subcommands; the agent plans the edit
and composes the primitives. Every command prints one JSON result on stdout,
source media is immutable, and every derived file gets a *.provenance.json
sidecar recording exactly how it was made.
video-edit-cli workspace init --root /tmp/ep1 --source recording.mp4
video-edit-cli probe --input recording.mp4
video-edit-cli filmstrip create --input recording.mp4 \
--start 60 --end 90 --output /tmp/ep1/analysis/strip.png --workspace /tmp/ep1
Direct install: uv tool install video-edit-cli (Apple Silicon transcription:
uv tool install 'video-edit-cli[mlx]'). Discover the full command surface
with --help on any subcommand, and check dependencies with
video-edit-cli doctor.
Runs on macOS and Linux. Windows is untested; use WSL.
Docs
Full documentation: https://computerlovetech.github.io/video-edit-cli/
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file video_edit_cli-0.1.2.tar.gz.
File metadata
- Download URL: video_edit_cli-0.1.2.tar.gz
- Upload date:
- Size: 62.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.11.17 {"installer":{"name":"uv","version":"0.11.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f2a7b814a5736565ef2a214265876c7ed02d82de5fe6aeae4a41338d137acb3b
|
|
| MD5 |
b749ba1ded848b9d41d8726d851831a7
|
|
| BLAKE2b-256 |
235eb2e0151fa5f80dd15ee3ac05a4eb750271bc77a6d9744389345c837cbfbf
|
File details
Details for the file video_edit_cli-0.1.2-py3-none-any.whl.
File metadata
- Download URL: video_edit_cli-0.1.2-py3-none-any.whl
- Upload date:
- Size: 66.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.11.17 {"installer":{"name":"uv","version":"0.11.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7f106dbc148c07c6b2ffebdf1a1dbb7a0345901cf5ebc4b53364b71dcee3ca40
|
|
| MD5 |
9c0de21f8a85e5f60b0f855c8f9e083b
|
|
| BLAKE2b-256 |
6387fa0386052bf513568b1413cf6b132e5b2409c5fcbbe5708b646dbc01f773
|
