@zorqai/cli

Zorq AI command-line interface — generate images, videos, and audio from your terminal or CI.

Install

npm i -g @zorqai/cli

Requires Node.js 18+.

Quick start

zorq auth login
zorq generate image "a cat in space, cinematic lighting" --aspect-ratio 16:9

Inline image preview

Generated images render directly in your terminal if you use one that supports the iTerm2 Inline Images Protocol or Kitty graphics:

• iTerm2 (macOS) — brew install --cask iterm2
• WezTerm — brew install --cask wezterm
• Kitty — brew install --cask kitty
• Ghostty — brew install --cask ghostty

In Apple Terminal / GNOME Terminal / etc you'll just see the URL — open it in a browser, or download with zorq download <id>.

Commands

Auth

• zorq auth login — Open a browser, sign in to your zorqai.com account, and store a token at ~/.config/zorq/token.json.
• zorq auth logout — Forget the saved token.
• zorq auth whoami — Print your email and remaining credit balance.

List

• zorq list models — Print available models (id, name, type, credit cost).
• zorq list generations [--type image|video] [--limit 10] — Recent generations.

Generate

• zorq generate image <prompt> [--model V8] [--aspect-ratio 1:1] [--ref <url>]
• zorq generate video <prompt> [--model "WAN 2.2"] [--duration 5] [--resolution 720p] [--source-image <url>]
• zorq generate tts <text> [--voice <id>] [--model minimax]
• zorq motion-control --image <url> --video <url> [--prompt "..."] [--mode std|pro]

By default, generate waits for completion and prints the output URL. Pass --no-wait to return immediately with just the generation id.

Status & download

• zorq check <id> [--type image|video] — Show status and (if ready) the output URL.
• zorq download <id> [--type image|video] [--output ./out.mp4] — Download the rendered file.

Examples

# Submit and wait
zorq generate image "neon kraken in tokyo rain" --model V8 --aspect-ratio 16:9

# Fire-and-forget, then check later
ID=$(zorq generate video "drone over fjord" --no-wait | tail -n1)
zorq check "$ID" --type video
zorq download "$ID" --type video --output ./fjord.mp4

# Recent renders
zorq list generations --type video --limit 5

Auth & token storage

• OAuth 2.0 + PKCE against https://jktjxzjyhbbxlxrfmcdk.supabase.co (Zorq's Supabase project).
• Token is stored at ~/.config/zorq/token.json with mode 0600.
• Override the directory with XDG_CONFIG_HOME.

CI usage

Run zorq auth login once on a developer machine, then copy ~/.config/zorq/token.json to your CI runner under the same path. (A non-interactive API-key flow is on the roadmap.)

Docs

Full developer docs: https://zorqai.com/developers