ZERO

ZeroThink CLI

Terminal Nodeaka Agent Zero

ZeroThink in the terminal, built for people who may know nothing yet. Install it, then either link the same account you use on the website or stay completely outside Google by saving a local Groq or NVIDIA key on your machine. The first plain zerothink launch now offers a real guided setup, then you choose whether it can touch just one repo or your whole machine and ask Agent Zero to read files, edit files, create folders, scaffold projects, zip folders, inspect code, run shell commands, work against saved SSH targets, read and write remote files on servers, keep a local plan board, save checkpoints, resume sessions later, search the web locally, open a result, attach that page into a live prompt, load custom local command packs, drive Playwright/MCP tools, and launch self-driven agent runs with named workers like zero1, zero2, and zero3. Plain-English build and fix requests in the interactive prompt now route into the real tool stack instead of just describing commands, and you can switch between /steer auto, /steer plan, and /steer confirm when you want Agent Zero to stage big tasks before it runs them. The CLI now runs in clean operator mode by default, so the full ZeroThink reasoning trace stays on the website and does not clutter terminal sessions.

Account + Direct Mode Repo-safe folder mode SSH + remote files Zip + archive workflows Autopilot + subagents repo guidance context URL fetch Local web search Playwright MCP Custom commands Local plan board Built-in help topics

No Guesswork

The fast path is simple: install, run zerothink or zerothink tutorial, then either link your account or set a local Groq/NVIDIA key, pick folder mode if you only want one repo, and then start with a plain-English prompt. For action requests like creating a project, fixing a config, or scaffolding files, Agent Zero now executes through the real CLI tool stack by default. The reasoning layer is stronger now too: it works in a private orient → inspect → plan → act → verify → report loop instead of drifting into generic assistant chatter. The CLI includes its own guide, examples, command map, local checkpoints, project context support, and an explicit autopilot layer for multi-step work inside the terminal.

Best beginner flow: install the CLI, run zerothink for the first-run guide, then either zerothink login or zerothink key set groq, then zerothink access folder ., then optionally add a repo guidance file like ZEROTHINK.md, CLAUDE.md, AGENTS.md, or .claude/CLAUDE.md so the CLI keeps project-specific rules in mind automatically. After that, you can type normal requests like make a new project folder for shafaet.com and Agent Zero will execute the work instead of only suggesting commands. If you want a safer review step first, switch to /steer plan, let the CLI stage the task, then use /go to execute or /stop to discard it. When you want it to self-drive a bounded task more explicitly, use zerothink autopilot "map this repo and tell me what to fix first". The terminal path is intentionally cleaner than Studio: no automatic Zero trace dump in normal replies.

What First Run Looks Like

███████╗███████╗██████╗ ██████╗ ╚══███╔╝██╔════╝██╔══██╗██╔═══██╗ ███╔╝ █████╗ ██████╔╝██║ ██║ ███╔╝ ██╔══╝ ██╔══██╗██║ ██║ ███████╗███████╗██║ ██║╚██████╔╝ ╚══════╝╚══════╝╚═╝ ╚═╝ ╚═════╝ ZERO THINK CLI // AGENT ZERO // TERMINAL NODE New here? Type /about, /tutorial, /guide, or /help quickstart. Need examples? Type /help examples. ZERO> /about ZERO> /capabilities ZERO> /help quickstart ZERO> /key status ZERO> /context show ZERO> /attach-url https://example.com ZERO> /search-web nginx php-fpm tuning ZERO> /page 1 ZERO> /attach-page 1 ZERO> /runtime ZERO> /provider groq ZERO> /model openai/gpt-oss-120b ZERO> /plan add map the repo and auth flow ZERO> /autopilot map this repo and list the highest-risk auth bugs ZERO> /checkpoint repo-audit ZERO> review this repo and tell me what to fix first

Identity

Who It Is

The CLI now answers as ZeroThink CLI aka Agent Zero, not as a generic AI assistant. If someone asks who it is or what it can do, it answers from the local terminal runtime and current route instead of letting the model improvise.

zerothink about zerothink capabilities /about /capabilities
What Route It Is Using

When people want to know whether they are on Groq, NVIDIA, linked-account mode, or direct-key mode, use the runtime commands instead of asking the model to guess.

