BatchEdits CLI

Edit up to 50 videos at once from your terminal or AI agent. One command uploads a folder, adds captions, removes silences, crops to 9:16 and downloads the results.

Install

terminal

npm install -g batchedits

# or run it without installing:
npx batchedits --help

Needs Node.js 18.17 or newer. Processing uses the credits on your plan or free trial.

Quick start

1.Opens your browser to approve the CLI. The token is stored locally and never printed.
terminal
```
batchedits login
```
2.One reusable style: vertical crop, silence removed, captions, zoom on key moments.
terminal
```
batchedits style create "Shorts" --crop 9:16 --silence --captions --zoom
```
3.Uploads up to 50 videos, edits them, waits and downloads the results.
terminal
```
batchedits run ./raw --style "Shorts" --out ./edited
```

Commands

Command	What it does	Example
login	Sign in through your browser (OAuth). Stored in ~/.config/batchedits.	batchedits login
logout	Remove the stored login.	batchedits logout
whoami	Check that you're signed in and connected.	batchedits whoami
styles	List your saved and built-in styles.	batchedits styles
actions	List editing actions and their settings.	batchedits actions
style create	Create a style from flags: --captions --emojis --silence --repeats --crop <ratio> --zoom --clips [n].	batchedits style create "Podcast clips" --clips 8 --crop 9:16 --captions
upload	Upload local videos or a folder (up to 50) and print their ids.	batchedits upload ./raw
process	Edit videos with a style. Uses 1 credit per video (1 per AI clip); asks first, or pass --yes.	batchedits process <id> <id> --style "Shorts" --yes
status	Show video status; --watch waits until they (and their AI clips) are done.	batchedits status <id> --watch
download	Download finished videos (and their AI clips) to --out.	batchedits download <id> --out ./edited
run	Upload, edit, wait and download in one command.	batchedits run ./raw --style "Shorts" --out ./edited --yes

--json Machine-readable output on stdout (progress goes to stderr).
--yes Confirm credit use without a prompt. Required when there's no terminal (agents, scripts).
--host <url> Use another BatchEdits host (default https://batchedits.com).
-h, --help Help for any command, with an example.

Sign in

batchedits login opens BatchEdits in your browser to approve the CLI, then stores the login in ~/.config/batchedits. The token is never printed, so an agent can run commands without ever seeing it. On servers and CI, set BATCHEDITS_API_KEY with a key from your settings.

Use it from an AI agent

Claude Code, OpenClaw, Hermes and Codex run the CLI directly. Paste this into your agent's instructions or skill file:

SKILL.md

Edit videos with the BatchEdits CLI (run `npx batchedits --help` for all commands):
- Sign in once: `npx batchedits login` (or set BATCHEDITS_API_KEY).
- List styles: `npx batchedits styles --json`
- Edit a folder end to end: `npx batchedits run <folder> --style "<style name>" --out <folder> --yes --json`
- Processing uses credits: confirm with the user before passing --yes.
- Exit code 5 means re-run with --yes; 3 means sign in first.

For ChatGPT, claude.ai and other remote agents, connect the MCP server instead.

Exit codes

0 Done
1 Error (the message says what happened)
2 Wrong usage (unknown flag, missing file)
3 Sign in needed: run batchedits login or set BATCHEDITS_API_KEY
4 Some videos failed or weren't ready
5 Needs confirmation: re-run with --yes