vg generate: model endpoint runner

vg generate is the agent-first CLI for generating images, video, and audio. It works in a terminal for humans (pretty output) and equally well for agents (structured JSON when piped or with --json). All other skills in this repo call vg generate for execution; they do not wrap any model HTTP API directly. Every call is forwarded through a single vibedgames server proc that attaches the credentials and proxies the request.

Vibedgames runtime. Install with npm install -g vibedgames (or pnpm dogfood in this repo). The vibedgames server holds the API key, so there is no per-machine setup. The CLI exposes run, status, models, schema, upload, pricing, and docs — the read/write surface that maps to the queue, platform, storage, and docs APIs.

For the full command surface (every flag, every option, every example), see references/full-reference.md. For setup details, see the Setup section below.

Critical rules

1. Always use --json when an agent will read the output. Pretty mode is for humans only.
2. Never invent endpoint IDs. Use vg generate models "<query>" to discover, vg generate models --endpoint_id <id> to verify.
3. Inspect schema before running. vg generate schema <endpoint_id> --json shows the exact field names. Guessed flags fail with 422.
4. Save files with --download, not curl. The CLI handles authentication, naming, and file format detection.
5. Use --async for long-running generation. Image work usually completes inline; video/audio/3D usually need queue + status polling.

Command index