Manual

Depaza Code CLI manual

Everything the CLI can do — install, login, every command, the interactive session, the team, configuration and troubleshooting.

See plans & pricing Create your account

Covers depaza v0.27.0 · run depaza --help for the same reference offline.

Install & update

Depaza Code CLI is a Python package (depaza-cli, the depaza command) and needs Python 3.10 or newer. Install it once, globally:

# Recommended — isolated, global (needs pipx)

$ pipx install depaza-cli

# One-line installer (prefers pipx, falls back gracefully)

$ curl -fsSL https://depaza.com/install.sh | bash

# Or with uv (fastest)

$ uv tool install depaza-cli

The CLI checks for a new version in the background on launch (at most once a day, non-blocking). Update manually any time:

depaza update

Check for and install the latest version. · e.g. depaza update --check

Verify with depaza --version. Enable shell tab-completion with depaza --install-completion, then restart your shell.

Login & access

Connect the terminal to your Depaza account once. depaza auth opens your browser, you approve the device, and the key is written to ~/.config/depaza/config.toml (file mode 0600).

depaza auth

Connect this terminal to your account (opens the browser). · e.g. depaza auth --no-browser

depaza whoami

Show the current connection and account status.

depaza usage

Show your plan limits and remaining credit.

All paid plans (Pro and above) have instant Code CLI access. Free accounts can be granted access via a redeem code from an admin.

depaza redeem

Redeem an invite code (for granted free accounts). · e.g. depaza redeem JANNIK

Advanced: paste a key non-interactively with depaza auth --key dpz_live_…, or set DEPAZA_API_KEY in the environment (handy for CI).

Commands

Run depaza with no arguments to open the interactive session, or use a one-shot command. Coding commands accept --model / -m <lite|core|max> and --auto / -y (approve edits and commands automatically).

Coding

depaza chat

Code with Depaza — interactive, or one-shot if you pass a prompt. · e.g. depaza chat "add a /health endpoint"

depaza code

Implement or explain code in one shot. · e.g. depaza code "add pagination to /users"

depaza fix

Find the root cause of a bug, fix it, then verify. · e.g. depaza fix "tests in test_auth are red"

depaza review

Read-only review for correctness and GDPR. Add --pr N for a GitHub PR. · e.g. depaza review src/auth.py

depaza new

Scaffold a new project or feature. · e.g. depaza new "FastAPI service with i18n"

depaza init

Wizard that writes a DEPAZA.md with your project conventions.

depaza pr

Draft a PR from the branch diff and open it with gh. · e.g. depaza pr --base main

depaza screenshot

Build a UI from a screenshot, refined until it matches. Use --paste for the clipboard. · e.g. depaza screenshot ui.png --rounds 3

Team & Council

depaza team

Meet the team — Emma, Bob, Max & Anna.

depaza huddle

Emma, Max & Anna analyze a topic in parallel (read-only), then synthesize.

depaza solve

The Council — solve a task with a decorrelated ensemble, picked by tests. · e.g. depaza solve "RPN evaluator" -t test_rpn.py

depaza eval

Run the curated eval suite through the Council and score it. · e.g. depaza eval --baseline core

depaza solve writes to solution.py by default (-o), authors a pytest oracle if you omit -t, and runs 2–5 Council members (-n, default 4).

Account & system

depaza models

Show the multi-model orchestration strategy.

depaza permissions

Show the tool-permission allow/deny rules in effect.

depaza hosts

List SSH hosts (from ~/.ssh/config) the agent can use for remote ops.

depaza config

Open the interactive configuration UI.

depaza mcp list

List configured MCP servers and their tools.

depaza sync

Sync sessions to your dashboard — on, off or status. · e.g. depaza sync status

Interactive session & slash commands

Run depaza (or depaza chat) to open the session. Type naturally to give the team work; it reads and searches files, makes precise edits and runs commands, then verifies its own changes. Press Shift+Tab to cycle the approval mode shown in the toolbar.

