@juicylucy/cli

juicy is the command-line tool JuicyLucy's ad-production skills use to generate and retrieve creative assets (first frames, video clips, soundtracks, voiceovers) for coding agents. Every command prints one JSON document on stdout, reports errors as JSON on stderr, and exits with a code an agent can branch on. Generated files are frozen under .media/ with a provenance record in the same call.

Proprietary. This package is published for installation convenience only. The source is not public, and no licence to copy, modify, or redistribute is granted beyond running the tool with a JuicyLucy account. The terms are in the LICENSE file shipped in this package (package.json declares SEE LICENSE IN LICENSE).

Install

The JuicyLucy plugin's setup installs juicy for you. To install by hand:

npm install -g @juicylucy/cli
juicy --help

Requires Node 22 or newer, and network access: every command except --help, auth help, completion, skill and manifest verify reaches the API. A sandbox that blocks the network must allow it first (Codex: network_access = true under [sandbox_workspace_write]); an error with code network means exactly that, so retry with network access.

Use

juicy auth help                        how to sign a user in — agents read this first
juicy auth login                       sign in (a one-time code sent to the account's email)
juicy catalog list                     roles, the models each offers, what each is best for
juicy sample list                      free sample assets
juicy image generate --role first-frame --aspect 9:16 --variant v01 --prompt "…"
juicy video generate --image .media/first-frames/v01.png --duration 12 --variant v01 --prompt "…"
juicy video generate --model kling-3-pro --image … --duration 5 --variant v01-hero --prompt "…" --max-cost 1000
juicy audio music --duration 30 --name bed --prompt "…"
juicy audio voiceover --name vo --voice Puck --style "bright, unhurried" --prompt "…"
juicy manifest verify --project . --require-video
juicy credits balance                  credits left; `juicy credits packs` lists what can be bought
juicy credits topup --pack usd-25      a Stripe payment link for the user to pay in their browser
juicy doctor

Run juicy <noun> <verb> --help, --request-schema, or --response-schema for the full contract of any command.

Exit codes: 0 ok · 1 API or network · 2 usage · 3 sign-in needed · 4 still running (the job JSON is on stdout; run the next command) · 5 insufficient credits.

Licence

The CLI is proprietary. LICENSE permits lawful personal, professional and client use, customization and internal sharing with employees/contractors. External redistribution of the software requires permission; creative outputs are separate. Hosted generation still requires an account and credits and is subject to the service terms.