Wizard

Capabilities How it works Runtime About Providers Security

CLI Reference Manual v4.0.0

The wizard CLI.

A single static Go binary that manages the backend control plane, Python sandboxes, and Next.js workbenches as background services across macOS, Linux, and Windows.

Global Installation via Homebrew (macOS, Linux)

Install Wizard globally with a single command

brew install Wizard-AIA/wizard/wizard

Command Reference

12 Subcommands

wizard initLifecycle

Guided first-run setup: choose a provider and models, check prerequisites, install dependencies.

On a terminal it is interactive: menus you move through with the arrow keys, an API key field that shows one bullet per character (never the key), and model lists fetched from your provider so you never type a model name or a URL. Python 3.12+, Node 20+, uv and pnpm are minimums, so any newer version you already have is used; only missing tools are installed. Scripts use --non-interactive.

Flags & Options

--provider <name>Default provider (ollama, lmstudio, anthropic, openai, gemini, custom_gateway)

--data-mode <mode>Data residency policy (local-only, hybrid, cloud-only)

--manager-model <name>Model for the manager role (skips the picker)

--worker-model <name>Model for the worker role (skips the picker)

--embedding-provider <name>Provider for embeddings (ollama, lmstudio, openai, gemini, custom_gateway)

--embedding-model <model>Embedding model (e.g. nomic-embed-text, gemini-embedding-001, text-embedding-3-small)

--gemini-key / --anthropic-key / --openai-key / --lmstudio-key <key>Write that provider's API key to backend/.env

--gateway-url <url> / --gateway-key <key>Endpoint and bearer token for a custom OpenAI-compatible gateway

--base-url <url>Point --provider at a proxy instead of its official endpoint

--interactiveForce the guided prompts even when other flags are given

--non-interactiveNever prompt; for CI and scripted installs (no network lookups)

--install-prerequisitesInstall missing Python, Node.js, uv and pnpm without asking

--no-install-prerequisitesOnly check prerequisites; never install

--pull-modelsAlso pull a default manager, worker and embedding model through Ollama

wizard startSupervisor

Launches the backend and frontend in the background and opens the browser.

Starts the detached supervisor, waits until the backend answers healthy, checks its API version against this binary, then opens the workspace. Ports are validated (1-65535).

Flags & Options

--backend-port <port>Backend port (default 8000)

--frontend-port <port>Frontend port (default 3000)

--no-browserDo not open a browser once healthy

--timeout <seconds>How long to wait for the backend to become healthy (default 90)

wizard stopSupervisor

Stops the background services.

Idempotent. Asks the supervisor to stop and waits for it to clean up; falls back to a forced stop of the recorded processes if it does not exit in time.

wizard doctorDiagnostics

Checks this installation and tells you how to fix what is wrong.

A read-only report with PASS, WARN or FAIL for the version, platform, install method, whether wizard is on your PATH, the bundled files, the settings directory, Python, Node, uv and pnpm, your configuration and credentials, and the running service. It works even when the bundled files cannot be found. Exits 3 if a check fails.

Flags & Options

--jsonPrint the report as JSON, for scripts and support tickets

--networkAlso test GitHub Releases and your configured model provider

wizard statusDiagnostics

Shows what is running and the active configuration.

Daemon, backend and frontend state, log sizes, API_PROVIDER, DATA_MODE and EXECUTION_BACKEND, plus the backend's own /api/config (host sizing, sandbox capability) when it answers.

wizard attachObservability

Follows the backend and frontend logs live.

Prints status, then streams both logs with source prefixes until Ctrl+C. Read-only.

wizard logsObservability

Prints log file locations and recent output.

A one-shot look at where the logs are and, with --tail, their last lines.

Flags & Options

--tail <N>Also print the last N lines of each log

wizard updateLifecycle

Updates Wizard, using the right mechanism for how it was installed.

For an installer-managed install it checks GitHub Releases, verifies the archive's SHA-256, stages and prepares the new release, then switches over, keeping the previous one for rollback. A git checkout uses git pull --ff-only. It never overwrites files a package manager owns: on Homebrew or Scoop it prints the command to run (brew upgrade wizard, scoop update wizard).

Flags & Options

--checkOnly report whether a newer release exists

--selfForce the release-install update path

wizard uninstallLifecycle

Removes Wizard; --purge removes everything.

Removes what the official installer created (program, shell startup entries, and on Windows the user PATH entry) and keeps your settings, keys and logs, backing up backend/.env. With --purge it also deletes your data, and lists exactly what it will remove before asking. It refuses git checkouts and package-manager installs, and prints brew uninstall wizard or scoop uninstall wizard instead.

Flags & Options

--purge, --allAlso delete settings, API keys, logs and the Python environment

--yesSkip the confirmation prompt (unattended runs without it are refused)

wizard deleteLifecycle

Stops Wizard and deletes its data; the program stays installed.

Removes user configuration, credentials, connections, skills, logs, the managed virtualenv and backend/.env, after confirmation.

Flags & Options

--yesSkip confirmation; useful for automation

--keep-envKeep backend/.env while removing other managed state

wizard skillsEcosystem

Manages modular analytical skills and domain playbooks.

Fronts the skill engine with a preview of exactly what will be installed and commit pinning.

Flags & Options

listLists all installed skills, source repositories, and active tiers

add <url>Installs a remote skill repository with a preview and commit pinning

update <name>Updates an installed skill to the latest remote revision

discard <name>Discards local modifications to an installed skill

remove <name>Removes a skill package

token <token>Saves a GitHub personal access token for private skill repositories

wizard versionMetadata

Prints the CLI version and the backend API it targets.

For example: wizard CLI v1.0.15, backend API compat v4.0.0. Makes no network request; use wizard update --check to look for a newer release.

Production Deployment Recipes

One-line configuration recipes to initialize Wizard for strict air-gapped security, enterprise cloud providers, or custom internal model gateways.

100% Air-Gapped / Local-Only

Zero data egress. Hard barrier against cloud endpoints.

wizard init --data-mode local-only --provider ollama --pull-models

Requires local Ollama or LM Studio instance. Automatically pulls reasoning & coding models.

Cloud-Native (Gemini / Claude / OpenAI)

Frontier cloud intelligence with telemetry tracking.

wizard init --provider gemini --gemini-key <your-gemini-key> --data-mode cloud-only

Dispatches planning and code generation directly to Gemini 2.5 Flash with sub-second latency.

Enterprise Hybrid Mode

Cloud reasoning with strict row-level data redaction.

wizard init --data-mode hybrid --anthropic-key sk-ant-... --provider anthropic

Raw datasets remain strictly on host; only masked schemas and metadata reach the cloud manager.

Custom OpenAI-Compatible Gateway

Connect Groq, Together AI, OpenRouter, vLLM, or internal corporate LLM gateways.

wizard init --provider custom_gateway --gateway-url https://api.groq.com/openai/v1 --gateway-key gsk_...

Supports any endpoint implementing the standard OpenAI chat completions wire protocol.

Exit Codes & Automation

Standard POSIX exit codes returned by the CLI binary for CI/CD scripting and container health checks.

Code	Symbol	Meaning
0	SUCCESS	The command succeeded (including --help).
1	FAILURE	Any other runtime failure. Run wizard doctor for a diagnosis.
2	USAGE	A bad command line or an invalid value, such as a stray argument or a port outside 1-65535.
3	ENVIRONMENT	A required tool is missing or the installation is broken. wizard doctor says what to fix.
4	NETWORK	A release lookup or download failed. Check your connection or set HTTPS_PROXY.

Deep CLI Architecture & Supervisor Docs →Complete .env Configuration Matrix →