Vmake Labs CLI

Create video content, enhance images and videos, remove text or watermarks, add dynamic captions, and generate montages from the terminal.

Install and start

Requires Node.js 20.3 or later. The CLI installs its platform-specific ffprobe through npm dependencies; no separate FFmpeg installation is needed.

npm install -g --include=optional [email protected] --registry=https://registry.npmjs.org/
vmake chat -p 'Plan a short promotional video for a coffee brand.'
vmake --help

Use vmake <command> --help for parameters. Media commands include tool, subtitle, and mixed-cut. This package targets vmake / release. Pass CLI_ENV=pre|beta|release to each process. Credentials, identity and configuration directories use Vmake CLI_* variables; credentials are stored under ~/.vmake/profiles/<env>/. The upload SDK is embedded. Region selection has been removed.

Use vmake auth login with your Vmake account. For pre-release verification, pass CLI_ENV=pre to login, status checks, and business commands with the same configuration directory. Verify each environment and release artifact independently; historical service checks do not certify a new package. On failure, report the actual error without switching applications or accounts.

Preflight and execution

Run vmake contracts to inspect input contracts. Media commands support --params-file <path> --validate-only --json for local validation without authentication, uploads, or submission. Do not combine a parameter file with explicit business flags. Remove --validate-only for execution.

Montage accepts 1–20 images, videos, or mixed assets. Analyze first, present the actual ready Brief, obtain confirmation, then generate a talking or material video.

Output

Business stdout contains one JSON value per line, preserving complete HTTP responses or SSE events and unknown fields. Local diagnostics use stderr with source:"cli"; read the streams separately. Exit code 0 can mean acceptance, a snapshot, or detach. Confirm an explicit successful terminal state and output files before reporting completion. The full protocol and migration reference lives in the source repository at docs/cli-technical-design.md.