Zero：可控的本地终端编程智能体

The coding agent that answers to you, your model, your machine, your rules.

A terminal coding agent you own. English | 中文 Zero is an AI coding agent for your local terminal. It can inspect a repository, edit files, run commands, use browser/terminal helpers, and keep durable local sessions while you choose the model and the permission level. zero zero exec "fix the failing test in ./pkg" zero exec --output-format stream-json < turns.jsonl Partners Twigpine Xiaomi MiMo Novita AI Concentrate Exa GMI Cloud Vercel Why Zero Use the model you want. Bring OpenAI, Anthropic, Gemini, Groq, OpenRouter, DeepSeek, Mistral, xAI, Qwen, Kimi, GitHub Models, Ollama, LM Studio, Atomic Chat, or any OpenAI-/Anthropic-compatible endpoint. Stay in control. File writes, shell commands, network access, and out-of-workspace writes go through Zero's permission and sandbox policy. Works in the terminal. The TUI has model/provider pickers, image input, slash commands, live plan/tool rendering, scrollback, themes, and resume/fork support. Works without the TUI. zero exec is scriptable, supports text/JSON/ stream-JSON I/O, isolated worktrees, spec-first runs, and meaningful exit codes for CI. Keeps context local. Sessions are stored on disk, searchable, resumable, and never uploaded as telemetry by Zero. Extensible when you need it. Use MCP servers, skills, plugins, hooks, and specialist subagents from the same CLI. Install npm npm install -g @twigpine/zero zero The npm package is a small wrapper whose platform build (Linux and macOS on x64/arm64, Windows on x64 — including the browser/terminal control helpers) installs as an optional dependency straight from the npm registry — no install scripts, no downloads outside npm. Bun, pnpm, and yarn work the same way with no trust or approval steps. Installs that skip optional dependencies (--omit=optional) still work: the wrapper fetches the binary from the matching GitHub Release whenever it is missing. Windows on ARM runs the x64 build under emulation. See docs/NPM_PACKAGING.md for how the package is put together. Installed Zero as @gitlawb/zero? The package moved to @twigpine/zero in 0.10.0 and the old name gets no further releases. Both packages provide the zero command, so quit any running zero, then remove the old package first: npm uninstall -g @gitlawb/zero npm install -g @twigpine/zero Your config, sessions, and logins are kept; they live outside the package. For Bun, pnpm, and yarn, see docs/INSTALL.md. Install scripts Linux/macOS: curl -fsSL https://raw.githubusercontent.com/Twigpine/zero/main/scripts/install.sh | bash Windows PowerShell: irm https://raw.githubusercontent.com/Twigpine/zero/main/scripts/install.ps1 | iex From source Source builds require Go 1.26.10+. git clone https://github.com/Twigpine/zero.git cd zero go run ./cmd/zero Release installers and the npm wrapper require published GitHub Release assets. If you are testing before the first public release, build from source: go build -o zero ./cmd/zero On Linux, native sandboxing needs Bubblewrap. The main zero binary re-executes itself as the helper when zero-linux-sandbox is absent. A separate helper next to zero or on PATH still takes precedence: go build -o zero-linux-sandbox ./cmd/zero-linux-sandbox # optional go build -o zero-seccomp ./cmd/zero-seccomp # optional compatibility wrapper Put zero on PATH (~/.local/bin is a good default). macOS does not need an extra helper binary. Windows source builds can use the main zero.exe as their sandbox helper; release archives still ship standalone Windows helper executables. More install details: docs/INSTALL.md. First Run Start the TUI: zero The setup wizard helps you pick a provider and model. You can also configure providers from the command line: zero setup zero providers list zero models list zero doctor For API providers, set the matching environment variable before setup or enter the key in the wizard: export OPENAI_API_KEY=sk-... export ANTHROPIC_API_KEY=... export GEMINI_API_KEY=... export AIMLAPI_API_KEY=... export LONGCAT_API_KEY=... export FIREWORKS_API_KEY=... export GMI_API_KEY=... export CONCENTRATE_API_KEY=... export MINIMAX_API_KEY=... export MINIMAXI_API_KEY=... To configure AI/ML API directly, run: zero providers setup aimlapi --set-active To configure Meituan LongCat (LongCat-2.0) directly, run: zero providers setup longcat --set-active To configure Fireworks AI directly, run: zero providers setup fireworks --set-active To configure GMI Cloud directly, run: zero providers setup gmicloud --set-active To configure Concentrate directly, run: zero providers setup concentrate --set-active MiniMax presets use the Anthropic-compatible endpoints for the global and China regions: zero providers add minimax --set-active zero providers add minimaxi-cn --set-active To use the OpenAI-compatible endpoints instead, add a custom compatible profile for the required region: zero providers add custom-openai-compatible \ --name minimax-openai \ --model MiniMax-M3 \ --base-url https://api.minimax.io/v1 \ --api-key-env MINIMAX_API_KEY \ --set-active zero providers add custom-openai-compatible \ --name minimax-cn-openai \ --model MiniMax-M3 \ --base-url https://api.minimaxi.com/v1 \ --api-key-env MINIMAXI_API_KEY \ --set-active For local models, run Ollama, LM Studio, or the Atomic Chat desktop app, then use zero setup or zero providers detect. For Atomic Chat, load a model and enable its local OpenAI-compatible API (default http://127.0.0.1:1337/v1). Choose atomic-chat-local; detection includes the loaded model ID in the add command. If no usable ID is discovered, load a model and retry. Model IDs requiring shell-specific quoting use interactive setup. Daily Use Interactive TUI zero Useful controls: Control Action Enter send the prompt / open slash-command suggestions Ctrl+X then letter common slash commands (e.g. m → /model; Ctrl+X ? for full list) Ctrl+P / Ctrl+N previous / next item in menus (arrows still work) Shift+Tab cycle permission mode Ctrl+B show/hide the sidebar Ctrl+C cancel, exit, or return from a /btw conversation C