zerothink runtime zerothink status /runtime /status

Install

Windows PowerShell

Installs the Python client, creates launchers, adds the user bin path if needed, and then prints the beginner quickstart commands.

irm https://zerothink.talktoai.org/cli-assets/install.ps1 | iex
Linux / macOS

Downloads the CLI into ~/.zerothink, creates a launcher in ~/.local/bin, and prints the same beginner next steps.

curl -fsSL https://zerothink.talktoai.org/cli-assets/install.sh | bash
Read Help First

If you know nothing yet, start the guided setup before trying random commands or switching providers.

zerothink zerothink tutorial zerothink help quickstart zerothink help sessions zerothink help fetch zerothink help custom zerothink context show zerothink help examples zerothink --help
Two ways in: linked-account mode uses the same ZeroThink account and Vault keys as the website, while direct-key mode lets you stay outside Google by storing a local Groq or NVIDIA key on the machine itself or auto-detecting GROQ_API_KEY / NVIDIA_API_KEY from your shell.

Update Existing Installs

Best Update Command

If ZeroThink CLI is already installed, this is the command to tell people to run. It downloads the latest published CLI, verifies the SHA-256 hash, then replaces the local script safely.

zerothink update
After Updating

Close the old terminal session and reopen it so the new script is actually loaded into memory.

zerothink update exit zerothink
Check The Live Route

If anyone is confused about whether they are on Groq, NVIDIA, linked-account mode, or local direct-key mode, use the built-in runtime inspector instead of asking the model to guess.

zerothink runtime zerothink status /runtime

Five-Minute Quickstart

1

Install It

Run one install command for your machine.

irm https://zerothink.talktoai.org/cli-assets/install.ps1 | iex
2

Run The Guided Setup

The CLI explains itself now instead of assuming you know the flow already.

zerothink or zerothink tutorial
3

Choose A Login Lane

Either link the normal ZeroThink account or set a local Groq/NVIDIA key for no-Google direct mode.

zerothink login or zerothink key set groq
4

Choose A Safe Mode

Folder mode is best if you only want one repo available.

zerothink access folder .
5

Open The Prompt

Then ask for help in plain English.

zerothink /guide review this codebase and explain what it does
6

Stage Big Tasks First

If you do not want Agent Zero to run immediately, switch steering mode and stage the task before you approve it.

/steer plan make a new project folder for shafaet.com /go /stop

No-Google Direct Mode

What It Does

If you do not want to link a Google account, the CLI can still run with a local Groq or NVIDIA key. The key stays in ~/.zerothink/config.json on that machine, not in the ZeroThink Vault. If your shell already has GROQ_API_KEY or NVIDIA_API_KEY, the CLI can auto-detect that too.

Best Commands
zerothink key set groq zerothink key status zerothink status zerothink runtime zerothink config provider groq zerothink
Important Limits

Direct mode is intentionally lean: no account memory, no saved ZeroThink history, no ZeroThink Vault key import, no linked-account session, and no Pro-only account features. Local CLI browser tools like zerothink search, zerothink browse, /search-web, and /page still work, but they are local terminal research helpers, not website account memory or account web-search state.

Your First Session

If You Just Want Repo Help

Use folder mode, then ask normal questions like you would in chat.

cd your-project zerothink access folder . zerothink /guide scan this repo and tell me the most important files first
If You Want Coding Models

Pick Groq for the fastest practical coding default with openai/gpt-oss-120b, or switch to NVIDIA for the heavier coding lane like Qwen 480B Coder. You can also ask Agent Zero for the curated coding shortlist directly.

/models coding /provider groq /model openai/gpt-oss-120b /provider nvidia /model qwen/qwen3-coder-480b-a35b-instruct read src/main.py and propose a safer refactor
If You Have Big Files

Attach a file or zip instead of pasting a giant wall of code into the terminal. If the repo contains a guidance file like ZEROTHINK.md, CLAUDE.md, AGENTS.md, or .claude/CLAUDE.md, the CLI also folds that guidance into local prompts automatically.

zerothink zip create audit.zip src package.json zerothink chat --file audit.zip "review this project"

Help Inside The CLI

Built-In Topics

