CLI reference
Zuno is a single executable. Every capability the harness exposes, from a one-shot prompt to durable session inspection, is reachable through a subcommand of zuno. Running zuno with no subcommand starts the interactive terminal application, so zuno and zuno tui are equivalent.
This reference is generated against the shipped binary. Each page reproduces the options that command actually accepts, with the defaults the binary reports. Options that carry no default in --help are documented without one.
zuno --help
zuno <command> --help2
A small set of options is accepted by every subcommand. They are documented once, in Global options, rather than being explained again on each page.
One invocation, one process
A client that launches Zuno — an editor over zuno acp, a service supervising zuno serve, a script, a CI job — gets one process per invocation on every supported platform. The process it spawned is the process that runs the command, ending that process ends the command, and the command's stdout and stderr reach end of file when it does.
Startup resolves global options and ZUNO_* variables into a single value the command reads directly, so no invocation depends on writing them back into the environment. On Unix the executable additionally replaces its own image once at startup, keeping the same process id, so programs it later launches inherit the resolved values from the operating system. Windows has no equivalent replacement, so there the resolved values stay inside the Zuno process: --sandbox, --sandbox-on-unavailable, --log-level, and --print-logs govern the invocation exactly as documented, but a program Zuno starts does not read them from its own environment, and a nested zuno on Windows resolves confinement from configuration rather than from the outer command line.
Running Zuno
| Command | Purpose |
|---|---|
zuno run | Run a message through the harness non-interactively, with optional JSON output. |
zuno tui | Start the interactive terminal application. Also the default with no command. |
zuno serve | Start the headless server for external clients. |
zuno acp | Serve Agent Client Protocol over stdin and stdout for editor integration. |
Managing state
| Command | Purpose |
|---|---|
zuno session | List, prune, delete, and inspect guarded recovery of durable sessions. |
zuno agent | List the agents the current configuration chain resolves. |
zuno db | Run a query against the local session database. |
zuno export | Write configuration, Skills, extensions, and Agents into a portable bundle. |
zuno import | Restore a portable bundle into this machine's user environment. |
Providers and extensions
| Command | Purpose |
|---|---|
zuno models | List the models reachable through the configured providers. |
zuno providers | Inspect providers and manage their stored credentials. |
zuno mcp | Register, authenticate, and debug Model Context Protocol servers. |
zuno plugin | Install, replace, remove, and inspect extension packages. |
Maintenance
| Command | Purpose |
|---|---|
zuno self-update | Replace the running executable from a checksum-verified GitHub release. |
zuno debug | Inspect paths, resolved configuration, prompts, permissions, sandbox, and snapshots. |
zuno completion | Generate or install completion for bash, elvish, fish, powershell, or zsh. |
Excluded
| Command | Purpose |
|---|---|
| Excluded commands | console, web, stats, github, pr, uninstall, and generate are registered only to explain what replaces them. |