ZeroThink CLI
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.
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.
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
Identity
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
/capabilitiesWhen 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
/statusInstall
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 | iexDownloads 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 | bashIf 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 --helpGROQ_API_KEY / NVIDIA_API_KEY from your shell.Update Existing Installs
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 updateClose the old terminal session and reopen it so the new script is actually loaded into memory.
zerothink update
exit
zerothinkIf 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
/runtimeFive-Minute Quickstart
Install It
Run one install command for your machine.
irm https://zerothink.talktoai.org/cli-assets/install.ps1 | iexRun The Guided Setup
The CLI explains itself now instead of assuming you know the flow already.
zerothink
or
zerothink tutorialChoose 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 groqChoose A Safe Mode
Folder mode is best if you only want one repo available.
zerothink access folder .Open The Prompt
Then ask for help in plain English.
zerothink
/guide
review this codebase and explain what it doesStage 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
/stopNo-Google Direct Mode
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.
zerothink key set groq
zerothink key status
zerothink status
zerothink runtime
zerothink config provider groq
zerothinkDirect 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
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 firstPick 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 refactorAttach 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
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 examplesOnce 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
/tipsThe 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 Topic | What It Explains | Command |
|---|---|---|
| Quickstart | Install, login, access mode, first prompt, and the safest beginner path. | zerothink help quickstart |
| Access | The difference between folder mode and machine mode. | zerothink help access |
| Files | Workspace reads, searches, writes, and zip/archive workflows. | zerothink help files |
| Sessions | Local checkpointing, resume, export, and history workflows. | zerothink help sessions |
| Plan | A local task board inside the REPL for open vs done work. | zerothink help plan |
| Context | How repo-level ZEROTHINK.md, CLAUDE.md, and AGENTS.md files steer the CLI locally. | zerothink help context |
| Fetch | How local URL fetching and URL attachments work. | zerothink help fetch |
| Browser | How local web search, page open, page attach, and browser session state work. | zerothink help browser |
| Custom | How local JSON command packs extend the CLI. | zerothink help custom |
| Remote | Saved SSH targets, remote execution, SCP, and remote file read/write/replace workflows. | zerothink help remote |
| Models | When to use Groq, NVIDIA, Gemini, OpenAI, or xAI, plus which providers support no-Google direct mode. | zerothink help models |
| Examples | Real prompts and operator workflows for repo work, audits, and remote ops. | zerothink help examples |
Browser Research Lane
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
/pagesOpen 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.comOnce 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-pagesExtension Layers
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 allFor 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 toolsDrop 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 showKeep 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 clearThere 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 onlyAgent Autopilot
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 8Create 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 zero1The 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 zero2Agent 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.conffolder 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
| Mode | What It Allows | Best Use | Command |
|---|---|---|---|
| Folder Only | Reads, 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 . |
| Machine | Full 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 Root | Stores 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 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" .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"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
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 listUseful for status checks, logs, permissions, and quick repair work. Machine mode only.
zerothink ssh prod "pwd && ls -la"
zerothink ssh prod "systemctl status nginx"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.logThe 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 newModel Routing
| Provider | Default | Notable Models | Best Use |
|---|---|---|---|
| Groq | openai/gpt-oss-120b | GPT-OSS 120B, Llama 3.3 70B, Kimi K2, Compound, GPT-OSS 20B, Qwen 3 32B | Fastest practical coding lane, strong reasoning, and the default CLI coding route. |
| NVIDIA | qwen/qwen3-coder-480b-a35b-instruct | Qwen 480B Coder, GPT-OSS 120B, Qwen 2.5 Coder 32B, Gemma 4 31B, Codestral, Llama 3.3 70B | Heavy coding, architecture work, bigger code generation, and deeper technical drafting. |
| Gemini | gemini-2.5-pro | Gemini 2.5 Pro, Flash, Flash-Lite, Gemini 3 previews | Long-context analysis, large documents, and multimodal work. |
| OpenAI | gpt-5.4 | GPT-5.4, GPT-5 Mini, GPT-5.1 | Premium reasoning and writing through the same linked ZeroThink account. |
| xAI | grok-4-latest | Grok 4, Grok 4 Fast, Grok Code Fast 1 | Premium Grok reasoning and coding when that lane suits the task better. |
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
zerothink --help
zerothink tutorial
zerothink help quickstart
zerothink help browser
zerothink login
zerothink status
zerothink key status
zerothink key set groq
zerothink me
zerothink doctorzerothink access status
zerothink access folder .
zerothink access machine
zerothink workspace .
zerothink workspace C:\code\projectzerothink 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" .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 ./unpackedzerothink 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 zero1zerothink session list
zerothink session show repo-audit
zerothink session export repo-audit
/checkpoint repo-audit
/resume repo-auditzerothink 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 showzerothink 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/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.zipBeginner Troubleshooting
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.
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.
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.
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.
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 "...".
© 2026 Shaf Brady / TalkToAi