The CLI now ships with a real first-run guide plus beginner help topics so people do not have to memorize the command tree first.

zerothink about zerothink capabilities zerothink tutorial zerothink help quickstart zerothink help sessions zerothink context show zerothink help access zerothink help files zerothink help remote zerothink help examples
Inside The REPL

Once you are inside the live prompt, the same guidance is available as slash commands, and unique short prefixes like /he can resolve to the right command. Steering and stop controls are built in now too.

/about /capabilities /tutorial /guide /help /steer plan /go /stop /runtime /context /plan /checkpoint first-pass /attach-url https://example.com /custom show /help commands /help examples /tips
If You Are Stuck

The safest recovery pattern is to check identity, access, provider, and direct-key readiness before assuming the model is broken.

zerothink me zerothink status zerothink runtime zerothink key status zerothink access status zerothink doctor
Help TopicWhat It ExplainsCommand
QuickstartInstall, login, access mode, first prompt, and the safest beginner path.zerothink help quickstart
AccessThe difference between folder mode and machine mode.zerothink help access
FilesWorkspace reads, searches, writes, and zip/archive workflows.zerothink help files
SessionsLocal checkpointing, resume, export, and history workflows.zerothink help sessions
PlanA local task board inside the REPL for open vs done work.zerothink help plan
ContextHow repo-level ZEROTHINK.md, CLAUDE.md, and AGENTS.md files steer the CLI locally.zerothink help context
FetchHow local URL fetching and URL attachments work.zerothink help fetch
BrowserHow local web search, page open, page attach, and browser session state work.zerothink help browser
CustomHow local JSON command packs extend the CLI.zerothink help custom
RemoteSaved SSH targets, remote execution, SCP, and remote file read/write/replace workflows.zerothink help remote
ModelsWhen to use Groq, NVIDIA, Gemini, OpenAI, or xAI, plus which providers support no-Google direct mode.zerothink help models
ExamplesReal prompts and operator workflows for repo work, audits, and remote ops.zerothink help examples

Browser Research Lane

Search The Web Locally

Run a live web search from the terminal, keep the numbered results in the current session, and reopen them later without leaving the CLI flow.

zerothink search "nginx php-fpm tuning" /search-web latest ollama gemma docs /pages
Open A Result And Read It

Open a saved result into the local browser state and preview the cleaned page text right inside the terminal.

/page 1 /browse https://nginx.org/en/docs/ zerothink browse https://example.com
Attach A Page To The Prompt

Once a page matters, attach it into the current session so the next prompt can reason over that page alongside files and repo context.

/attach-page 1 /files /clear-pages
Important: this is a local CLI browser lane. It is useful for docs, changelogs, incident notes, and research, but it is not pretending to be a full graphical browser.

Extension Layers

URL Fetch + Browser Attach

You can fetch a live URL locally, search for a result, open a page into the browser state, and attach that page to the current session as prompt context.

zerothink fetch https://example.com zerothink search "nginx hardening" zerothink chat --url https://example.com "summarize this" /search-web ollama gemma docs /page 1 /attach-page 1 /attach-url https://example.com /detach-url all
Playwright MCP Browser

For dynamic pages or real browser automation, ZeroThink CLI can register the official Playwright MCP server locally and drive it through a first-class wrapper instead of raw tool names. The built-in profile now uses headless isolated mode so separate runs do not fight over the same browser profile.

zerothink mcp add-playwright zerothink mcp tools playwright zerothink playwright open https://example.com zerothink playwright call browser_snapshot /playwright open https://example.com /playwright tools
Custom Command Packs

Drop a ZEROTHINK.commands.json file into a repo to add reusable prompt commands or machine-mode shell commands without editing the CLI itself.

zerothink custom zerothink custom show /custom show
Local Plan Board

Keep a clean step list inside the live session, checkpoint it with the rest of the conversation, and reopen the exact same working state later.

/plan add audit auth flow /plan /plan done 1 /plan clear
Findings-First Review Lane

There is now a dedicated review wrapper for code-review style output instead of relying only on free-form prompting.

zerothink review src/app.py /review src/app.py security only

Agent Autopilot

Autopilot Runs

Use autopilot when you want the CLI to drive a multi-step task by itself instead of stopping after one reply. The controller chooses one next action at a time, saves state locally, and can finish with a proper summary.