Address a teammate by name for a direct request — Emma, plan the billing flow, Bob, implement it, Anna, review this, Max, check the architecture — or say Team, … to run the full pipeline (Emma plans → Bob builds → Anna reviews).

Slash commands — type / for completion:

/helpShow all commands.

/teamMeet the team / run the full pipeline.

/emma📋 Plan it (PM — never codes).

/bob🐥 Fast first-pass implementation.

/max🦾 Senior: architecture & hard calls.

/anna🔎 QA: tests, edge cases, GDPR.

/huddleWhole team analyzes in parallel, then synthesizes.

/pasteRead a screenshot from the clipboard.

/modelSwitch model (lite | core | max).

/planPlan mode — approve before coding.

/normalApprove each action.

/yoloNo approvals.

/modeCycle plan → normal → yolo.

/diffShow uncommitted git changes.

/undoRevert the last file changes.

/rewindUndo the last n turns (files + chat).

/compactShrink the conversation context.

/memoryShow the team's saved lessons.

/rememberSave a lesson for future runs.

/resumeResume a past session.

/usagePlan limits + usage.

/costSession size + plan usage.

/exportWrite a markdown transcript of this session.

/configOpen the configuration UI.

/clearStart a fresh conversation.

/exitQuit.

The team

Depaza is not one model — it is a small team, each running the EU-hosted tier that suits their job. Call them by name in a session, or with the matching slash command.

Teammate	Role	Best for
📋 Emma	Product Manager	Clarifies the goal and writes the numbered plan — never codes.
🐥 Bob	Junior Developer	Eager, fast first-pass implementation.
🦾 Max	Senior Engineer	Architecture, refactors and the hard calls.
🔎 Anna	QA & Testing	Adversarial tests, edge cases, GDPR — read-only guardian.

Run depaza team to see which model each teammate is on. depaza models shows the orchestrator / coder / verifier strategy and how to override any role.

Approval modes & permissions

Every file edit and command asks for approval — with a diff or command preview — unless you opt out. Three modes, switched live with Shift+Tab or the slash commands:

Mode	Behaviour
plan	Propose a numbered plan and wait for approval before making changes.
normal	Approve each action (edit / command) individually. The default.
yolo	Auto-approve everything for the rest of the session.

Start a run unattended with --yolo (or per-command --auto / -y), or pre-plan with --plan. At any approval prompt you can type yolo to switch for the rest of the session.

