zo — Zettabyte Oracle

A fast, permission-conscious CLI for OpenRouter models

Ask a question, inspect a project, edit selected files, run approved commands, search the web, or generate an image—all from the terminal. zo enables each capability explicitly, so a simple prompt stays simple.

Basic Usage

zo How do I unpack a tar file into a directory

Demo

Everything at a glance

Fast terminal interaction

Responses stream progressively with Markdown and syntax-highlighted code.
Redirected output is plain text, making zo safe to compose with other commands.
Piped STDIN, prompt text, and explicit file references can be combined in one request.

CLI usage →

Models that fit the task

Select built-in aliases, use fuzzy names, or pass a full provider/model ID.
Control reasoning effort globally, per custom model, or for one invocation.
Define custom assistants with reusable system prompts.

Models and customization →

Files with explicit boundaries

@file includes content, !file grants write-only access, and @!file grants read/write access.
--files read adds project discovery and search tools; --files write adds workspace editing.
Existing-file changes show a focused diff and ask for approval by default.

Files and workspace tools →

Live tools when you request them

--shell lets the model run commands under an approval policy.
--web adds OpenRouter server-side web search to text and chat requests.
--verbose exposes compact tool calls; --debug previews a request and asks before sending it.

Shell tools and policies →

Sessions, automation, and media

Chat mode supports multiline editing, file completion, retained context, and bounded retries.
--non-interactive, --accept-writes, --hidden, and byte limits make automation behavior explicit.
Image mode generates a single image directly to a workspace file.

Chat mode → · Image generation → · Configuration →

Get started

cargo install zo-cli
export OPENROUTER_API_KEY='sk-or-v1-...'
zo 'What is Rust?'

Installation → · Quick start → · Examples →