Goal
Add a coco doctor health-check that diagnoses a Coco install and prints a clear pass/fail report. New users currently have no single command to confirm everything wired up correctly.
What it should check
- Required tools present:
git, bash, python3 (and node for the npm CLI)
- Detected IDE/adapter (
~/.claude, ~/.cursor, VS Code, Codex)
- Symlinks resolve (no dangling links into the repo)
- Installed bundles (gsd / brain / team / superintelligence) and their asset counts
- For Superintelligence: that SI commands were generated (per-team + meta)
- Installed version + whether an update is available (reuse
scripts/check-update.sh)
Files involved
scripts/doctor.sh (new), or a doctor subcommand in bin/coco.js
- Wire a mention into
install.sh output and the README "Staying Current" section
Acceptance criteria
Hints
- Reuse the detection logic in
install.sh (detect_adapter) and scripts/check-update.sh.
Goal
Add a
coco doctorhealth-check that diagnoses a Coco install and prints a clear pass/fail report. New users currently have no single command to confirm everything wired up correctly.What it should check
git,bash,python3(andnodefor the npm CLI)~/.claude,~/.cursor, VS Code, Codex)scripts/check-update.sh)Files involved
scripts/doctor.sh(new), or adoctorsubcommand inbin/coco.jsinstall.shoutput and the README "Staying Current" sectionAcceptance criteria
bash scripts/doctor.sh(orcoco doctor) prints a readable report with ✓/✗ per checkHints
install.sh(detect_adapter) andscripts/check-update.sh.