The page still described the rules-file-only Cursor setup from before #4649
and the old --remove scope. Rewrite it against what bd installs today:
- project setup: .cursor/rules/beads.mdc, the shared .agents/skills/beads/
skill, and .cursor/hooks.json with sessionStart/preCompact/postToolUse
hooks running `bd cursor-hook <event>` (user entries left alone)
- `bd init` runs the project setup unless --skip-agents/--stealth or bare
- --global: ~/.cursor/hooks.json + ~/.agents/skills/beads/, no rules file
- hook lifecycle: sessionStart injects bd prime; preCompact arms a refresh
marker; postToolUse re-injects once and clears it; markers live in the user
cache dir keyed by conversation_id + workspace root
- --check scope per mode and the exit/hint on a missing piece
- --remove keeps user hooks, deletes hooks.json once only `version` remains,
keeps the skill while the Codex integration still uses it
- a manual hooks.json fallback in the shape bd writes
README.md: `bd init` also installs the Cursor integration, not only
Claude Code and Codex (the default init route in cmd/bd/init.go).
Follow-up to #7268 (bd-gy483w, the README line from bd-erf5vx).
Co-authored-by: Claude Fable 5.1 <noreply@anthropic.com>