CLI reference

🤖 Generated from code by scripts/generate-docs.mjs — do not hand-edit. Run orazaka docs build to refresh.

The orazaka CLI is the single orchestrator of the platform: it clones and configures the workspace, starts the infrastructure, runs the whole stack, tests it, builds these docs and installs packs. No shell script to remember — one command per intent.

Quick start

Requirements: git, JDK 21, Node.js >=22, Docker (Python 3.11+ for the media worker).

npx orazaka install   # no workspace here? clones the platform into ./orazaka, then configures it
cd orazaka && ./mvnw install && (cd orazaka-apps/ui && npm install)
npx orazaka start     # Docker infrastructure (PostgreSQL + pgvector, Redis, RabbitMQ)
npx orazaka dev       # the whole stack: services, web, admin, mobile

orazaka on npm is the short name of the canonical package @krizaka/orazaka-cli — both run the same CLI:

npx @krizaka/orazaka-cli install      # the same as npx orazaka install
npm install -g @krizaka/orazaka-cli   # then: orazaka <command>

install --check-only only reports what is missing. start, dev, test and docs run inside a workspace and say how to get one when there is none.

What happens

What each command of the quick start does, in order — the phases it announces, the processes it launches:

Local dev workflow

The dev loop has two layers — start them in order:

1. Infrastructure — orazaka start --mode dev brings up the Docker middleware (PostgreSQL+pgvector, Redis, RabbitMQ) and the native AI engines (Ollama, LocalAI, video worker). Inference runs natively on macOS Metal — never in Docker.
2. Applications — orazaka dev spawns the services (edge, conversation router, identity, automation, knowledge, job, billing, studio, notifications), the Web client, the Web admin and the Expo mobile server in parallel. Prefer to debug the conversation router in your IDE? Run ConversationServiceApplication there and start the rest with orazaka dev --skip-router.

orazaka start --mode full additionally runs the router and the UI for a hands-off boot. Tear everything down with orazaka stop. On a local stack, orazaka demo seed creates the demo persona with its plan, packs and Studios.

ℹ️ start manages infrastructure; dev manages application processes. They are complementary, not alternatives.

Commands

Arguments and options

orazaka chat [prompt...]

Execute interactive REPL or single-shot chat

orazaka cinema new <dir>

Start a production from a brief

orazaka cinema estimate <dir>

What the rest of the production will cost and take, before it runs

orazaka cinema run <dir>

Run (or resume) the production: script, references, keyframes, shots, cut, voice, sound

orazaka cinema fetch <dir>

Download the references, keyframes, shots and the film into the production's folder

orazaka cinema reshoot <dir> <shots>

Make shots again (a new seed): their video, then the cut and the sound

orazaka cinema status <dir>

Where the production is

orazaka cinema plan <dir>

Start a production from a treatment (a directed shot list): no language model, every shot as written

orazaka cinema sheet <dir>

Make the reference sheet of each character that has a reference render (kept as drawn, never redrawn)

orazaka cinema jobs <dir>

The pending shots as jobs for a GPU host that runs the worker's own generator

orazaka cinema take <dir> <shot> <file>

Record a take a GPU host made for a shot

orazaka cinema review <dir> <shot> <file>

A take's review sheet: a frame every 8 under the cast's reference sheet

orazaka cinema treat <dir>

Write the story of a brief (arc, intentions, purposeful shots, directed lines, music cues, sound list) and judge it

orazaka cinema critique <treatment>

Judge a treatment against the rubric (arc, purpose, alive, on-topic, continuity, voice, music, sound)

orazaka cinema timeline <treatment>

Place every line, music cue and sound of a treatment on the cut, and say which lines do not fit their shots

orazaka cinema stage <treatment>

Check a v3 treatment's staging, camera and cut, and write the questions every keyframe and take must answer

orazaka config

Interactive configuration wizard — review and update .env variables

orazaka db reseed

Drop & re-apply infra/initdb/*.sql (schema + seed). Destroys all local dev data.

orazaka demo seed

Create or refresh Eric, the demo persona: account, onboarding, plan, packs and Studios (replayable)

orazaka dev

Launch the full Orazaka application stack in parallel (9 services + Web, Mobile)

orazaka docs build

Regenerate docs/_generated/ from the code

orazaka doctor

Advanced system health check with automatic recovery suggestions

orazaka forgot [email]

Request a password reset token via email

orazaka init

Initialize workspace — detects existing projects, validates config, and fixes gaps

orazaka install

Setup wizard — verify tools, install dependencies, and configure deployment topology

orazaka login [email] [password]

Authenticate and cache JWT token

orazaka logs

Stream and browse service logs

orazaka mcp register

Register a new private MCP server

orazaka models pull <id>

Download an image model into ~/models/stable-diffusion and verify its checksums

orazaka models use <id>

Make an installed image model the catalogue's default — the one orazaka start serves

orazaka pack validate <directory>

Check a bundle's manifest, and whether this platform can run it

orazaka pack install <directory>

Install a bundle: capabilities, billing and catalogue, or none of them

orazaka pack publish <directory>

Put an installed bundle's pack and Studios on the shelf

orazaka pack list [directory]

List the bundles this deployment's pack sources offer

orazaka register [username] [email]

Register a new user account

orazaka release verify <manifest>

Check a release manifest, and with --dir the artefacts of an offline bundle against it

orazaka reset [token]

Reset account password using a valid reset token

orazaka settings set <key> <value>

Set a user preference key-value pair

orazaka start

Start Orazaka infrastructure — dev mode (Docker middleware + AI engines) or full mode (also Router + UI)

orazaka status

Show live status of all Orazaka services

orazaka stop

Teardown the Orazaka infrastructure — containers, workers, and state

orazaka studio list

Browse the Studio catalogue

orazaka studio install <studioKey>

Install a Studio into your workspace

orazaka studio run <target>

Run an installed Studio — or, with --studio, a toolkit Studio by its key

orazaka studio logs <runId>

Show a run's per-step state and results

orazaka verify [token]

Verify account registration token

orazaka video <prompt>

Generate video from a text prompt