zerothink autopilot "audit this repo and tell me what to fix first" zerothink autopilot "inspect the nginx config and summarize the risks" --steps 8
Named Workers

Create named workers like zero1 and rerun them later. This is useful when you want a durable saved task with logs rather than a one-shot run.

zerothink agent create zero1 "map the repo and find auth risks" zerothink agent run zero1 --steps 8 zerothink agent show zero1 zerothink agent log zero1
Subagents

The controller can spawn child workers like zero2 and zero3 for side tasks when that helps the main job. Those child runs are logged back into the parent agent state.

zerothink autopilot "review this app, inspect the billing code, and split side tasks when useful" /agent list /agent log zero2
Tool Surface

Agent mode can inspect local files, run shell commands, read and edit remote files on saved server profiles, search the web, and now call Playwright/MCP tools directly when machine mode allows it.

zerothink mcp add-playwright zerothink autopilot "open the docs site with Playwright, inspect the page, and summarize the important controls" zerothink remote read prod /etc/nginx/nginx.conf
Good default: use folder mode for repo work and switch to machine mode only when you want shell, SSH, remote files, or Playwright/MCP automation available to the agent.

Access Modes

ModeWhat It AllowsBest UseCommand
Folder OnlyReads, writes, scans, search, zips, attachments, and project work only inside one chosen workspace root.Beginners, coding sessions, contractor use, or any time you want repo help without exposing the whole machine.zerothink access folder .
MachineFull local shell execution, wider filesystem access, SSH commands, SCP transfers, and remote file read/write/replace workflows.Senior operator work, machine admin tasks, server work, and broad local automation.zerothink access machine
Workspace RootStores the repo root used by folder mode so you can move between codebases more cleanly.Switching projects without re-linking your account or changing machine policy.zerothink workspace C:\path\to\repo

Files, Uploads, And Zip Workflows

Read And Search

Read a file, search for symbols or TODOs, or scan a whole project tree before you ask for a refactor.

zerothink fs scan . zerothink fs read src/app.ts --start 1 --lines 120 zerothink fs search "TODO|FIXME|hack" .
Write And Replace

Create files, append notes, or do basic replacements without leaving the terminal.

zerothink fs write notes.txt --text "audit summary" zerothink fs append notes.txt --text "next step" zerothink fs replace config.yml "debug: true" "debug: false"
Attach Zips Instead Of Pasting

Package a repo slice into a zip and attach that to a prompt when the project is too big to paste manually.

zerothink zip create review-pack.zip src package.json README.md zerothink chat --file review-pack.zip "explain this codebase and find risks"

Saved Server Profiles

Store A Target Once

Save the host, user, port, and working directory so you do not have to retype them for every session. You can also use a saved password or an environment variable for password-based SSH when keys are not available.

zerothink server add prod 81.168.83.48 --user root --port 1024 --cwd /home/talkto zerothink server add prod 81.168.83.48 --user root --port 1024 --ask-pass zerothink server list
Run Remote Commands

Useful for status checks, logs, permissions, and quick repair work. Machine mode only.

zerothink ssh prod "pwd && ls -la" zerothink ssh prod "systemctl status nginx"
Push And Pull Files

Move zips, logs, build artifacts, or backups between your local machine and a saved target.

zerothink scp put prod build.zip /home/talkto/build.zip zerothink scp get prod /home/talkto/error.log ./error.log
Edit Remote Files

The CLI can now inspect and change text files on a saved server profile directly, which makes it much closer to a real operator tool instead of a chat wrapper.

zerothink remote read prod /etc/nginx/nginx.conf --lines 40 zerothink remote write prod /tmp/test.txt --text "hello" zerothink remote replace prod /etc/nginx/nginx.conf old new

Model Routing

