[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-94885":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":9,"totalLinesOfCode":9,"stars":12,"forks":13,"watchers":14,"openIssues":14,"contributorsCount":9,"subscribersCount":14,"size":14,"stars1d":14,"stars7d":14,"stars30d":14,"stars90d":14,"forks30d":14,"starsTrendScore":14,"compositeScore":15,"rankGlobal":9,"rankLanguage":9,"license":9,"archived":16,"fork":16,"defaultBranch":17,"hasWiki":16,"hasPages":16,"topics":9,"createdAt":9,"pushedAt":9,"updatedAt":18,"readmeContent":19,"aiSummary":20,"trendingCount":14,"starSnapshotCount":14,"syncStatus":21,"lastSyncTime":9,"discoverSource":22},94885,"zero","Gitlawb\u002Fzero","Gitlawb","The coding agent that answers to you, your model, your machine, your rules.",null,"https:\u002F\u002Fgithub.com\u002FGitlawb\u002Fzero","Go",1448,155,0,51.58,false,"main","2026-08-24 04:01:22","\u003Cp align=\"center\">\n  \u003Cimg src=\"docs\u002Fassets\u002Fzero-logo.png\" alt=\"Zero\" width=\"385\">\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\u003Cstrong>A terminal coding agent you own.\u003C\u002Fstrong>\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"LICENSE\">\u003Cimg alt=\"license\" src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-MIT-blue\">\u003C\u002Fa>\n  \u003Cimg alt=\"Go 1.26.5+\" src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FGo-1.26.5+-00ADD8?logo=go&logoColor=white\">\n  \u003Cimg alt=\"25+ providers\" src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fproviders-25+-34E2EA\">\n  \u003Ca href=\"https:\u002F\u002Fdiscord.gg\u002FCaQDS6wdFn\">\u003Cimg alt=\"Discord\" src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDiscord-join-5865F2?logo=discord&logoColor=white\">\u003C\u002Fa>\n  \u003Cbr>\n  \u003Cstrong>English\u003C\u002Fstrong> | \u003Ca href=\"README_ZH.md\">中文\u003C\u002Fa>\n\u003C\u002Fp>\n\nZero is an AI coding agent for your local terminal. It can inspect a repository,\nedit files, run commands, use browser\u002Fterminal helpers, and keep durable local\nsessions while you choose the model and the permission level.\n\n```bash\nzero\nzero exec \"fix the failing test in .\u002Fpkg\"\nzero exec --output-format stream-json \u003C turns.jsonl\n```\n\n## Why Zero\n\n- **Use the model you want.** Bring OpenAI, Anthropic, Gemini, Groq, OpenRouter,\n  DeepSeek, Mistral, xAI, Qwen, Kimi, GitHub Models, Ollama, LM Studio, or any\n  OpenAI-\u002FAnthropic-compatible endpoint.\n- **Stay in control.** File writes, shell commands, network access, and\n  out-of-workspace writes go through Zero's permission and sandbox policy.\n- **Works in the terminal.** The TUI has model\u002Fprovider pickers, image input,\n  slash commands, live plan\u002Ftool rendering, scrollback, themes, and resume\u002Ffork\n  support.\n- **Works without the TUI.** `zero exec` is scriptable, supports text\u002FJSON\u002F\n  stream-JSON I\u002FO, isolated worktrees, spec-first runs, and meaningful exit\n  codes for CI.\n- **Keeps context local.** Sessions are stored on disk, searchable, resumable,\n  and never uploaded as telemetry by Zero.\n- **Extensible when you need it.** Use MCP servers, skills, plugins, hooks, and\n  specialist subagents from the same CLI.\n\n## Install\n\n### npm\n\n```bash\nnpm install -g @gitlawb\u002Fzero\nzero\n```\n\nThe npm package is a small wrapper whose platform build (Linux and macOS on\nx64\u002Farm64, Windows on x64 — including the browser\u002Fterminal control helpers)\ninstalls as an optional dependency straight from the npm registry — no install\nscripts, no downloads outside npm. Bun, pnpm, and yarn work the same way with\nno trust or approval steps. Installs that skip optional dependencies\n(`--omit=optional`) still work: the wrapper fetches the binary from the\nmatching GitHub Release whenever it is missing. Windows on ARM runs the x64\nbuild under emulation. See [docs\u002FNPM_PACKAGING.md](docs\u002FNPM_PACKAGING.md) for\nhow the package is put together.\n\n### Install scripts\n\nLinux\u002FmacOS:\n\n```bash\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FGitlawb\u002Fzero\u002Fmain\u002Fscripts\u002Finstall.sh | bash\n```\n\nWindows PowerShell:\n\n```powershell\nirm https:\u002F\u002Fraw.githubusercontent.com\u002FGitlawb\u002Fzero\u002Fmain\u002Fscripts\u002Finstall.ps1 | iex\n```\n\n### From source\n\nSource builds require Go 1.26.5+.\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002FGitlawb\u002Fzero.git\ncd zero\ngo run .\u002Fcmd\u002Fzero\n```\n\nRelease installers and the npm wrapper require published GitHub Release assets.\nIf you are testing before the first public release, build from source:\n\n```bash\ngo build -o zero .\u002Fcmd\u002Fzero\n```\n\nOn Linux, build the sandbox helper too if you want native sandboxing:\n\n```bash\ngo build -o zero-linux-sandbox .\u002Fcmd\u002Fzero-linux-sandbox\ngo build -o zero-seccomp .\u002Fcmd\u002Fzero-seccomp   # optional compatibility wrapper\n```\n\nPut `zero` and `zero-linux-sandbox` in the same directory on `PATH`\n(`~\u002F.local\u002Fbin` is a good default). macOS does not need an extra helper binary.\nWindows source builds can use the main `zero.exe` as their sandbox helper; release\narchives still ship standalone Windows helper executables.\n\nMore install details: [docs\u002FINSTALL.md](docs\u002FINSTALL.md).\n\n## First Run\n\nStart the TUI:\n\n```bash\nzero\n```\n\nThe setup wizard helps you pick a provider and model. You can also configure\nproviders from the command line:\n\n```bash\nzero setup\nzero providers list\nzero models list\nzero doctor\n```\n\nFor API providers, set the matching environment variable before setup or enter\nthe key in the wizard:\n\n```bash\nexport OPENAI_API_KEY=sk-...\nexport ANTHROPIC_API_KEY=...\nexport GEMINI_API_KEY=...\nexport AIMLAPI_API_KEY=...\nexport LONGCAT_API_KEY=...\nexport FIREWORKS_API_KEY=...\nexport MINIMAX_API_KEY=...\nexport MINIMAXI_API_KEY=...\n```\n\nTo configure AI\u002FML API directly, run:\n\n```bash\nzero providers setup aimlapi --set-active\n```\n\nTo configure Meituan LongCat (LongCat-2.0) directly, run:\n\n```bash\nzero providers setup longcat --set-active\n```\n\nTo configure Fireworks AI directly, run:\n\n```bash\nzero providers setup fireworks --set-active\n```\n\nMiniMax presets use the Anthropic-compatible endpoints for the global and China\nregions:\n\n```bash\nzero providers add minimax --set-active\nzero providers add minimaxi-cn --set-active\n```\n\nTo use the OpenAI-compatible endpoints instead, add a custom compatible profile\nfor the required region:\n\n```bash\nzero providers add custom-openai-compatible \\\n  --name minimax-openai \\\n  --model MiniMax-M3 \\\n  --base-url https:\u002F\u002Fapi.minimax.io\u002Fv1 \\\n  --api-key-env MINIMAX_API_KEY \\\n  --set-active\n\nzero providers add custom-openai-compatible \\\n  --name minimax-cn-openai \\\n  --model MiniMax-M3 \\\n  --base-url https:\u002F\u002Fapi.minimaxi.com\u002Fv1 \\\n  --api-key-env MINIMAXI_API_KEY \\\n  --set-active\n```\n\nFor local models, run Ollama or LM Studio and then use `zero setup` or\n`zero providers detect`.\n\n## Daily Use\n\n### Interactive TUI\n\n```bash\nzero\n```\n\nUseful controls:\n\n| Control | Action |\n|---|---|\n| `Enter` | send the prompt |\n| `\u002F` | open slash-command suggestions |\n| `Ctrl+X` then letter | common slash commands (e.g. `m` → `\u002Fmodel`; `Ctrl+X` `?` for full list) |\n| `Ctrl+P` \u002F `Ctrl+N` | previous \u002F next item in menus (arrows still work) |\n| `Shift+Tab` | cycle permission mode |\n| `Ctrl+B` | show\u002Fhide the sidebar |\n| `Ctrl+C` | cancel, exit, or return from a `\u002Fbtw` conversation |\n\nCommon slash commands:\n\n| Command | Purpose |\n|---|---|\n| `\u002Fmodel`, `\u002Fprovider` | switch the active model\u002Fprovider |\n| `\u002Fspec`, `\u002Fplan` | draft and review a plan before building |\n| `\u002Fimage` | attach an image for vision-capable models |\n| `\u002Fresume`, `\u002Frewind` | continue or roll back local sessions |\n| `\u002Fnew` | start a fresh session in place (previous session stays on disk) |\n| `\u002Fbtw [question]` | ask in an isolated fork without adding the side conversation to the main session |\n| `\u002Floop` | repeat a prompt or custom `\u002Fcommand` on an interval (`\u002Floop 5m \u002Fbabysit-prs`) or self-paced |\n| `\u002Fcompact`, `\u002Fcontext` | manage context usage |\n| `\u002Fpermissions`, `\u002Ftools` | inspect available tools and policy |\n| `\u002Fadd-dir` | allow an extra write directory for this session |\n| `\u002Ftheme`, `\u002Fdoctor`, `\u002Fconfig` | adjust appearance and inspect setup |\n\n### Headless `exec`\n\n```bash\nzero exec \"explain internal\u002Fagent\u002Floop.go\"\nzero exec --model claude-sonnet-4.5 \"refactor the config loader\"\nzero exec --use-spec \"add rate limiting to the API client\"\nzero exec --worktree \"try the migration in an isolated worktree\"\nzero exec --resume\nzero exec --fork \u003Csession-id> \"try the other approach\"\n```\n\nProgrammatic use:\n\n```bash\nzero exec --input-format stream-json --output-format stream-json \u003C turns.jsonl\n```\n\nThe stream-JSON contract is documented in\n[docs\u002FSTREAM_JSON_PROTOCOL.md](docs\u002FSTREAM_JSON_PROTOCOL.md).\n\n## Safety Model\n\nZero is designed to make side effects visible.\n\n- Workspace reads are allowed by default.\n- File writes are limited to the workspace unless you grant another directory.\n- Shell commands, network access, destructive commands, and elevated actions are\n  permission-gated.\n- `--add-dir \u003Cpath>` and `\u002Fadd-dir \u003Cpath>` grant additional write roots without\n  giving the agent the whole filesystem.\n- Unsafe\u002Fautonomous modes are explicit opt-ins.\n- Secrets are redacted from tool output and logs where Zero controls the surface.\n\nExample:\n\n```bash\nzero --add-dir ..\u002Fdocs-site\nzero exec --add-dir ..\u002Fshared \"update both repos\"\n```\n\nSandbox behavior can be inspected with:\n\n```bash\nzero sandbox policy\nzero sandbox grants list\n```\n\n## Web And Local Control\n\nZero includes local file\u002Fsearch\u002Fedit\u002Fshell tools, `web_fetch` for public URLs,\nand MCP support for additional tools.\n\nFor local dev servers, use shell commands such as `curl` through `exec_command`\nso the normal sandbox and permission policy applies. Long-running commands stay\nattached to a background terminal session and can be listed or stopped from the\nTUI.\n\nThe npm package also includes browser and terminal helper packages used by local\nbrowser\u002Fterminal tools. Source builds can use the same helpers when they are on\n`PATH` or configured in Zero's local-control settings.\n\n## Common Commands\n\n```text\nzero                  interactive TUI\nzero exec             one-shot or scripted agent run\nzero setup            first-run provider setup\nzero auth             OAuth\u002Flogin helpers for supported providers\nzero models           model registry and capabilities\nzero providers        provider profiles and detection\nzero doctor           setup, key, and connectivity checks\nzero context          context-budget report\nzero repo-map         deterministic repository map\nzero repo-info        local repository summary\nzero search | find    search local session history\nzero sessions         inspect, resume, fork, and rewind sessions\nzero spec             manage spec-mode drafts\nzero specialist       manage specialist subagents\nzero skills           manage markdown instruction skills\nzero plugins          manage plugins\nzero hooks            manage lifecycle hooks\nzero mcp              manage MCP servers and tools\nzero serve --mcp      expose Zero tools over MCP stdio\nzero sandbox          inspect sandbox policy and grants\nzero worktrees        prepare isolated git worktrees\nzero verify           detect and run local verification checks\nzero changes          inspect and commit local git changes\nzero usage            token usage and estimated cost\nzero cron             scheduled agent jobs\nzero update --check   check for newer releases\nzero upgrade          download, verify, and install the latest release\n```\n\n## Extending Zero\n\n### Project and personal instructions\n\nZero appends project-specific guidance to the system prompt from the first\n`AGENTS.md`, `ZERO.md`, or `.zero\u002FAGENTS.md` file found in each directory from\nthe git root down to your current working directory (checked in that order\nper directory). Files are injected general-to-specific, capped at 8 KiB per\nfile and 32 KiB total.\n\nA personal `ZERO.md` under `config.UserConfigDir()\u002Fzero\u002FZERO.md`\n(`$XDG_CONFIG_HOME\u002Fzero\u002FZERO.md` or `~\u002F.config\u002Fzero\u002FZERO.md` on Linux\u002FmacOS,\n`%AppData%\\Roaming\\zero\\ZERO.md` on Windows) applies across every workspace, ahead of any project guidelines.\n\n### Plugins\n\nPlugins are discovered from `~\u002F.config\u002Fzero\u002Fplugins\u002F\u003Cname>\u002Fplugin.json` (user\nscope — `$XDG_CONFIG_HOME` or `~\u002F.config` on every OS, independent of the\n`config.UserConfigDir()` path used above) and `\u003Ccwd>\u002F.zero\u002Fplugins\u002F\u003Cname>\u002Fplugin.json`\n(project scope — resolved from the current working directory, not the repo\nroot), and managed with `zero plugins`. A manifest can declare:\n\n- `tools` — custom tools (`command`, `args`, `inputSchema`, and a\n  `permission` of `prompt` or `deny`; `allow` is honored only when manifest tool\n  auto-approval is enabled)\n- `hooks` — commands run on `beforeTool`, `afterTool`, `sessionStart`, or\n  `sessionEnd`\n- `prompts` and `skills` — additional prompt\u002Fskill files\n\nMCP servers (`zero mcp`) and standalone markdown skills (`zero skills`) use\nthe same extension points and can also be wired up outside of a plugin\nmanifest.\n\n## Appearance And Accessibility\n\n| Control | Effect |\n|---|---|\n| `NO_COLOR=\u003Canything>` | disables color output |\n| `ZERO_THEME=\u003Cname>` | selects the startup theme (`auto`, `dark`, `light`, or a color theme like `dracula`, `nord`, `gruvbox`, `tokyo-night`, `catppuccin`, `one-dark`, `solarized-dark`, `rose-pine`, `everforest`, `neon`, `solarized-light`, `dune`) |\n| `--theme \u003Cname>` | selects the TUI theme from the CLI (same names) |\n| `\u002Ftheme` | opens the theme picker inside the TUI (live preview; `\u002Ftheme \u003Cname>` switches directly) |\n| `ZERO_NO_FADE=1` | disables streaming fade animation |\n\nMeaning does not rely on color alone; diffs, permissions, and statuses also use\ntext or glyph markers.\n\n## Development\n\n```bash\ngo test .\u002F...\ngo run .\u002Fcmd\u002Fzero-release build\ngo run .\u002Fcmd\u002Fzero-release smoke\ngo run .\u002Fcmd\u002Fzero-perf-bench\n```\n\nExperimental: `ZERO_OPENAI_TURN_SESSION=1` enables the optimized OpenAI turn\nsession (background connection prewarm + request-prefix telemetry) for headless\n`zero exec` runs against official OpenAI profiles. Off by default; `0`\u002F`false`\ndisable. A\u002FB-benchmark it by running the same `zero-perf-bench` suite with the\nvariable unset and set.\n\n### Code Quality and Security Checks\n\nBefore committing any changes, ensure all Go code quality and security checks pass. The `make` targets below pin each tool to this module's Go version, so they load correctly even when your default `go` toolchain is older — running the plain `go run ...@version` form yourself can select the tool module's own (older) toolchain and fail to load this module instead.\n\n1. **Formatting**: Run `make fmt` (or `go fmt .\u002F...`).\n2. **Vetting**: Run `make vet` (or `go vet .\u002F...`).\n3. **Linting**: Run `make lint-static`.\n4. **Vulnerability Scan**: Run `make vulncheck`.\n\nUse the repository-managed targets rather than globally installed binaries:\nthe targets apply the module's required Go toolchain as well as the reviewed,\npinned tool versions.\n\nThe installed binaries land in `$GOBIN` when it is set, otherwise in\n`$GOPATH\u002Fbin` (default `~\u002Fgo\u002Fbin`). That directory must be on your `PATH` to\nrun them directly. If it isn't, add it:\n\n```bash\ngobin=\"$(go env GOBIN)\"; [ -z \"$gobin\" ] && gobin=\"$(go env GOPATH)\u002Fbin\"\ncase \":$PATH:\" in *\":$gobin:\"*) ;; *) export PATH=\"$PATH:$gobin\" ;; esac\n```\n\n### Cross-Compile Examples\n\n```bash\ngo run .\u002Fcmd\u002Fzero-release build --goos linux --goarch amd64\ngo run .\u002Fcmd\u002Fzero-release build --goos windows --goarch amd64 --output dist\u002Fzero.exe\n```\n\n## Documentation\n\n- [Install](docs\u002FINSTALL.md)\n- [Update flow](docs\u002FUPDATE.md)\n- [Themes](docs\u002FTHEMES.md)\n- [Stream-JSON protocol](docs\u002FSTREAM_JSON_PROTOCOL.md)\n- [Specialists](docs\u002FSPECIALISTS.md)\n- [GitHub Action](docs\u002FGITHUB_ACTION.md)\n- [Benchmarks](docs\u002FBENCHMARK.md)\n- [Performance](docs\u002FPERFORMANCE.md)\n- [Agent evals](docs\u002FAGENT_EVALS.md)\n\n## Community\n\nReal-time chat happens on the [Discord server](https:\u002F\u002Fdiscord.gg\u002FCaQDS6wdFn).\n\nQuestions, setup help, ideas, and sharing all live in\n[GitHub Discussions](https:\u002F\u002Fgithub.com\u002FGitlawb\u002Fzero\u002Fdiscussions):\n\n| Category | Use it for |\n|---|---|\n| [Q&A](https:\u002F\u002Fgithub.com\u002FGitlawb\u002Fzero\u002Fdiscussions\u002Fcategories\u002Fq-a) | Setup help, provider\u002Fmodel configuration, \"how do I\" questions |\n| [Ideas](https:\u002F\u002Fgithub.com\u002FGitlawb\u002Fzero\u002Fdiscussions\u002Fcategories\u002Fideas) | Feature proposals and design discussion before any PR |\n| [Show and tell](https:\u002F\u002Fgithub.com\u002FGitlawb\u002Fzero\u002Fdiscussions\u002Fcategories\u002Fshow-and-tell) | Your skills, plugins, MCP setups, themes, and workflows |\n| [Announcements](https:\u002F\u002Fgithub.com\u002FGitlawb\u002Fzero\u002Fdiscussions\u002Fcategories\u002Fannouncements) | Releases and project news from the maintainers |\n\nFor a good Q&A answer fast, include `zero --version`, your OS and install\nmethod, the provider\u002Fmodel in use, and `zero doctor` output. See\n[SUPPORT.md](SUPPORT.md). Bugs belong in\n[issues](https:\u002F\u002Fgithub.com\u002FGitlawb\u002Fzero\u002Fissues\u002Fnew\u002Fchoose); security reports\nfollow [SECURITY.md](SECURITY.md), never a public thread.\n\n## Contributing\n\nContributions are welcome. Read [CONTRIBUTING.md](CONTRIBUTING.md), run the\nrelevant tests, and open a focused pull request.\n\nSecurity reports should follow [SECURITY.md](SECURITY.md).\n\n## License\n\nZero is released under the [MIT License](LICENSE).\n","Zero 是一个运行在本地终端的可自主控制的 AI 编程智能体，专为开发者在本地代码仓库中执行分析、编辑、测试与调试任务而设计。它支持 25+ 大模型提供商（如 OpenAI、Ollama、Qwen、Kimi 等），具备细粒度权限管控、本地持久化会话、TUI 交互界面及脚本化 CLI（zero exec）双模式；所有上下文与操作均保留在用户机器上，不上传任何数据。适用于本地开发提效、CI\u002FCD 自动修复、私有代码库辅助编程等需隐私保障与模型自主权的场景。",2,"trending"]