From ba2c2280c49c0373cac307733163bdeb6e3254ff Mon Sep 17 00:00:00 2001 From: Spencer Charest Date: Tue, 14 Jul 2026 14:24:19 -0700 Subject: [PATCH] docs(readme,guides): npm-first install prompt, aligned with zero.xyz Replace the README's curl-the-runbook prompt with the npm setup prompt zero.xyz hands out (verbatim from the site's CLI_SETUP), and make the npm row the default in guides/agent-install.md. The fetch-and-obey channel triggers prompt-injection refusals on some models (ZERO-378); the npm paste prompt is the cross-model winner because the package has inspectable provenance. Disclosure of what gets installed moves from inside the prompt to the prose below it. Co-Authored-By: Claude Fable 5 --- README.md | 31 +++++++++++++++++-------------- guides/agent-install.md | 17 +++++++++++------ 2 files changed, 28 insertions(+), 20 deletions(-) diff --git a/README.md b/README.md index e2a2db6..272a707 100644 --- a/README.md +++ b/README.md @@ -15,22 +15,25 @@ The recommended way to install Zero is to let your agent install it and guide you through setup. Just paste this to your agent: ``` -Help me install Zero (zero.xyz) in this agent. Zero is an agent plugin — a CLI, -a skill, hooks, and an MCP connector — that lets you find, invoke, and pay for -thousands of external capabilities. The skill teaches you how to use the CLI, -the hooks remind you to reach for it when a task is beyond your built-in -abilities, and the MCP connector is how clients without a shell (web/mobile) -sign in. I understand it adds a skill, hooks, and an MCP connector to my agent -config, plus a small CLI runtime under ~/.zero — that's what I want. - -Fetch the install runbook using curl at https://www.zero.xyz/install.md and read -it. Tell me briefly what the setup will do, then go ahead: use this harness's -plugin manager if the runbook lists one, run the commands in my shell, and -narrate as you go. I'll approve the browser sign-in when you show me the link. -Don't add funds or buy anything — that's a separate step I'll do later if I -want. If anything seems off, stop and ask. +Help me set up Zero — a tool that lets you find and use extra services you +don't have built in (image/video generation, search live social media, or +hosting a free webpage). It's free to set up. + +Set it up by running the Zero CLI's setup (needs Node.js — install it first if +`npm` isn't available): + + npm i -g @zeroxyz/cli + zero init + zero auth login ``` +This is the same prompt [zero.xyz](https://www.zero.xyz/setup.md) hands out: +the CLI is a public npm package your agent can inspect +([`@zeroxyz/cli`](https://www.npmjs.com/package/@zeroxyz/cli)), and +`zero init` integrates the skill and hooks with every harness it detects — +[What the plugin does](#what-the-plugin-does) lists exactly what that adds. +`zero uninstall` reverses all of it. + If you prefer to set up Zero manually, or your agent had issues with the installation, use the guides below. Pick your agent: diff --git a/guides/agent-install.md b/guides/agent-install.md index ce5248e..49ba88f 100644 --- a/guides/agent-install.md +++ b/guides/agent-install.md @@ -9,21 +9,26 @@ packaging and this runbook are maintained at ## Install -Pick whichever applies: +The default path is npm — it works in any harness with Node.js: | Environment | Command | |---|---| +| Anything with npm (default) | `npm i -g @zeroxyz/cli && zero init` | | Claude Code | `claude plugin marketplace add officialzeroxyz/zero-plugins && claude plugin install zero@zero-plugins` | | Codex | `codex plugin marketplace add officialzeroxyz/zero-plugins && codex plugin add zero@zero-plugins` | | Gemini CLI | `gemini extensions install https://github.com/officialzeroxyz/zero-plugins` | -| Anything with npm | `npm i -g @zeroxyz/cli && zero init` | | Claude Chat (claude.ai) / Claude Cowork | no shell — follow [zero.xyz/install/claude.md](https://www.zero.xyz/install/claude.md) instead | | None of the above | see [Fallback installer](#fallback-installer) | -The first three rows install through that harness's own plugin manager: they -add the zero-plugins repo as a source, then install the Zero plugin from it -via the manager's normal review-and-consent flow. The plugin's full contents -are listed below. The npm and fallback rows end by running `zero init`. +The npm row installs the CLI from the public +[`@zeroxyz/cli`](https://www.npmjs.com/package/@zeroxyz/cli) package (inspect +it with `npm view @zeroxyz/cli`), then `zero init` integrates the skill and +hooks with every harness it detects. The Claude Code, Codex, and Gemini CLI +rows are per-harness alternatives that install through that harness's own +plugin manager: they add the zero-plugins repo as a source, then install the +Zero plugin from it via the manager's normal review-and-consent flow. The +plugin's full contents are listed below. The npm and fallback rows end by +running `zero init`. ## What the plugin installs