ProviderDefaultNotable ModelsBest Use
Groqopenai/gpt-oss-120bGPT-OSS 120B, Llama 3.3 70B, Kimi K2, Compound, GPT-OSS 20B, Qwen 3 32BFastest practical coding lane, strong reasoning, and the default CLI coding route.
NVIDIAqwen/qwen3-coder-480b-a35b-instructQwen 480B Coder, GPT-OSS 120B, Qwen 2.5 Coder 32B, Gemma 4 31B, Codestral, Llama 3.3 70BHeavy coding, architecture work, bigger code generation, and deeper technical drafting.
Geminigemini-2.5-proGemini 2.5 Pro, Flash, Flash-Lite, Gemini 3 previewsLong-context analysis, large documents, and multimodal work.
OpenAIgpt-5.4GPT-5.4, GPT-5 Mini, GPT-5.1Premium reasoning and writing through the same linked ZeroThink account.
xAIgrok-4-latestGrok 4, Grok 4 Fast, Grok Code Fast 1Premium Grok reasoning and coding when that lane suits the task better.
NVIDIA note: if you want models like qwen/qwen3-coder-480b-a35b-instruct, you can either save your NVIDIA key in the ZeroThink Vault through linked-account mode or use no-Google direct mode with zerothink key set nvidia.

Core Commands

Identity + Startup
zerothink --help zerothink tutorial zerothink help quickstart zerothink help browser zerothink login zerothink status zerothink key status zerothink key set groq zerothink me zerothink doctor
Access + Workspace
zerothink access status zerothink access folder . zerothink access machine zerothink workspace . zerothink workspace C:\code\project
Files + Search
zerothink fs ls . zerothink fs tree . --depth 3 zerothink fs scan . zerothink fs read src/app.ts --start 1 --lines 80 zerothink fs search "auth|token|session" .
Write + Archive
zerothink fs write notes.txt --text "hello" zerothink fs append notes.txt --text "more" zerothink zip create release.zip src public zerothink zip extract release.zip ./unpacked
Autopilot + Agents
zerothink help agents zerothink autopilot "review this repo and summarize the top fixes" zerothink agent create zero1 "map the auth flow" zerothink agent run zero1 --steps 8 zerothink agent log zero1
Local Session Memory
zerothink session list zerothink session show repo-audit zerothink session export repo-audit /checkpoint repo-audit /resume repo-audit
URL + Custom
zerothink fetch https://example.com zerothink search "php-fpm tuning" zerothink browse https://nginx.org/en/docs/ zerothink playwright open https://example.com zerothink custom show /attach-url https://example.com /custom show
Remote
zerothink server add prod HOST --user root --port 1024 --ask-pass zerothink server list zerothink ssh prod "uptime" zerothink remote read prod /etc/nginx/nginx.conf zerothink scp get prod /var/log/messages ./messages.log
Inside The REPL
/guide /help commands /he<TAB> /search-web gemma ollama docs /page 1 /attach-page 1 /playwright open https://example.com /context show /checkpoint repo-audit /provider nvidia /model qwen/qwen3-coder-480b-a35b-instruct /attach review-pack.zip

Beginner Troubleshooting

Command Not Found

Open a new terminal window first. On Linux or macOS make sure ~/.local/bin is on your PATH. On Windows, reopen PowerShell after install. If interactive completion feels missing, run zerothink update or reinstall so prompt_toolkit gets installed too.

Not Logged In

Run zerothink login. If you are unsure whether the machine is linked, run zerothink me. Slash commands like /help only work inside the interactive ZERO> prompt, not in plain PowerShell.

Provider Feels Missing

Make sure the relevant provider key exists in the right place. Linked-account mode uses the ZeroThink Vault. Direct mode uses zerothink key status and only supports Groq or NVIDIA local keys. If the linked Groq or NVIDIA lane fails but you already have a local key saved, the CLI now falls back automatically for those providers.

Too Much Access

Switch back to repo-safe mode with zerothink access folder . and reopen the CLI inside the project you actually want to work on. If you want project-specific guidance without pasting it each time, add a repo guidance file such as ZEROTHINK.md, CLAUDE.md, or AGENTS.md and inspect it with zerothink context show.

Agent Seems Stuck

Check the saved worker state with zerothink agent show zero1 and zerothink agent log zero1. If the task needs more room, rerun it with a higher step limit using zerothink agent run zero1 --steps 12 or start a fresh controller with zerothink autopilot "...".

ZERO THINK CLI aka AGENT ZERO // v3.4.0 // AUTOPILOT TERMINAL NODE
© 2026 Shaf Brady / TalkToAi