Skip to content

docs(guides): make standalone installer guide more user-friendly#48

Merged
spencercharest merged 2 commits into
mainfrom
docs/generic-guide-user-friendly
Jun 15, 2026
Merged

docs(guides): make standalone installer guide more user-friendly#48
spencercharest merged 2 commits into
mainfrom
docs/generic-guide-user-friendly

Conversation

@spencercharest

Copy link
Copy Markdown
Collaborator

Reworks guides/generic.md to be friendlier and less technical, and trims the README so the standalone entry is just a link.

Changes

guides/generic.md — now matches the consumer-facing shape of the other per-host guides:

  • Short intro + a "use this when" note.
  • Install: the single command, "Zero sets itself up automatically," and the "Help me set up and test Zero" prompt.
  • Dropped the deep "What gets installed where" section (skill/hook paths, ~/.zero config/runtime, MCP). Kept a plain-language version of --skills-dir for agents that need it.
  • Kept concise Staying up to date and Uninstalling sections.
  • Deep technical detail now lives behind a single pointer to agent-install.md.

README.md — the standalone entry is now just the link + tagline, matching every other agent in the Install Zero list, so the linked guide is the single source of those details.

Docs-only change — nothing the plugin ships, so no version bump per CLAUDE.md.

🤖 Generated with Claude Code

spencercharest and others added 2 commits June 14, 2026 17:18
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) <noreply@anthropic.com>
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) <noreply@anthropic.com>
@spencercharest
spencercharest merged commit 467c0ab into main Jun 15, 2026
1 check passed
@spencercharest
spencercharest deleted the docs/generic-guide-user-friendly branch June 15, 2026 00:25
spencercharest added a commit that referenced this pull request Jul 2, 2026
* feat(zero): add 15 agents/harnesses to the install matrix

Folds the ZERO-294 adapter PRs (#37-#56, excl. #48/#58) into
plugins/zero/agents.json: amp, antigravity, cline, continue-cli, copilot,
crush, cursor, devin, goose, hermes, kilo-code, opencode, qwen-code, trae,
zed. Roo Code (#53) and Replit Agent (#50) are not addable (product shut
down / no local footprint). Existing kiro (#42) and warp (#46) entries were
re-verified and stand as-is.

qwen-code is plugin-installable (verified live: non-interactive marketplace
install with --consent, native --auto-update); everything else is
standalone-only. Hook fragments added where the host has a JSON hook config
whose semantics tolerate our scripts: continue-cli (full Claude-compatible),
devin (SessionStart+UserPromptSubmit), qwen-code (full, ms timeouts),
copilot/cursor/goose (SessionStart only, host dialects).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

* ci(version-check): detect manifests by top-level version key, not grep

agents.json now carries host hook-dialect fragments that legitimately
contain a nested "version" field (Copilot/Cursor hooks files); the grep
matched it and lockstep failed on a non-manifest.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

* feat(zero): drop standalone.mcp from new matrix entries

MCP config targets are only needed for ephemeral environments where auth
session data cannot be written to disk; the new entries are all persistent
hosts. kiro/warp keep their pre-existing blocks. The researched per-host
MCP surfaces remain documented in the closed adapter PRs.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

* feat(zero): drop standalone.mcp from kiro and warp too

MCP config targets are only for ephemeral environments where auth session
data cannot be written to disk; no matrix entry needs one.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant