From 5d2a9be6db464f7fbdc4833551c4b1f025c2c5de Mon Sep 17 00:00:00 2001 From: Spencer Charest Date: Sun, 14 Jun 2026 17:18:45 -0700 Subject: [PATCH 1/2] docs(guides): make standalone installer guide more user-friendly Rework guides/generic.md to match the consumer-facing shape of the other per-host guides: a short intro, a one-command Install section, and concise "Staying up to date" / "Uninstalling" sections. Drop the technical "What gets installed where" details (skill/hook paths, config/runtime locations, MCP) in favor of a single pointer to agent-install.md. Trim the README's standalone entry down to just the link and tagline, matching every other agent in the Install Zero list, so the linked guide is the single source of those details. Co-Authored-By: Claude Opus 4.8 (1M context) --- README.md | 12 +-------- guides/generic.md | 63 +++++++++++++++-------------------------------- 2 files changed, 21 insertions(+), 54 deletions(-) diff --git a/README.md b/README.md index 3c553b6..ce4d9fb 100644 --- a/README.md +++ b/README.md @@ -30,17 +30,7 @@ installation, use the guides below. Pick your agent: - **[Droid](guides/droid.md)** - **[Gemini CLI](guides/gemini-cli.md)** - **[Anything else (standalone installer)](guides/generic.md)** — works in any - agent with a shell (and for humans at a terminal): - - ```bash - curl -fsSL https://zero.xyz/install.sh | bash - ``` - - It provisions the same runner the plugins use, puts `zero` on PATH, and - installs the Zero skill where most harnesses look (`~/.claude/skills/` and - `~/.agents/skills/`). The whole install is reversible with `zero uninstall`. - See the [standalone install guide](guides/generic.md) for what gets installed - where, the `--skills-dir` flag for bespoke skill directories, and updates. + agent with a shell (and for humans at a terminal) Once installed, ask your agent to *"help me set up and test Zero"* — it signs you in and takes it from there. diff --git a/guides/generic.md b/guides/generic.md index 3a0b5f2..5eb3fb2 100644 --- a/guides/generic.md +++ b/guides/generic.md @@ -1,67 +1,44 @@ # Zero for any agent (standalone installer) How to install Zero in any agent or harness with a shell — and for humans at a -terminal — using the standalone installer, then keep it up to date. +terminal — then keep it up to date. -Use this when there's no dedicated plugin for your harness (Claude Code, Codex, -Droid, and Gemini CLI have their own guides — prefer those). The installer -provisions the **same** runner the plugins use, so you end up in the same place. +Use this when there's no dedicated guide for your agent. Claude Code, Codex, +Droid, and Gemini CLI each have their own — prefer those if one matches. This +installer sets up the exact same Zero, so you end up in the same place. ## Install +Run this in your terminal: + ```bash curl -fsSL https://zero.xyz/install.sh | bash ``` -That single command: - -- provisions the Zero runner (downloading a `node` binary if one isn't found) - and puts `zero` on your `PATH`, -- runs `zero init`, which installs the **Zero skill** and registers the **Zero - hooks** (see [What gets installed where](#what-gets-installed-where) below). - -Once it finishes, ask your agent: *"Help me set up and test Zero."* It walks -you through signing in (you approve a browser sign-in once per machine). - -## What gets installed where +That's it — Zero sets itself up automatically and works across all your agents. +You only need to do this once per machine. -`zero init` writes to the directories nearly every skills-capable harness reads: +When it finishes, ask your agent: *"Help me set up and test Zero."* It walks you +through signing in (a quick browser sign-in, once per machine). -- **The Zero skill** → `~/.claude/skills/zero/` **and** `~/.agents/skills/zero/`. - Between those two locations, almost every harness picks up the skill from one - or the other. -- **The Zero hooks** → `~/.claude/settings.json`, for Claude-compatible hosts. - These keep the runner provisioned and up to date and remind the agent that - Zero is available. +### Using an agent with its own skills folder? -All hosts share one login (`~/.zero/config.json`) and one runtime -(`~/.zero/runtime`), so you only sign in once per machine. - -### Harnesses with a bespoke skills directory - -`~/.claude/skills` and `~/.agents/skills` are **always** written. If your -harness reads skills from its own directory in addition to those (say -`~/.yourharness/skills`), name it with `--skills-dir` to install the skill there -too — the flag is additive, and accepts more than one directory: +The installer already covers nearly every agent. If yours keeps skills in its +own folder and didn't pick Zero up, point the installer at that folder: ```bash -zero init --skills-dir ~/.yourharness/skills -# or several at once: -zero init --skills-dir ~/.kiro/skills ~/.other/skills +zero init --skills-dir ~/.youragent/skills ``` -`zero init` is idempotent, so re-running it replaces rather than duplicates. -Note that `zero uninstall` only cleans the default locations — skills written to -a custom `--skills-dir` you remove by hand. - ## Staying up to date -- The Zero runner updates automatically at the start of each session. -- To refresh the skill and hooks, re-run `zero init`. +- Zero updates itself automatically each time you start a session. +- To refresh everything by hand, re-run `zero init` — it's safe to run as often + as you like. ## Uninstalling -The whole install is reversible: +Changed your mind? Remove Zero completely: ```bash zero uninstall @@ -69,6 +46,6 @@ zero uninstall --- -Installing Zero for a coding agent yourself? The full agent-facing runbook — -including authentication and per-harness plugin install — is in +Setting Zero up for a coding agent and want the full technical details — what +gets installed where, authentication, and per-agent plugins? See [agent-install.md](agent-install.md). From 9a97ce86fe1e2cce4d1d63763c96c5950b1aa7f9 Mon Sep 17 00:00:00 2001 From: Spencer Charest Date: Sun, 14 Jun 2026 17:24:09 -0700 Subject: [PATCH 2/2] docs(guides): tighten standalone guide intro and update instructions Simplify the intro to a single sentence, and change "Staying up to date" to re-running the install command rather than relying on session hooks that may not fire. Co-Authored-By: Claude Opus 4.8 (1M context) --- guides/generic.md | 19 ++++++++++--------- 1 file changed, 10 insertions(+), 9 deletions(-) diff --git a/guides/generic.md b/guides/generic.md index 5eb3fb2..f56b08f 100644 --- a/guides/generic.md +++ b/guides/generic.md @@ -1,11 +1,7 @@ # Zero for any agent (standalone installer) -How to install Zero in any agent or harness with a shell — and for humans at a -terminal — then keep it up to date. - -Use this when there's no dedicated guide for your agent. Claude Code, Codex, -Droid, and Gemini CLI each have their own — prefer those if one matches. This -installer sets up the exact same Zero, so you end up in the same place. +How to install Zero in any agent or harness with a shell. Use this when there's +no dedicated guide for your agent. ## Install @@ -32,9 +28,14 @@ zero init --skills-dir ~/.youragent/skills ## Staying up to date -- Zero updates itself automatically each time you start a session. -- To refresh everything by hand, re-run `zero init` — it's safe to run as often - as you like. +To update, just re-run the install command: + +```bash +curl -fsSL https://zero.xyz/install.sh | bash +``` + +If Zero is already installed, it simply updates in place. Safe to run as often +as you like. ## Uninstalling