mirror of
https://github.com/garrytan/gbrain.git
synced 2026-08-14 08:53:22 +00:00
`docs/tutorials/personal-brain.md` Step 6 instructed `gbrain install`, which fails with "Unknown command: install" — the managed-install model was retired in v0.36.0.0. Step 6 now documents the current flow (`gbrain init --supabase` in the brain repo, `gbrain skillpack scaffold --all` in the agent workspace), states which repo each command runs in, and how it feeds the Step 7 Supabase setup. Full sweep of README/docs/skills for `gbrain <verb>` invocations against the live CLI surface (CLI_ONLY + op cliHints names + aliases) found and fixed every other dead reference: the second `gbrain install` site in the ethos doc, `put-page`/`put_page`/`get_page` → `put`/`get`, `add_link` → `link`, `add_timeline_entry --entry` → `timeline-add` positional form, `get_links`/`put_raw_data`/`get_raw_data` (MCP-only ops) → `gbrain call <op> '<json>'`, `find_trajectory` → `find-trajectory`, `gbrain file upload` → `gbrain files upload`, `gbrain pages restore` → `gbrain restore`, the never-shipped `gbrain rebuild` → the real recovery sequence, and stale forward-notes (`gbrain cron`, `gbrain transcription`, `gbrain research init`, `gbrain plugin list`). Two documented surfaces turned out to be unwired CODE, not wrong docs, so they're wired instead of rewritten: `pages` had a live handleCliOnly case but was missing from CLI_ONLY (the #2035 calibration bug class), and `bench publish` (bench-publish.ts, referenced by eval-gate's own --help) was never dispatched — same promised-but-unwired class as retrieval-upgrade (#3390). New CI guard: test/docs-cli-commands.test.ts scans README/docs/skills code blocks + inline spans for `gbrain <verb>` and fails on any verb not in the live command set (historical docs excluded by design; prose kept out via comment/diagram/command-position heuristics). llms bundle regenerated (`bun run build:llms`) for the inlined docs. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>