docs(onboarding): coding-agent prerequisite, npx-only quickstart, codex plugin remove — novice edges 5/9/10 (#943)

Wave 3 (final) of the new-user happy-path fixes from the fresh-eyes
novice test.

**Edge 5** — no doc ever named the one real prerequisite (a coding
agent) or where `/rpi` is typed; the newcomer guide only listed what you
*don't* need. README Quickstart, newcomer-guide, and getting-started now
say it plainly: the loop runs as skills inside your coding agent (Claude
Code, Codex, Cursor, …) and `/rpi` goes in that agent's chat.

**Edge 10** — the Quickstart's first command was `brew install beads`
while the same README insists no tracker is needed. The first block is
now the universal npx line alone; beads is introduced in the bead
section as the optional tracker it is.

**Edge 9** — Codex installed via the `codex plugin` verb but uninstalled
via manual `rm -rf` + config.toml hand-editing. `codex plugin remove`
(verified in `codex plugin --help`: "Remove an installed plugin from
local config and cache") is now primary in install-day2-ops and
MIGRATION; the manual path is an explicit older-Codex fallback.

**Verified:** `ao gate check --full` 67/67 over this range (changelog
sync, doc-release checks, skill snippets). Doc-only — no binary changes.
This commit is contained in:
Bo
2026-07-20 16:13:13 -04:00
committed by GitHub
parent 511370f5d9
commit bbddc4f123
7 changed files with 41 additions and 14 deletions
+5 -3
View File
@@ -109,9 +109,11 @@ that runtime before linking the checkout so only one corpus is visible:
- Claude Code: `claude plugin uninstall agentops@agentops-marketplace`, then
`claude plugin marketplace remove agentops-marketplace`.
- Codex: remove `~/.codex/plugins/cache/agentops-marketplace` and
`~/.codex/.agentops-codex-install.json`, then remove the AgentOps plugin enable
entry from `~/.codex/config.toml`.
- Codex: `codex plugin remove agentops@agentops-marketplace`, then
`codex plugin marketplace remove agentops-marketplace`. (Older Codex without
the plugin verb: remove `~/.codex/plugins/cache/agentops-marketplace` and
`~/.codex/.agentops-codex-install.json`, then remove the AgentOps plugin
enable entry from `~/.codex/config.toml`.)
- Gemini/Antigravity: `agy plugin disable agentops-core-gemini`, then
`agy plugin uninstall agentops-core-gemini`.