CLI Reference

Synopsis

dev [OPTIONS] [PROMPT]
dev <SUBCOMMAND> [OPTIONS]

Hanzo Dev is an AI-powered coding assistant that runs in your terminal. When invoked without a subcommand, it launches the interactive TUI.

Option	Short	Description
`--model <MODEL>`	`-m`	Model the agent should use
`--profile <PROFILE>`	`-p`	Configuration profile from config.toml
`--sandbox <MODE>`	`-s`	Sandbox policy for shell commands
`--ask-for-approval <POLICY>`	`-a`	When to require human approval
`--cd <DIR>`	`-C`	Working directory for the agent
`--image <FILE>`	`-i`	Attach image(s) to initial prompt
`--oss`		Use local open source model provider (Ollama)
`--full-auto`		Enable low-friction sandboxed automatic execution
`--dangerously-bypass-approvals-and-sandbox`		Skip all safety checks (DANGEROUS)
`--auto`		Run Auto Drive for non-interactive sessions
`--debug`	`-d`	Enable debug logging of LLM requests
`-c <KEY=VALUE>`		Override configuration values
`--version`		Print version information
`--help`	`-h`	Print help information

Run non-interactively for a single task. Alias: e

dev exec [OPTIONS] [PROMPT]

Option	Description
`--auto`	Run Auto Drive instead of single turn
`--json`	Print events to stdout as JSONL
`--max-seconds <N>`	Maximum wall-clock time budget
`--turn-cap <N>`	Maximum Auto Drive coordinator turns
`--output-last-message <FILE>`	Write final message to file
`--output-schema <FILE>`	JSON Schema for structured output
`--skip-git-repo-check`	Allow running outside Git repos

Run Auto Drive headless. Alias for exec --auto --full-auto.

dev auto [OPTIONS] [PROMPT]

Resume a previous interactive session.

dev resume [SESSION_ID] [OPTIONS]

Option	Description
`--last`	Continue the most recent session

Manage authentication credentials.

dev login [--with-api-key]
dev login status
dev logout

Apply the latest diff produced by the agent. Alias: a

dev apply

Manage MCP servers. Alias: acp

dev mcp list [--json]
dev mcp get <NAME> [--json]
dev mcp add <NAME> [OPTIONS] [-- COMMAND...]
dev mcp remove <NAME>

Manage browser integration.

dev bridge subscription [OPTIONS]
dev bridge list
dev bridge tail [OPTIONS]
dev bridge screenshot [OPTIONS]
dev bridge javascript <CODE> [OPTIONS]

Browse and manage Cloud tasks. Alias: cloud-tasks

dev cloud submit <PROMPT> [OPTIONS]

Side-channel LLM utilities.

dev llm request [OPTIONS]

Generate shell completion scripts.

dev completion bash
dev completion zsh
dev completion fish
dev completion powershell

Diagnose PATH, binary collisions, and version conflicts.

dev doctor

Internal debugging commands (macOS: seatbelt, Linux: landlock).

dev debug seatbelt [COMMAND...]
dev debug landlock [COMMAND...]

Variable	Description
`OPENAI_API_KEY`	OpenAI API key
`CODE_HOME`	Override config directory (default: `~/.hanzo`)
`CODEX_HOME`	Legacy config directory (fallback)
`CODEX_SECURE_MODE`	Enable security hardening when set to `"1"`