Permission rules give fine-grained control. A rule is a tool name with an optional glob — edit_file, run_bash(git *), write_file(/etc/*), mcp__*. Deny always wins.

depaza --allow

Auto-allow a rule (repeatable). · e.g. depaza --allow 'run_bash(git *)' chat

depaza --deny

Deny a rule (repeatable). · e.g. depaza --deny 'run_bash(rm *)' chat

depaza permissions

Show the rules currently in effect.

Add --sandbox to confine run_bash (no network; writes limited to the project) where the OS supports it. The agent's tools span read-only (read_file, list_dir, glob, grep, web_search), mutating (write_file, edit_file, run_bash) and remote ops (ssh_run, scp_upload / scp_download, rsync_sync) via your ~/.ssh/config host aliases.

Configuration

Settings live in ~/.config/depaza/config.toml (mode 0600). Edit it with the interactive UI — depaza config — or by hand. Environment variables override the file, which is useful in CI.

config.toml sections

Section	Keys
[auth]	api_key, base_url (default https://depaza.com/v1)
[preferences]	default_model (lite \| core \| max, default core)
[permissions]	auto_approve, sandbox
[roles]	orchestrator_model, coder_model, verifier_model
[local]	mini_enabled, model_path, model_url (opt-in on-device model)
[sync]	enabled (upload sessions to the EU dashboard)

Environment variables

Variable	Purpose
DEPAZA_API_KEY	Your dpz_live_… key.
DEPAZA_BASE_URL	Override the API endpoint (self-hosting).
DEPAZA_AUTO_APPROVE	Set to 1 to auto-approve edits and commands.
DEPAZA_SANDBOX	Set to 1 to confine run_bash.
DEPAZA_DEBUG	Set to 1 to log raw API traffic to ~/.config/depaza/debug.log.
DEPAZA_LOCAL_MINI	Set to 1 to enable the on-device mini model.
DEPAZA_ORCHESTRATOR_MODEL / _CODER_MODEL / _VERIFIER_MODEL	Override the model tier for a role.

Depaza uses open-source LLMs. You can run the CLI with your own local open models (Ollama, vLLM, or Depaza's local-optimized ones) or our EU-hosted versions. The agent team and orchestration are the same. See active tiers with depaza models. Pass --no-orchestrator to use a single model.

Custom commands & MCP

Custom slash commands. Drop a markdown file in ~/.config/depaza/commands/<name>.md (user-level) or ./.depaza/commands/<name>.md (project-level, wins on conflict) to add your own /<name>. Optional YAML front-matter sets a description:; the body is the prompt, with $ARGUMENTS replaced by whatever you type after the command.

# ~/.config/depaza/commands/ship.md

$ ---

$ description: Run tests, then open a PR

$ ---

$ Run the test suite. If green, open a PR with depaza pr. $ARGUMENTS

MCP servers. Connect external tools over the Model Context Protocol. Configure servers in ~/.config/depaza/mcp.json or ./.depaza/mcp.json, then list them with depaza mcp list. MCP tools appear to the agent as mcp__<server>__<tool> and obey the same permission rules.

Project conventions. A DEPAZA.md (it also reads AGENTS.md / CLAUDE.md) in your repo root is loaded into every session. Generate one with depaza init.

Sessions, undo & headless

Sessions are saved automatically. Resume the most recent one in this directory, or pick from the last ten:

depaza --continue

Resume the most recent session in this directory. · e.g. depaza -c

depaza --resume

Resume a session by id (from depaza sessions or the dashboard). · e.g. depaza --resume <id>

depaza resume

Pick one of your last 10 sessions and continue it.

depaza sessions

List or clear saved conversations. · e.g. depaza sessions --clear

depaza undo

Revert the last set of file changes Depaza made.

Inside a session, /rewind undoes the last few turns (files and chat together) and /undo reverts the most recent edits.

Isolated & headless. Use --worktree to run in a throwaway git worktree and review/merge on exit. For scripts and CI, run headless:

depaza --print

Run one prompt, print the result, and exit. · e.g. depaza -p "summarise the diff" --output-format json

Headless output formats are text (default), json and stream-json. Mutating tools stay denied headless unless you pass an --allow rule or --yolo. Add --transcript <path> to write a full markdown reasoning/tool trace.

Troubleshooting & getting help

Something off? Run with --debug (or set DEPAZA_DEBUG=1) to log raw API requests and responses to ~/.config/depaza/debug.log.

depaza whoami

Confirm you are connected and on the right plan.

depaza update

Make sure you are on the latest version.

depaza welcome

Re-show the welcome / what-makes-Depaza-different screen.

Tab-completion not working? Run depaza --install-completion and restart your shell. Local config lives under ~/.config/depaza/ — remove config.toml to start clean, then run depaza auth again.

Operators have a server-gated depaza admin command group (stats, users, plans, costs and search administration). It is restricted to the super-admin allowlist and is out of scope for this manual.

Need a hand? Run depaza help for branded examples, or reach us via the CLI overview and your dashboard.

Get started

Put the whole team to work today

Emma, Bob, Max and Anna are ready in your terminal — EU First, EU-hosted and GDPR-ready. Pick a plan and connect in under a minute.

See plans & pricing Create your account

Paid plans (Pro+) get instant Code CLI access — just run depaza auth. Free accounts may receive a redeem code.

This manual mirrors depaza --help. The CLI and all of its models run inside the EU.