Use
Threads
Run a job in the browser app, from the terminal or headless.
A thread is a conversation with the agent. You describe a job in plain words, and the agent plans it, reads files, runs commands and records findings. Threads are saved, so you can resume or archive them.
Start the app
Section titled “Start the app”00 starts the browser app on this computer and opens it. No account is needed. It binds to 127.0.0.1:48123.
| Flag | Default | Effect |
|---|---|---|
--port <port> |
48123 |
Port to bind. 0 picks a free loopback port. |
--host <host> |
127.0.0.1 |
Loopback address to bind. |
--no-open |
Start without opening a browser. | |
--db-path <path> |
local store | SQLite database for findings and runs. |
--ready-json |
Print the bound URL as JSON, for scripts. |
Run 0 --help for the full list.
Run a thread
Section titled “Run a thread”- Press New thread.
- Pick a folder if the job involves code.
- Choose a model under the composer. If the list is empty, connect a provider first. See Models.
- Describe the job, for example “Review this repo for auth bypasses and verify anything you find”.
- Watch tool activity in the transcript. Findings land in Findings.
The sidebar holds New thread and your history, Findings, Skills, Computers, Extensions and your Sentinels. Press ? outside a text field for the keyboard shortcuts.
In the composer you can attach images or text files, set a thinking effort for models that support it, and type slash commands.
A message you send while the agent works is queued and goes out when the response ends. Send now interrupts instead. Stop response stops the agent. If a model connection drops, the thread reconnects and continues from its last completed tool result.
Slash commands
Section titled “Slash commands”Type / for a menu. Each entry mirrors a CLI command, and anything that changes or deletes asks first.
| Slash command | CLI |
|---|---|
/threads start, /threads list, /threads export |
0 threads start, 0 threads list, 0 threads list <id> --export |
/findings list, /fix [finding-id] |
0 findings list, 0 threads start |
/scan <folder> |
0 scan <folder>; in chat it scans in this thread instead of a new one |
/sentinels list, /sentinels create |
0 sentinels list, 0 sentinels set --create |
/computers list, /models list, /skills list |
the same words after 0 |
/config get, /doctor |
0 config get, 0 config doctor |
Chat-only commands are /help, /status, /tools, /explain [topic], /feedback <message>, /shortcuts and /usage.
Approvals and instructions
Section titled “Approvals and instructions”A thread has shell access and runs commands as your user in the folder you chose. An optional sandbox limits it. One global setting, Ask before running commands under Settings → Helpers, puts each command or change to you first. It is off by default. See Configuration.
The agent has a web_search tool. It uses Parallel’s anonymous hosted search, with DuckDuckGo as a fallback, and needs no key. Results are links and snippets, not proof that a page was read in full. Set ZERO_FEATURE_WEB_SEARCH=0 to turn it off by default.
0 never loads AGENTS.md or CLAUDE.md files from inside a target repository, because whoever wrote the target controls that text. Put your own instructions under Settings → Instructions: a global ~/.0/AGENTS.md and one file per folder, each up to 32,000 characters.
Saved threads
Section titled “Saved threads”A saved thread opens read-only at /chats/saved/<id>, with its transcript and panels. It resumes when you send a message.
Search with ⌘K. It matches message text and titles, and skips tool payloads and private reasoning.
Settings → Threads sets title instructions, idle archiving (off, 7, 14, 30 or 90 days) and the helper limits:
- concurrent helpers: 1-128, default 32
- nesting depth: 1-16, default 8
- helpers per call: 1-4096, default 1024
Control threads from the terminal
Section titled “Control threads from the terminal”0 threads works on the app that 0 started:
id=$(0 threads start "Map the login flow" --folder ~/code/app)0 threads list "$id" --set --effort high0 threads stop "$id"0 threads send "$id" --retry0 threads list "$id" --rename "Login flow"0 threads list "$id" --export --format md -o login-flow.md0 threads list "$id" --delete --yesthreads start creates the thread, runs one turn and prints the thread ID. Add --force to stop if owned execution does not drain.
Add --wait to block until the turn ends. It prints only the reply on stdout and the thread ID, tokens and cost on stderr. It exits 1 if the turn errored. threads send <id> ... --wait and threads show <id> --wait work the same way on an existing thread.
Every 0 threads command needs a running app. Without one it prints No console running. Start one with: 0 --headless and exits non-zero.
Run a prompt headless
Section titled “Run a prompt headless”0 -p runs one prompt through the same app process and exits.
0 -p "Review the selected folder"0 -p "Summarize the open findings" --format jsonprintf '%s' 'Summarize the selected findings' | 0 -p| Option | Effect |
|---|---|
--format <text|json|ndjson> |
Output format. Default text. |
-m, --model <id> |
Model to use. |
--approvals <ask|auto> |
With ask, each command is put to you first. A headless run cannot answer, so effectful tools are refused. Default auto, or your approvals setting. |
--finding <id>, --finding-intent <intent> |
Focus on one saved finding: investigate, verify, draft_fix or impact. |
--resume <id>, --continue |
Continue a saved thread by ID or prefix, or the most recent one (0 -r <id>, 0 -c). |
A task that needs a human decision cannot finish headless. Open it in the browser. To continue a live thread, pass --chat <id>. The thread keeps its own model, so --model is rejected, and pending decisions are reported, not approved.
On a server or in CI, start the app without a browser:
0 --headless --ready-jsonThis serves the API only. To drive a running app from scripts, use 0 api. It calls the backend HTTP API with the normal authentication and approval checks. Keep the token in an environment variable, for example --engine-token-env ZERO_AGENT_TOKEN, never on the command line.
Commands, skills and Sentinels
Section titled “Commands, skills and Sentinels”- The CLI commands (
findings,threads,sentinels,skills,models,computers,config) are built into 0. They are not skills. The/commands in a thread are a shorter list that mirrors them, and a few exist only in chat. - A skill is know-how a thread loads when a task needs it: a
SKILL.mdfolder, which extensions can also supply. See Skills. - A Sentinel is a standing thread that wakes on a schedule or a pull request. See Sentinels.
- A skill can declare a check that the engine runs itself, so a thread cannot claim Verified without it. See Findings.
Limits
Section titled “Limits”- Tools run on the host of the computer you use. Your model endpoint can still be remote.
- A provider connection does not authorize a target.
- A source build serves the app from built assets. Rebuild after you change source.