Command line (CLI)
Install the videodraft CLI, sign in, and generate video, images, audio, and 3D assets from your terminal or from CI.
Install and sign in#
The official CLI is published on npm as videodraft under the MIT license. It requires Node 20.18.1 or newer. A Homebrew tap and a curl installer are in progress, so npm is the supported channel today.
npm install -g videodraft
videodraft --versionSign in once in your browser. For CI, set VIDEODRAFT_API_KEY to a token from app.videodraft.ai/mcp-keys and skip the login step. Credentials live in ~/.config/videodraft/config.json, and videodraft logout revokes and clears them.
videodraft login
videodraft whoamiGenerate assets#
A standalone image, clip, voiceover, track, or 3D model is a complete deliverable and does not need a project. Add --estimate to price a job before you spend anything.
videodraft generate image "a red fox in snow, cinematic" --download ./out/
videodraft generate video "slow dolly over a misty lake" --duration 6 --estimate
videodraft generate voiceover "Welcome to VideoDraft" --download welcome.mp3
videodraft create "30s launch video for our espresso machine" --ar 9:16- Every command takes --json, and exit codes are stable enough to branch on.
- Async jobs are first-class: submit, then poll for the result.
- videodraft costs prices a model before you run it.
Teach a coding agent to use it#
The CLI ships an agent skill covering model choice, references, async polling, and costs. Installing it means Claude Code, Codex, and Cursor know how to produce video without being told each time. The CLI detects which agents you have and writes the skill only where it belongs.
videodraft skills installInside VideoDraft ADE this is already done
ADE bundles its own copy of the CLI and gives every chat the exact path to it. Agents there use that path rather than PATH, npx, or a global install.