Add the doctor command to detect installed tools - #2
Merged
DominicFrei merged 1 commit intoJul 30, 2026
Conversation
gaffa doctor reports which of the target AI coding tools are on the machine, where each keeps its config, and whether the gaffa skills are already set up in it. It reads only and writes nothing, and adds no runtime dependency. Tools: Claude Code, Codex, GitHub Copilot, Cursor and Antigravity. Each is detected by its config directory rather than a binary on the path, since an IDE may put nothing on the path. Paths come from each tool's own docs, cross-checked against the plugin spike where a tool was installed for real. A config env override (CLAUDE_CONFIG_DIR, CODEX_HOME, COPILOT_HOME) moves both the detection and the skills lookup. Skills detection reports present or absent for now. Drift against a written receipt comes with the install command. Add --json for machine output, and unit plus integration tests.
jamesmundy
approved these changes
Jul 29, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Fixes GAF-667
gaffa doctorreports which target AI coding tools are on the machine, where each keeps its config, and whether the gaffa skills are already set up in it. Reads only, writes nothing, no new runtime dependency.Detected by config directory rather than a PATH binary, since an IDE may put nothing on the path. A config env override (CLAUDE_CONFIG_DIR, CODEX_HOME, COPILOT_HOME) moves both detection and the skills lookup. Skills are reported present or absent for now. Drift against a written receipt comes with the install command (GAF-668).
--jsongives the same result as structured output.Paths, verified per tool:
Two paths I could not confirm per OS from primary docs and treated as the logical ~ expansion: Codex and Antigravity on Windows. Antigravity's IDE-app config dir is also undocumented, so detection uses its CLI dir.