Skip to content

[GFI] Add a coco doctor health-check command #26

Description

@rijul-mck

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

  • bash scripts/doctor.sh (or coco doctor) prints a readable report with ✓/✗ per check
  • Exit code non-zero when a hard requirement is missing
  • Offline-safe; no telemetry
  • CI passes (install script syntax check)

Hints

  • Reuse the detection logic in install.sh (detect_adapter) and scripts/check-update.sh.

Metadata

Metadata

Assignees

No one assigned

    Labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions