Command line

The Caranguejo CLI

Generate images and videos across every model without leaving your terminal — or let Claude Code / Cursor drive it for you.

Install Prefer MCP?

Install

Node 18+ required. The install script drops the binary and adds it to PATH.

bash

npm install -g @caranguejo/cli

Sign in

Opens a browser and stores your key (or set CARANGUEJO_API_KEY). Get a key in Account → Apps & API.

bash

caranguejo auth login

Generate

Any model or tool by slug. Add --wait to block until the result is ready.

bash

# text → image, wait for the result
caranguejo generate image "a red crab on a neon beach" --wait

# any model, generic
caranguejo generate seedance-2 --prompt "a wave crashing" --wait

# a post-production tool over a file
caranguejo generate upscale --input ./photo.jpg --wait

Commands

Command	What it does
`auth login / status / logout`	Manage your API key.
`generate <slug> [--prompt] [--input] [--wait]`	Dispatch any model or tool.
`generate image <prompt>`	Text→image shortcut.
`models list [--type]`	List all models and tools.
`models get <slug>`	Capability schema for a model.
`upload <path>`	Host a local file, print its URL.
`generations [--limit]` · `balance`	List your jobs · show credit balance.

Read the docs Agent Skills