🤖 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.

Local dev workflow

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

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.
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

Command	Description
`orazaka agent`	Manage Orazaka local executing agent
`orazaka agent listen`	Start CLI agent listener and reverse tunnel
`orazaka chat [prompt...]`	Execute interactive REPL or single-shot chat
`orazaka config`	Interactive configuration wizard — review and update .env variables
`orazaka db`	Database maintenance operations
`orazaka db reseed`	Drop & re-apply infra/initdb/*.sql (schema + seed). Destroys all local dev data.
`orazaka demo`	Demonstration persona on the local stack (never on a deployed one)
`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, Admin, Mobile)
`orazaka docs`	Code-driven documentation: build (generate) \| sync (to the site)
`orazaka docs build`	Regenerate docs/_generated/ from the code
`orazaka docs sync`	Copy docs/ (+ generated) into the Krizaka site content tree
`orazaka doctor`	Advanced system health check with automatic recovery suggestions
`orazaka forgot [email]`	Request a password reset token via email
`orazaka generate` (alias `gen`, `scaffold`)	Generate features, interceptors, connectors, and configurations
`orazaka graph`	Display Operation Graph capability matrix
`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`	Manage your private dynamic MCP server connections
`orazaka mcp list`	List your registered private MCP servers
`orazaka mcp register`	Register a new private MCP server
`orazaka mcp delete <id>`	Delete a private MCP server by ID
`orazaka models`	Scan the host hardware and report which catalog models it can run
`orazaka onboard`	Full clone-and-run onboarding: verify prerequisites, compile, smoke-test M2M handshake, and probe local AI runtimes
`orazaka pack`	Validate, install and publish pack bundles
`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 profile`	Display authenticated user profile information
`orazaka recover`	Diagnose and recover from common issues
`orazaka register [username] [email]`	Register a new user account
`orazaka reset [token]`	Reset account password using a valid reset token
`orazaka settings`	Manage user settings and preferences
`orazaka settings get`	Get all settings and preferences
`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`	Browse, install and run installable business workflows
`orazaka studio list`	Browse the Studio catalogue
`orazaka studio installed`	List the Studios you have installed
`orazaka studio install <studioKey>`	Install a Studio into your workspace
`orazaka studio run <installationId>`	Run an installed Studio
`orazaka studio logs <runId>`	Show a run's per-step state and results
`orazaka test [mode]`	Run the test pyramid: unit \| it (Testcontainers) \| e2e (hermetic)
`orazaka verify [token]`	Verify account registration token
`orazaka video <prompt>`	Generate video from a text prompt

Arguments and options

`orazaka chat [prompt...]`

Execute interactive REPL or single-shot chat

Argument / option	Description
`[prompt...]`	Optional prompt words for single-shot chat
`-t, --text`	Force text chat mode
`-i, --image <path>`	Analyze a poster image
`-a, --audio <path>`	Analyze an audio clip
`-g, --gen-image`	Generate an image
`-s, --speech`	Convert text to speech
`-m, --model <model>`	Specify AI model name
`-v, --voice <voice>`	Specify voice name
`-o, --save <path>`	Specific file path to save output media

`orazaka config`

Interactive configuration wizard — review and update .env variables

Argument / option	Description
`-l, --list`	List all current configuration values
`-c, --category <name>`	Jump directly to a specific category

`orazaka db reseed`

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

Argument / option	Description
`-y, --yes`	Skip the destructive-action confirmation prompt

`orazaka demo seed`

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

Argument / option	Description
`--fresh`	Delete Eric's conversations first, for a demo that starts from a clean history
`--runs`	Also run Eric's demo work on this stack: a product photo, a voice-over, a prospect dossier, a lease check, an invoice check
`--with-video`	With --runs, also generate a few seconds of video (loads a video model: one heavy job, never by default)

`orazaka dev`

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

Argument / option	Description
`--only <services>`	Launch only these services (comma-separated: edge,router,identity,automation,knowledge,job,billing,studio,notifications,web,admin,mobile)
`--skip-edge`	Skip the Edge gateway (strangler facade on :8088)
`--skip-identity`	Skip the Identity service (:8083)
`--skip-router`	Skip the Router (Spring Boot) backend — run RouterApplication from your IDE instead
`--skip-core`	Deprecated alias for --skip-router
`--skip-automation`	Skip the Automation service (AMQP on :8082)
`--skip-knowledge`	Skip the Knowledge service (:8084)
`--skip-job`	Skip the Job Orchestration service (:8090)
`--skip-billing`	Skip the Billing service (:8095)
`--skip-studio`	Skip the Studio service (:8096)
`--skip-notifications`	Skip the Notification service (:8097)
`--skip-admin`	Skip Admin console
`--skip-mobile`	Skip Expo mobile server
`--skip-web`	Skip Web client
`--skip-workers`	Skip the Python workers declared by worker.yaml

`orazaka docs build`

Regenerate docs/_generated/ from the code

Argument / option	Description
`--check`	Fail if any generated doc is stale (build gate), without writing

`orazaka doctor`

Advanced system health check with automatic recovery suggestions

Argument / option	Description
`-q, --quiet`	Only show issues, suppress passing checks
`--fix`	Attempt to auto-fix detected issues
`-v, --verbose`	Show detailed diagnostic output

`orazaka forgot [email]`

Request a password reset token via email

Argument / option	Description
`[email]`	Account email address

`orazaka init`

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

Argument / option	Description
`-f, --force`	Overwrite existing configuration
`-y, --yes`	Non-interactive mode with defaults
`--skip-validation`	Skip diagnostic checks
`--dir <path>`	Target directory (default: current directory)

`orazaka install`

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

Argument / option	Description
`--check-only`	Read-only: verify tool availability & versions, then exit (no .env / compose changes)
`-y, --yes`	Non-interactive mode — accept every default (clone, tools, local dev topology, bundled infra)
`--dir <path>`	Where to clone the platform when no workspace is found (default: `orazaka`)
`--depth <n>`	git clone depth for the platform repositories (0 = full history) (default: `1`)

Authenticate and cache JWT token

Argument / option	Description
`[email]`	Account email address
`[password]`	Account password

`orazaka logs`

Stream and browse service logs

Argument / option	Description
`--service <name>`	Tail a specific service (router, ollama, media-worker, image-worker, ui)
`--list`	List all available log files with sizes
`--since <duration>`	Show logs from last N hours (e.g., 1h, 30m) (default: `24h`)
`--tail <lines>`	Number of lines to show from end of file (default: `50`)

`orazaka mcp register`

Argument / option	Description
`--auth-token <token>`	Optional authorization token/header

`orazaka pack validate <directory>`

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

Argument / option	Description
`<directory>`	The bundle directory holding pack.yaml
`--offline`	Check the manifest's shape only, without asking the platform

`orazaka pack install <directory>`

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

Argument / option	Description
`<directory>`	The bundle directory holding pack.yaml, or a directory of bundles with --all
`--all`	Install every bundle in the directory — what a fresh database needs

`orazaka pack publish <directory>`

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

Argument / option	Description
`<directory>`	The bundle directory holding pack.yaml

`orazaka pack list [directory]`

List the bundles this deployment's pack sources offer

Argument / option	Description
`[directory]`	Look in this directory instead of the configured sources

`orazaka register [username] [email]`

Argument / option	Description
`[username]`	Desired username
`[email]`	Account email address
`-l, --language <lang>`	BCP 47 language tag (e.g. en, ja)

`orazaka reset [token]`

Reset account password using a valid reset token

Argument / option	Description
`[token]`	Password reset token

`orazaka settings set <key> <value>`

Set a user preference key-value pair

Argument / option	Description
`<key>`	Preference key to set
`<value>`	Preference value to set

`orazaka start`

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

Argument / option	Description
`--mode <mode>`	Startup mode: dev (default, infra + AI engines) or full (also Router + Next.js UI) (default: `dev`)
`--only <service>`	Start only a specific service (postgres, redis, rabbitmq, ollama, localai, image-gen, media-worker)
`--skip-health`	Skip final health verification
`--wait-timeout <ms>`	Timeout for service startup (default: 60000ms) (default: `60000`)
`--allow-partial`	Allow partial startup (some services may fail)
`--verbose`	Show detailed startup logs
`--logs`	Tail log files after startup

`orazaka status`

Show live status of all Orazaka services

Argument / option	Description
`--json`	Output status as JSON
`--watch`	Refresh every 5 seconds

`orazaka stop`

Teardown the Orazaka infrastructure — containers, workers, and state

Argument / option	Description
`--purge`	Also purge database data and upload directories
`-y, --yes`	Skip confirmation prompts

`orazaka studio list`

Browse the Studio catalogue

Argument / option	Description
`-p, --profession <trade>`	Filter by trade

`orazaka studio install <studioKey>`

Install a Studio into your workspace

Argument / option	Description
`<studioKey>`	The Studio to install
`-c, --config <pairs>`	Configuration as key=value,key2=value2

`orazaka studio run <installationId>`

Run an installed Studio

Argument / option	Description
`<installationId>`	The installation to run
`-i, --inputs <pairs>`	Inputs as key=value,key2=a\|b\|c (pipes make a list)

`orazaka studio logs <runId>`

Show a run's per-step state and results

Argument / option	Description
`<runId>`	The run to inspect

`orazaka verify [token]`

Verify account registration token

Argument / option	Description
`[token]`	Email verification token

`orazaka video <prompt>`

Generate video from a text prompt

Argument / option	Description
`<prompt>`	Text prompt describing the desired video
`-d, --duration <seconds>`	Duration of the video in seconds (default: `4`)
`-m, --model <model>`	Specify AI model name
`-o, --output <path>`	Specific file path to save the video

Présentation du produit →

CLI

Quick startCopy Anchor Link

Local dev workflowCopy Anchor Link

CommandsCopy Anchor Link

Arguments and optionsCopy Anchor Link

orazaka chat [prompt...]Copy Anchor Link

orazaka configCopy Anchor Link

orazaka db reseedCopy Anchor Link

orazaka demo seedCopy Anchor Link

orazaka devCopy Anchor Link

orazaka docs buildCopy Anchor Link

orazaka doctorCopy Anchor Link

orazaka forgot [email]Copy Anchor Link

orazaka initCopy Anchor Link

orazaka installCopy Anchor Link

orazaka login [email] [password]Copy Anchor Link

orazaka logsCopy Anchor Link

orazaka mcp registerCopy Anchor Link

orazaka pack validate <directory>Copy Anchor Link

orazaka pack install <directory>Copy Anchor Link

orazaka pack publish <directory>Copy Anchor Link

orazaka pack list [directory]Copy Anchor Link

orazaka register [username] [email]Copy Anchor Link

orazaka reset [token]Copy Anchor Link

orazaka settings set <key> <value>Copy Anchor Link

orazaka startCopy Anchor Link

orazaka statusCopy Anchor Link

orazaka stopCopy Anchor Link

orazaka studio listCopy Anchor Link

orazaka studio install <studioKey>Copy Anchor Link

orazaka studio run <installationId>Copy Anchor Link

orazaka studio logs <runId>Copy Anchor Link

orazaka verify [token]Copy Anchor Link

orazaka video <prompt>Copy Anchor Link

Sur cette page