@generate-slide-video/cli
v0.1.2
Published
Inspection CLI for Generate Slide Video visual checks and spec quality checks.
Readme
@generate-slide-video/cli
gsv provides non-MCP inspection commands for Generate Slide Video specs.
Install
npm install -g @generate-slide-video/cliOr run it without a global install:
npx @generate-slide-video/cli --helpThe npm package name is @generate-slide-video/cli; npx gsv resolves the separate gsv package on npm unless this CLI is already installed locally. Prefer npx @generate-slide-video/cli for one-shot use.
Commands
gsv --help
gsv --help --json
gsv quality-check --tenant-id <tenantId> --video-id <videoId>
gsv quality-check --spec ./spec.json
gsv visual-check --tenant-id <tenantId> --video-id <videoId>
gsv screenshot --tenant-id <tenantId> --video-id <videoId> --out-dir ./screenshots--help --json returns schemaVersion: "gsv-cli-help.v1" with command, option, environment, output, and exit-code metadata for AI/tool consumption.
Visual Check Requirements
- A generate-slide-video server must be running and serving
/api/cli/*. GSV_ACCESS_TOKENmust contain a bearer token withquality:checkscope.- The server URL is normally read from
~/.config/gsv/config.json, written by the installer. --server-urlorGSV_SERVER_URLcan override the configured server URL.--access-token-envcan point to a different environment variable name.- Playwright runs on the server. The CLI does not install or launch Playwright.
--versionis optional. When omitted, the server inspects the current spec.- Exit codes are
0success,1detected issues or all screenshots failed,2usage/spec input error,3runtime failure, and130interrupted.
Prefer exporting GSV_ACCESS_TOKEN in the shell environment, a direnv-managed environment, or another local secret manager. Avoid putting the token inline in commands that may be stored in shell history.
License
MIT
Build
pnpm --filter @generate-slide-video/cli build