ClipDone CLI

Command line access to ClipDone projects, uploads, processing runs, revisions, status and exports. (ClipDone is an automatic video editing tool.)

Install

Install globally for normal use:

npm install -g @clipdone/cli
clipdone login

For one-off use without a global install:

npx @clipdone/cli login
pnpm dlx @clipdone/cli projects

The CLI requires Node.js 18 or newer.

Login

Authorize the CLI in your browser:

clipdone login

On remote machines or environments where the CLI cannot open a browser automatically:

clipdone login --no-open

Check or remove the current login:

clipdone me
clipdone logout
clipdone revoke

logout removes only the local token. revoke also revokes the current OAuth tokens with ClipDone.

Common workflow

List and create projects:

clipdone projects
clipdone projects create --name "Marketing video"

Upload files:

clipdone projects <project_id> upload ./video.mp4 --type footage
clipdone projects <project_id> upload ./music.mp3 --type music
clipdone projects <project_id> upload ./script.txt --type script

Start processing, inspect status, and download an output:

clipdone projects <project_id> process
clipdone projects <project_id> status
clipdone projects <project_id> outputs
clipdone outputs <output_id> download --out ./clipdone-output.mp4

Create a revision from feedback:

clipdone projects <project_id> revise --feedback "Make the intro tighter."

Run clipdone --help for the full command list.

Automation

For non-interactive CI runs, set CLIPDONE_TOKEN instead of using browser login:

CLIPDONE_TOKEN=cd_... clipdone projects

When CLIPDONE_TOKEN is set, it overrides stored browser login tokens for that command.

Installed CLI usage talks to production ClipDone at https://app.clipdone.app.