feat(cli): add squad doctor diagnostic command#182
feat(cli): add squad doctor diagnostic command#182KalebCole wants to merge 1 commit intobradygaster:mainfrom
Conversation
Add 'squad doctor' subcommand that runs 9 diagnostic checks (git repo, node version, agent file, squad dir, team init, decisions.md, gh CLI, gh auth, copilot CLI) with colored pass/fail/warn output and actionable fix hints. Fix copilot subcommand to use detectSquadDir() instead of hardcoded .ai-team/ path. Closes bradygaster#175 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
i did not actually test this lol. let me verify first. main concern is that i'm not seeing the squad agent in the /agents command of copilot cli |
|
found the reason why - it was just a scoping issue |
…tes (#185, #188, #191, #192, #195, #196, #199, #201, #203, #206, #207) Documentation Epic #182 — complete: Docs Content (McManus): - Architecture overview: SDK ↔ CLI ↔ SquadUI system design - Migration guide: Beta → v1 with 10-step checklist - Global CLI install guide: npm, npx, GitHub native - VS Code integration guide: client compatibility, extension patterns - SDK API reference: 574 lines, all 30+ exports documented Docs Site Engine (Keaton): - Static site generator: node docs/build.js → docs/dist/ - GitHub Pages ready, responsive design, sidebar nav - Index landing page linking all guides Mechanical Updates (Fenster): - .ai-team/ → .squad/ across 25 doc files (#191) - CLI invocation references verified current (#192) - Beta repo URLs updated to squad-pr (#195) Docs Tests (Hockney): - 17 docs validation tests: headings, code blocks, links, build - Fixed link checker for parent-dir refs, Windows rmSync Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
feat: Wave 3 — Documentation Epic complete (#182)
|
Thank you for this thorough work, @KalebCole. The Both items in this PR are now implemented in the v1 TypeScript replatform:
The public squad repo had code duplication and technical debt from multiple rounds of pattern experimentation. We consolidated the best implementations into this private repo, which is now the canonical source. This PR would have been the right fix for the old codebase, but it's superseded by the newer architecture. We appreciate you taking the time to report and fix these—it helped validate the design approach we took for v1. |
|
Closing in favor of the v1 TypeScript replatform implementation. The squad doctor and copilot path fixes are now shipped. |
|
[This is actually me this time, but i prefer their explanation!] We'd been working in another repo to test out a lot of features. Your PR came in during that, so we just used it as inspiration and built in in. Thank you so much for the ideas - no more 2nd repo now, so, keep them coming here! |
|
This tool is awesome. I just had someone demo their use of this and I'm looking forward to moving from my single threaded ways of 15 different pwsh tabs with copilot cli on all of them |
2 participants
What
Adds a \squad doctor\ subcommand that runs 9 diagnostic checks to help users troubleshoot setup issues — especially when /agent\ doesn't show Squad in Copilot CLI.
Also fixes #175 — the \copilot\ subcommand was hardcoded to .ai-team/team.md\ instead of using \detectSquadDir().
Why
When users install Squad and type /agent\ in Copilot CLI, there's zero diagnostic tooling if Squad doesn't appear. Common causes (wrong directory, missing agent file, team not initialized, gh not authed) are invisible. This command surfaces them with actionable fix hints.
Checks
Example Output
\
$ npx github:bradygaster/squad doctor
Squad Doctor — checking your setup
✓ Git repository
✓ Node.js v22.18.0
✓ Agent file found (v0.5.4)
✓ Squad state: .squad/
✓ Team initialized (5 sections)
✓ Shared brain ready (decisions.md)
✓ gh CLI (v2.80.0)
✓ Authenticated as @KalebCole
✓ Copilot CLI (GitHub Copilot CLI 0.0.421)
9 passed
\\
Details
Testing
Tested on Windows (PowerShell) with Squad v0.5.4: