github/codegraph
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

fix(installer): write the Claude prompt hook as codegraph.cmd on Windows (#1466) (#1489)

Browse Source 
The standalone bundle's bin dir exposes only codegraph.cmd, and Claude
Code executes UserPromptSubmit hooks through Git Bash, which applies no
PATHEXT — so the bare `codegraph prompt-hook` the installer wrote was
"command not found" (exit 127) on every prompt. Write the platform-correct
spelling, recognize both spellings on uninstall/opt-out, and self-heal an
installer-written entry from the other platform in place on install/upgrade
re-runs (npx/hand-edited variants stay untouched).

Reproduced and validated on the Windows VM: bare form exits 127 under Git
Bash on a standalone-only PATH, codegraph.cmd exits 0; full installer suite
(165 tests, including the new migration coverage) green on Windows + macOS.

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
Colby Mchenry
2026-07-31 17:12:28 -05:00
committed by GitHub
co-authored by Claude Fable 5
parent 572d22bfbe
commit 0682137a42
3 changed files with 87 additions and 12 deletions
Download Patch File Download Diff File Expand all files Collapse all files
src/installer/targets/claude.ts
+37 -4
View File
@@ -296,12 +296,24 @@ function isLegacyCodegraphHookCommand(command: unknown): boolean {
/**
* The front-load prompt-hook command the installer writes into Claude's
* `UserPromptSubmit` (see writePromptHookEntry). Matched by substring so an
* `UserPromptSubmit` (see writePromptHookEntry). On Windows the launcher on
* PATH is `codegraph.cmd`, and Claude Code executes hooks through Git Bash,
* which — unlike cmd.exe — applies no PATHEXT: a bare `codegraph` is
* "command not found", exit 127 (#1466). Write the extension there; the
* `.cmd` spelling also resolves fine under cmd.exe and PowerShell.
*/
const PROMPT_HOOK_COMMAND = process.platform === 'win32'
? 'codegraph.cmd prompt-hook'
: 'codegraph prompt-hook';
/**
* Every spelling the installer has ever written (a settings.json can carry
* the other platform's form across a sync). Matched by substring so an
* `npx @colbymchenry/codegraph prompt-hook` form is recognized too.
*/
const PROMPT_HOOK_COMMAND = 'codegraph prompt-hook';
const PROMPT_HOOK_FORMS = ['codegraph prompt-hook', 'codegraph.cmd prompt-hook'];
function isPromptHookCommand(command: unknown): boolean {
return typeof command === 'string' && command.includes(PROMPT_HOOK_COMMAND);
return typeof command === 'string' && PROMPT_HOOK_FORMS.some((f) => command.includes(f));
}
/**
@@ -424,10 +436,31 @@ export function writePromptHookEntry(loc: Location): WriteResult['files'][number
}
if (!Array.isArray(settings.hooks.UserPromptSubmit)) settings.hooks.UserPromptSubmit = [];
// Self-heal (#1466): a pre-fix install on Windows wrote the bare
// `codegraph prompt-hook`, which Git Bash resolves to nothing; a
// settings.json carried across platforms can hold the other spelling too.
// Rewrite an installer-written command to this platform's form in place.
// Only the exact installer spellings migrate — an `npx …` or hand-edited
// variant is the user's own and stays untouched.
let migrated = false;
for (const group of settings.hooks.UserPromptSubmit) {
if (!group || !Array.isArray(group.hooks)) continue;
for (const h of group.hooks) {
if (h && PROMPT_HOOK_FORMS.includes(h.command) && h.command !== PROMPT_HOOK_COMMAND) {
h.command = PROMPT_HOOK_COMMAND;
migrated = true;
}
}
}
const already = settings.hooks.UserPromptSubmit.some(
(g: any) => g && Array.isArray(g.hooks) && g.hooks.some((h: any) => isPromptHookCommand(h?.command)),
);
if (already) return { path: file, action: 'unchanged' };
if (already) {
if (!migrated) return { path: file, action: 'unchanged' };
writeJsonFile(file, settings);
return { path: file, action: 'updated' };
}
settings.hooks.UserPromptSubmit.push({
hooks: [{ type: 'command', command: PROMPT_HOOK_COMMAND }],