gsd-codex-cli 1.20.4 → 1.20.6

package/.codex/prompts/gsd-plan-milestone-gaps.md

@@ -3,8 +3,6 @@ description: Create phases to close all gaps identified by milestone audit
 argument-hint: [none]
 ---
 
-
-
 ## Objective
 Create phases to close all gaps identified by milestone audit
 
@@ -12,10 +10,11 @@ Create phases to close all gaps identified by milestone audit
 - Use .codex/skills/get-shit-done-codex semantics.
 - Treat upstream workflow as the source of truth.
 - Replace user-specific paths with workspace-relative paths (.claude/..., .planning/...).
-- Resolve gsd-tools path (prefer .cjs, fallback to .js):
-  $GsdTools = if (Test-Path ".claude/get-shit-done/bin/gsd-tools.cjs") { ".claude/get-shit-done/bin/gsd-tools.cjs" } elseif (Test-Path ".claude/get-shit-done/bin/gsd-tools.js") { ".claude/get-shit-done/bin/gsd-tools.js" } elseif (Test-Path "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs") { "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" } elseif (Test-Path "$HOME/.claude/get-shit-done/bin/gsd-tools.js") { "$HOME/.claude/get-shit-done/bin/gsd-tools.js" } else { throw "Missing gsd-tools in .claude or $HOME/.claude. Reinstall GSD." }
-- Run engine commands through PowerShell:
-  node $GsdTools ...
+- Use one of these engine paths (prefer local, fallback global):
+  node .claude/get-shit-done/bin/gsd-tools.js ...
+  node ~/.claude/get-shit-done/bin/gsd-tools.js ...
+- If `.js` is unavailable, use the same path with `.cjs`.
+- Run engine commands through PowerShell.
 - Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
 - No jq / bash-only constructs.
 
@@ -25,18 +24,17 @@ Create phases to close all gaps identified by milestone audit
 - Spawn only when the upstream workflow defines an agent role.
 - Use `.claude/agents/gsd-*.md` as role context for each spawned agent.
 - Do not advance workflow steps until wait and close complete.
-## Update check
-- Best-effort only; do not fail if offline.
-- Run:
-  $installed = if (Test-Path ".codex/gsd/VERSION") { (Get-Content ".codex/gsd/VERSION" -Raw).Trim() } elseif (Test-Path "$HOME/.codex/gsd/VERSION") { (Get-Content "$HOME/.codex/gsd/VERSION" -Raw).Trim() } else { $null }
-  $latest = $null; try { $latest = (npm view gsd-codex-cli version).Trim() } catch {}
-- If $installed and $latest and $installed -ne $latest, surface:
-  "Update available: $installed -> $latest. Next: gsd-update (Codex) / /gsd:update (Claude) or re-run npx gsd-codex-cli@latest."
-
+
+## Update check
+- Best-effort only; do not fail if offline.
+- Check installed Codex fork version from `.codex/gsd/VERSION` (or `~/.codex/gsd/VERSION`).
+- Check latest published version with `npm view gsd-codex-cli version`.
+- If versions differ, surface: "Update available: <installed> -> <latest>. Next: gsd-update (Codex) / /gsd:update (Claude) or re-run npx gsd-codex-cli@latest."
+
 ## Execution
 1. Parse [none] from the user input.
 2. Run init:
-node $GsdTools init milestone-op --raw
+node <gsd-tools-path> init milestone-op --raw
 
 3. Load .claude/get-shit-done/workflows/plan-milestone-gaps.md and execute it step-by-step.
 4. Translate each Task(...) in workflow into:
@@ -44,10 +42,10 @@ node $GsdTools init milestone-op --raw
    - wait for each spawned agent and apply returned output before moving forward.
 5. Preserve all gates and routing from upstream workflow.
 6. Preserve commit behavior using 
-node $GsdTools commit "message" --files ....
-7. If commit preflight fails (no git / no commit flag), proceed in read-only mode and report clearly.
-
-## Completion output
-- Summarize key artifacts created/updated.
-- Next recommended command: use the next user-facing GSD command (Codex prompt name + Claude slash command).
-- Never recommend internal `node ... gsd-tools ...` commands to the user.
+node <gsd-tools-path> commit "message" --files ....
+7. If commit preflight fails (no git / no commit flag), proceed in read-only mode and report clearly.
+
+## Completion output
+- Summarize key artifacts created/updated.
+- Next recommended command: use the next user-facing GSD command (Codex prompt name + Claude slash command).
+- Never recommend internal `node ... gsd-tools ...` commands to the user.

package/.codex/prompts/gsd-plan-phase.md

@@ -3,8 +3,6 @@ description: Create detailed execution plan for a phase (PLAN.md) with verificat
 argument-hint: "[phase] [--research] [--skip-research] [--gaps] [--skip-verify]"
 ---
 
-
-
 ## Objective
 Create detailed execution plan for a phase (PLAN.md) with verification loop
 
@@ -12,10 +10,11 @@ Create detailed execution plan for a phase (PLAN.md) with verification loop
 - Use .codex/skills/get-shit-done-codex semantics.
 - Treat upstream workflow as the source of truth.
 - Replace user-specific paths with workspace-relative paths (.claude/..., .planning/...).
-- Resolve gsd-tools path (prefer .cjs, fallback to .js):
-  $GsdTools = if (Test-Path ".claude/get-shit-done/bin/gsd-tools.cjs") { ".claude/get-shit-done/bin/gsd-tools.cjs" } elseif (Test-Path ".claude/get-shit-done/bin/gsd-tools.js") { ".claude/get-shit-done/bin/gsd-tools.js" } elseif (Test-Path "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs") { "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" } elseif (Test-Path "$HOME/.claude/get-shit-done/bin/gsd-tools.js") { "$HOME/.claude/get-shit-done/bin/gsd-tools.js" } else { throw "Missing gsd-tools in .claude or $HOME/.claude. Reinstall GSD." }
-- Run engine commands through PowerShell:
-  node $GsdTools ...
+- Use one of these engine paths (prefer local, fallback global):
+  node .claude/get-shit-done/bin/gsd-tools.js ...
+  node ~/.claude/get-shit-done/bin/gsd-tools.js ...
+- If `.js` is unavailable, use the same path with `.cjs`.
+- Run engine commands through PowerShell.
 - Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
 - No jq / bash-only constructs.
 
@@ -25,18 +24,17 @@ Create detailed execution plan for a phase (PLAN.md) with verification loop
 - Spawn only when the upstream workflow defines an agent role.
 - Use `.claude/agents/gsd-*.md` as role context for each spawned agent.
 - Do not advance workflow steps until wait and close complete.
-## Update check
-- Best-effort only; do not fail if offline.
-- Run:
-  $installed = if (Test-Path ".codex/gsd/VERSION") { (Get-Content ".codex/gsd/VERSION" -Raw).Trim() } elseif (Test-Path "$HOME/.codex/gsd/VERSION") { (Get-Content "$HOME/.codex/gsd/VERSION" -Raw).Trim() } else { $null }
-  $latest = $null; try { $latest = (npm view gsd-codex-cli version).Trim() } catch {}
-- If $installed and $latest and $installed -ne $latest, surface:
-  "Update available: $installed -> $latest. Next: gsd-update (Codex) / /gsd:update (Claude) or re-run npx gsd-codex-cli@latest."
-
+
+## Update check
+- Best-effort only; do not fail if offline.
+- Check installed Codex fork version from `.codex/gsd/VERSION` (or `~/.codex/gsd/VERSION`).
+- Check latest published version with `npm view gsd-codex-cli version`.
+- If versions differ, surface: "Update available: <installed> -> <latest>. Next: gsd-update (Codex) / /gsd:update (Claude) or re-run npx gsd-codex-cli@latest."
+
 ## Execution
 1. Parse "[phase] [--research] [--skip-research] [--gaps] [--skip-verify]" from the user input.
 2. Run init:
-node $GsdTools init plan-phase $PHASE --include state,roadmap,requirements,context,research,verification,uat --raw
+node <gsd-tools-path> init plan-phase [phase] --include state,roadmap,requirements,context,research,verification,uat --raw
 
 3. Load .claude/get-shit-done/workflows/plan-phase.md and execute it step-by-step.
 4. Translate each Task(...) in workflow into:
@@ -44,10 +42,10 @@ node $GsdTools init plan-phase $PHASE --include state,roadmap,requirements,conte
    - wait for each spawned agent and apply returned output before moving forward.
 5. Preserve all gates and routing from upstream workflow.
 6. Preserve commit behavior using 
-node $GsdTools commit "message" --files ....
-7. If commit preflight fails (no git / no commit flag), proceed in read-only mode and report clearly.
-
-## Completion output
-- Summarize key artifacts created/updated.
-- Next recommended command: `gsd-execute-phase $PHASE` (Codex) / `/gsd:execute-phase $PHASE` (Claude)
-- Never recommend internal `node ... gsd-tools ...` commands to the user.
+node <gsd-tools-path> commit "message" --files ....
+7. If commit preflight fails (no git / no commit flag), proceed in read-only mode and report clearly.
+
+## Completion output
+- Summarize key artifacts created/updated.
+- Next recommended command: `gsd-execute-phase [phase]` (Codex) / `/gsd:execute-phase [phase]` (Claude)
+- Never recommend internal `node ... gsd-tools ...` commands to the user.

package/.codex/prompts/gsd-progress.md

@@ -3,8 +3,6 @@ description: Check project progress, show context, and route to next action
 argument-hint: [none]
 ---
 
-
-
 ## Objective
 Check project progress, show context, and route to next action
 
@@ -12,10 +10,11 @@ Check project progress, show context, and route to next action
 - Use .codex/skills/get-shit-done-codex semantics.
 - Treat upstream workflow as the source of truth.
 - Replace user-specific paths with workspace-relative paths (.claude/..., .planning/...).
-- Resolve gsd-tools path (prefer .cjs, fallback to .js):
-  $GsdTools = if (Test-Path ".claude/get-shit-done/bin/gsd-tools.cjs") { ".claude/get-shit-done/bin/gsd-tools.cjs" } elseif (Test-Path ".claude/get-shit-done/bin/gsd-tools.js") { ".claude/get-shit-done/bin/gsd-tools.js" } elseif (Test-Path "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs") { "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" } elseif (Test-Path "$HOME/.claude/get-shit-done/bin/gsd-tools.js") { "$HOME/.claude/get-shit-done/bin/gsd-tools.js" } else { throw "Missing gsd-tools in .claude or $HOME/.claude. Reinstall GSD." }
-- Run engine commands through PowerShell:
-  node $GsdTools ...
+- Use one of these engine paths (prefer local, fallback global):
+  node .claude/get-shit-done/bin/gsd-tools.js ...
+  node ~/.claude/get-shit-done/bin/gsd-tools.js ...
+- If `.js` is unavailable, use the same path with `.cjs`.
+- Run engine commands through PowerShell.
 - Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
 - No jq / bash-only constructs.
 
@@ -25,18 +24,17 @@ Check project progress, show context, and route to next action
 - Spawn only when the upstream workflow defines an agent role.
 - Use `.claude/agents/gsd-*.md` as role context for each spawned agent.
 - Do not advance workflow steps until wait and close complete.
-## Update check
-- Best-effort only; do not fail if offline.
-- Run:
-  $installed = if (Test-Path ".codex/gsd/VERSION") { (Get-Content ".codex/gsd/VERSION" -Raw).Trim() } elseif (Test-Path "$HOME/.codex/gsd/VERSION") { (Get-Content "$HOME/.codex/gsd/VERSION" -Raw).Trim() } else { $null }
-  $latest = $null; try { $latest = (npm view gsd-codex-cli version).Trim() } catch {}
-- If $installed and $latest and $installed -ne $latest, surface:
-  "Update available: $installed -> $latest. Next: gsd-update (Codex) / /gsd:update (Claude) or re-run npx gsd-codex-cli@latest."
-
+
+## Update check
+- Best-effort only; do not fail if offline.
+- Check installed Codex fork version from `.codex/gsd/VERSION` (or `~/.codex/gsd/VERSION`).
+- Check latest published version with `npm view gsd-codex-cli version`.
+- If versions differ, surface: "Update available: <installed> -> <latest>. Next: gsd-update (Codex) / /gsd:update (Claude) or re-run npx gsd-codex-cli@latest."
+
 ## Execution
 1. Parse [none] from the user input.
 2. Run init:
-node $GsdTools init progress --include state,roadmap,project,config --raw
+node <gsd-tools-path> init progress --include state,roadmap,project,config --raw
 
 3. Load .claude/get-shit-done/workflows/progress.md and execute it step-by-step.
 4. Translate each Task(...) in workflow into:
@@ -44,10 +42,10 @@ node $GsdTools init progress --include state,roadmap,project,config --raw
    - wait for each spawned agent and apply returned output before moving forward.
 5. Preserve all gates and routing from upstream workflow.
 6. Preserve commit behavior using 
-node $GsdTools commit "message" --files ....
-7. If commit preflight fails (no git / no commit flag), proceed in read-only mode and report clearly.
-
-## Completion output
-- Summarize key artifacts created/updated.
-- Next recommended command: use the next user-facing GSD command (Codex prompt name + Claude slash command).
-- Never recommend internal `node ... gsd-tools ...` commands to the user.
+node <gsd-tools-path> commit "message" --files ....
+7. If commit preflight fails (no git / no commit flag), proceed in read-only mode and report clearly.
+
+## Completion output
+- Summarize key artifacts created/updated.
+- Next recommended command: use the next user-facing GSD command (Codex prompt name + Claude slash command).
+- Never recommend internal `node ... gsd-tools ...` commands to the user.

package/.codex/prompts/gsd-quick.md

@@ -3,8 +3,6 @@ description: Execute a quick task with GSD guarantees (atomic commits, state tra
 argument-hint: [none]
 ---
 
-
-
 ## Objective
 Execute a quick task with GSD guarantees (atomic commits, state tracking) but skip optional agents
 
@@ -12,10 +10,11 @@ Execute a quick task with GSD guarantees (atomic commits, state tracking) but sk
 - Use .codex/skills/get-shit-done-codex semantics.
 - Treat upstream workflow as the source of truth.
 - Replace user-specific paths with workspace-relative paths (.claude/..., .planning/...).
-- Resolve gsd-tools path (prefer .cjs, fallback to .js):
-  $GsdTools = if (Test-Path ".claude/get-shit-done/bin/gsd-tools.cjs") { ".claude/get-shit-done/bin/gsd-tools.cjs" } elseif (Test-Path ".claude/get-shit-done/bin/gsd-tools.js") { ".claude/get-shit-done/bin/gsd-tools.js" } elseif (Test-Path "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs") { "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" } elseif (Test-Path "$HOME/.claude/get-shit-done/bin/gsd-tools.js") { "$HOME/.claude/get-shit-done/bin/gsd-tools.js" } else { throw "Missing gsd-tools in .claude or $HOME/.claude. Reinstall GSD." }
-- Run engine commands through PowerShell:
-  node $GsdTools ...
+- Use one of these engine paths (prefer local, fallback global):
+  node .claude/get-shit-done/bin/gsd-tools.js ...
+  node ~/.claude/get-shit-done/bin/gsd-tools.js ...
+- If `.js` is unavailable, use the same path with `.cjs`.
+- Run engine commands through PowerShell.
 - Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
 - No jq / bash-only constructs.
 
@@ -25,18 +24,17 @@ Execute a quick task with GSD guarantees (atomic commits, state tracking) but sk
 - Spawn only when the upstream workflow defines an agent role.
 - Use `.claude/agents/gsd-*.md` as role context for each spawned agent.
 - Do not advance workflow steps until wait and close complete.
-## Update check
-- Best-effort only; do not fail if offline.
-- Run:
-  $installed = if (Test-Path ".codex/gsd/VERSION") { (Get-Content ".codex/gsd/VERSION" -Raw).Trim() } elseif (Test-Path "$HOME/.codex/gsd/VERSION") { (Get-Content "$HOME/.codex/gsd/VERSION" -Raw).Trim() } else { $null }
-  $latest = $null; try { $latest = (npm view gsd-codex-cli version).Trim() } catch {}
-- If $installed and $latest and $installed -ne $latest, surface:
-  "Update available: $installed -> $latest. Next: gsd-update (Codex) / /gsd:update (Claude) or re-run npx gsd-codex-cli@latest."
-
+
+## Update check
+- Best-effort only; do not fail if offline.
+- Check installed Codex fork version from `.codex/gsd/VERSION` (or `~/.codex/gsd/VERSION`).
+- Check latest published version with `npm view gsd-codex-cli version`.
+- If versions differ, surface: "Update available: <installed> -> <latest>. Next: gsd-update (Codex) / /gsd:update (Claude) or re-run npx gsd-codex-cli@latest."
+
 ## Execution
 1. Parse [none] from the user input.
 2. Run init:
-node $GsdTools init quick "$ARG" --raw
+node <gsd-tools-path> init quick "[argument]" --raw
 
 3. Load .claude/get-shit-done/workflows/quick.md and execute it step-by-step.
 4. Translate each Task(...) in workflow into:
@@ -44,10 +42,10 @@ node $GsdTools init quick "$ARG" --raw
    - wait for each spawned agent and apply returned output before moving forward.
 5. Preserve all gates and routing from upstream workflow.
 6. Preserve commit behavior using 
-node $GsdTools commit "message" --files ....
-7. If commit preflight fails (no git / no commit flag), proceed in read-only mode and report clearly.
-
-## Completion output
-- Summarize key artifacts created/updated.
-- Next recommended command: use the next user-facing GSD command (Codex prompt name + Claude slash command).
-- Never recommend internal `node ... gsd-tools ...` commands to the user.
+node <gsd-tools-path> commit "message" --files ....
+7. If commit preflight fails (no git / no commit flag), proceed in read-only mode and report clearly.
+
+## Completion output
+- Summarize key artifacts created/updated.
+- Next recommended command: use the next user-facing GSD command (Codex prompt name + Claude slash command).
+- Never recommend internal `node ... gsd-tools ...` commands to the user.

package/.codex/prompts/gsd-remove-phase.md

@@ -3,8 +3,6 @@ description: Remove a future phase from roadmap and renumber subsequent phases
 argument-hint: <phase-number>
 ---
 
-
-
 ## Objective
 Remove a future phase from roadmap and renumber subsequent phases
 
@@ -12,10 +10,11 @@ Remove a future phase from roadmap and renumber subsequent phases
 - Use .codex/skills/get-shit-done-codex semantics.
 - Treat upstream workflow as the source of truth.
 - Replace user-specific paths with workspace-relative paths (.claude/..., .planning/...).
-- Resolve gsd-tools path (prefer .cjs, fallback to .js):
-  $GsdTools = if (Test-Path ".claude/get-shit-done/bin/gsd-tools.cjs") { ".claude/get-shit-done/bin/gsd-tools.cjs" } elseif (Test-Path ".claude/get-shit-done/bin/gsd-tools.js") { ".claude/get-shit-done/bin/gsd-tools.js" } elseif (Test-Path "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs") { "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" } elseif (Test-Path "$HOME/.claude/get-shit-done/bin/gsd-tools.js") { "$HOME/.claude/get-shit-done/bin/gsd-tools.js" } else { throw "Missing gsd-tools in .claude or $HOME/.claude. Reinstall GSD." }
-- Run engine commands through PowerShell:
-  node $GsdTools ...
+- Use one of these engine paths (prefer local, fallback global):
+  node .claude/get-shit-done/bin/gsd-tools.js ...
+  node ~/.claude/get-shit-done/bin/gsd-tools.js ...
+- If `.js` is unavailable, use the same path with `.cjs`.
+- Run engine commands through PowerShell.
 - Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
 - No jq / bash-only constructs.
 
@@ -25,18 +24,17 @@ Remove a future phase from roadmap and renumber subsequent phases
 - Spawn only when the upstream workflow defines an agent role.
 - Use `.claude/agents/gsd-*.md` as role context for each spawned agent.
 - Do not advance workflow steps until wait and close complete.
-## Update check
-- Best-effort only; do not fail if offline.
-- Run:
-  $installed = if (Test-Path ".codex/gsd/VERSION") { (Get-Content ".codex/gsd/VERSION" -Raw).Trim() } elseif (Test-Path "$HOME/.codex/gsd/VERSION") { (Get-Content "$HOME/.codex/gsd/VERSION" -Raw).Trim() } else { $null }
-  $latest = $null; try { $latest = (npm view gsd-codex-cli version).Trim() } catch {}
-- If $installed and $latest and $installed -ne $latest, surface:
-  "Update available: $installed -> $latest. Next: gsd-update (Codex) / /gsd:update (Claude) or re-run npx gsd-codex-cli@latest."
-
+
+## Update check
+- Best-effort only; do not fail if offline.
+- Check installed Codex fork version from `.codex/gsd/VERSION` (or `~/.codex/gsd/VERSION`).
+- Check latest published version with `npm view gsd-codex-cli version`.
+- If versions differ, surface: "Update available: <installed> -> <latest>. Next: gsd-update (Codex) / /gsd:update (Claude) or re-run npx gsd-codex-cli@latest."
+
 ## Execution
 1. Parse <phase-number> from the user input.
 2. Run init:
-node $GsdTools init phase-op $ARG --raw
+node <gsd-tools-path> init phase-op [argument] --raw
 
 3. Load .claude/get-shit-done/workflows/remove-phase.md and execute it step-by-step.
 4. Translate each Task(...) in workflow into:
@@ -44,10 +42,10 @@ node $GsdTools init phase-op $ARG --raw
    - wait for each spawned agent and apply returned output before moving forward.
 5. Preserve all gates and routing from upstream workflow.
 6. Preserve commit behavior using 
-node $GsdTools commit "message" --files ....
-7. If commit preflight fails (no git / no commit flag), proceed in read-only mode and report clearly.
-
-## Completion output
-- Summarize key artifacts created/updated.
-- Next recommended command: use the next user-facing GSD command (Codex prompt name + Claude slash command).
-- Never recommend internal `node ... gsd-tools ...` commands to the user.
+node <gsd-tools-path> commit "message" --files ....
+7. If commit preflight fails (no git / no commit flag), proceed in read-only mode and report clearly.
+
+## Completion output
+- Summarize key artifacts created/updated.
+- Next recommended command: use the next user-facing GSD command (Codex prompt name + Claude slash command).
+- Never recommend internal `node ... gsd-tools ...` commands to the user.

package/.codex/prompts/gsd-research-phase.md

@@ -3,8 +3,6 @@ description: Research how to implement a phase (standalone - usually use plan-ph
 argument-hint: "[phase]"
 ---
 
-
-
 ## Objective
 Research how to implement a phase (standalone - usually use plan-phase instead)
 
@@ -12,10 +10,11 @@ Research how to implement a phase (standalone - usually use plan-phase instead)
 - Use .codex/skills/get-shit-done-codex semantics.
 - Treat upstream workflow as the source of truth.
 - Replace user-specific paths with workspace-relative paths (.claude/..., .planning/...).
-- Resolve gsd-tools path (prefer .cjs, fallback to .js):
-  $GsdTools = if (Test-Path ".claude/get-shit-done/bin/gsd-tools.cjs") { ".claude/get-shit-done/bin/gsd-tools.cjs" } elseif (Test-Path ".claude/get-shit-done/bin/gsd-tools.js") { ".claude/get-shit-done/bin/gsd-tools.js" } elseif (Test-Path "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs") { "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" } elseif (Test-Path "$HOME/.claude/get-shit-done/bin/gsd-tools.js") { "$HOME/.claude/get-shit-done/bin/gsd-tools.js" } else { throw "Missing gsd-tools in .claude or $HOME/.claude. Reinstall GSD." }
-- Run engine commands through PowerShell:
-  node $GsdTools ...
+- Use one of these engine paths (prefer local, fallback global):
+  node .claude/get-shit-done/bin/gsd-tools.js ...
+  node ~/.claude/get-shit-done/bin/gsd-tools.js ...
+- If `.js` is unavailable, use the same path with `.cjs`.
+- Run engine commands through PowerShell.
 - Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
 - No jq / bash-only constructs.
 
@@ -25,18 +24,17 @@ Research how to implement a phase (standalone - usually use plan-phase instead)
 - Spawn only when the upstream workflow defines an agent role.
 - Use `.claude/agents/gsd-*.md` as role context for each spawned agent.
 - Do not advance workflow steps until wait and close complete.
-## Update check
-- Best-effort only; do not fail if offline.
-- Run:
-  $installed = if (Test-Path ".codex/gsd/VERSION") { (Get-Content ".codex/gsd/VERSION" -Raw).Trim() } elseif (Test-Path "$HOME/.codex/gsd/VERSION") { (Get-Content "$HOME/.codex/gsd/VERSION" -Raw).Trim() } else { $null }
-  $latest = $null; try { $latest = (npm view gsd-codex-cli version).Trim() } catch {}
-- If $installed and $latest and $installed -ne $latest, surface:
-  "Update available: $installed -> $latest. Next: gsd-update (Codex) / /gsd:update (Claude) or re-run npx gsd-codex-cli@latest."
-
+
+## Update check
+- Best-effort only; do not fail if offline.
+- Check installed Codex fork version from `.codex/gsd/VERSION` (or `~/.codex/gsd/VERSION`).
+- Check latest published version with `npm view gsd-codex-cli version`.
+- If versions differ, surface: "Update available: <installed> -> <latest>. Next: gsd-update (Codex) / /gsd:update (Claude) or re-run npx gsd-codex-cli@latest."
+
 ## Execution
 1. Parse "[phase]" from the user input.
 2. Run init:
-node $GsdTools init phase-op $ARG --raw
+node <gsd-tools-path> init phase-op [argument] --raw
 
 3. Load .claude/get-shit-done/workflows/research-phase.md and execute it step-by-step.
 4. Translate each Task(...) in workflow into:
@@ -44,10 +42,10 @@ node $GsdTools init phase-op $ARG --raw
    - wait for each spawned agent and apply returned output before moving forward.
 5. Preserve all gates and routing from upstream workflow.
 6. Preserve commit behavior using 
-node $GsdTools commit "message" --files ....
-7. If commit preflight fails (no git / no commit flag), proceed in read-only mode and report clearly.
-
-## Completion output
-- Summarize key artifacts created/updated.
-- Next recommended command: use the next user-facing GSD command (Codex prompt name + Claude slash command).
-- Never recommend internal `node ... gsd-tools ...` commands to the user.
+node <gsd-tools-path> commit "message" --files ....
+7. If commit preflight fails (no git / no commit flag), proceed in read-only mode and report clearly.
+
+## Completion output
+- Summarize key artifacts created/updated.
+- Next recommended command: use the next user-facing GSD command (Codex prompt name + Claude slash command).
+- Never recommend internal `node ... gsd-tools ...` commands to the user.

package/.codex/prompts/gsd-resume-work.md

@@ -3,8 +3,6 @@ description: Resume work from previous session with full context restoration
 argument-hint: [none]
 ---
 
-
-
 ## Objective
 Resume work from previous session with full context restoration
 
@@ -12,10 +10,11 @@ Resume work from previous session with full context restoration
 - Use .codex/skills/get-shit-done-codex semantics.
 - Treat upstream workflow as the source of truth.
 - Replace user-specific paths with workspace-relative paths (.claude/..., .planning/...).
-- Resolve gsd-tools path (prefer .cjs, fallback to .js):
-  $GsdTools = if (Test-Path ".claude/get-shit-done/bin/gsd-tools.cjs") { ".claude/get-shit-done/bin/gsd-tools.cjs" } elseif (Test-Path ".claude/get-shit-done/bin/gsd-tools.js") { ".claude/get-shit-done/bin/gsd-tools.js" } elseif (Test-Path "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs") { "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" } elseif (Test-Path "$HOME/.claude/get-shit-done/bin/gsd-tools.js") { "$HOME/.claude/get-shit-done/bin/gsd-tools.js" } else { throw "Missing gsd-tools in .claude or $HOME/.claude. Reinstall GSD." }
-- Run engine commands through PowerShell:
-  node $GsdTools ...
+- Use one of these engine paths (prefer local, fallback global):
+  node .claude/get-shit-done/bin/gsd-tools.js ...
+  node ~/.claude/get-shit-done/bin/gsd-tools.js ...
+- If `.js` is unavailable, use the same path with `.cjs`.
+- Run engine commands through PowerShell.
 - Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
 - No jq / bash-only constructs.
 
@@ -25,18 +24,17 @@ Resume work from previous session with full context restoration
 - Spawn only when the upstream workflow defines an agent role.
 - Use `.claude/agents/gsd-*.md` as role context for each spawned agent.
 - Do not advance workflow steps until wait and close complete.
-## Update check
-- Best-effort only; do not fail if offline.
-- Run:
-  $installed = if (Test-Path ".codex/gsd/VERSION") { (Get-Content ".codex/gsd/VERSION" -Raw).Trim() } elseif (Test-Path "$HOME/.codex/gsd/VERSION") { (Get-Content "$HOME/.codex/gsd/VERSION" -Raw).Trim() } else { $null }
-  $latest = $null; try { $latest = (npm view gsd-codex-cli version).Trim() } catch {}
-- If $installed and $latest and $installed -ne $latest, surface:
-  "Update available: $installed -> $latest. Next: gsd-update (Codex) / /gsd:update (Claude) or re-run npx gsd-codex-cli@latest."
-
+
+## Update check
+- Best-effort only; do not fail if offline.
+- Check installed Codex fork version from `.codex/gsd/VERSION` (or `~/.codex/gsd/VERSION`).
+- Check latest published version with `npm view gsd-codex-cli version`.
+- If versions differ, surface: "Update available: <installed> -> <latest>. Next: gsd-update (Codex) / /gsd:update (Claude) or re-run npx gsd-codex-cli@latest."
+
 ## Execution
 1. Parse [none] from the user input.
 2. Run init:
-node $GsdTools init resume --raw
+node <gsd-tools-path> init resume --raw
 
 3. Load .claude/get-shit-done/workflows/resume-project.md and execute it step-by-step.
 4. Translate each Task(...) in workflow into:
@@ -44,10 +42,10 @@ node $GsdTools init resume --raw
    - wait for each spawned agent and apply returned output before moving forward.
 5. Preserve all gates and routing from upstream workflow.
 6. Preserve commit behavior using 
-node $GsdTools commit "message" --files ....
-7. If commit preflight fails (no git / no commit flag), proceed in read-only mode and report clearly.
-
-## Completion output
-- Summarize key artifacts created/updated.
-- Next recommended command: use the next user-facing GSD command (Codex prompt name + Claude slash command).
-- Never recommend internal `node ... gsd-tools ...` commands to the user.
+node <gsd-tools-path> commit "message" --files ....
+7. If commit preflight fails (no git / no commit flag), proceed in read-only mode and report clearly.
+
+## Completion output
+- Summarize key artifacts created/updated.
+- Next recommended command: use the next user-facing GSD command (Codex prompt name + Claude slash command).
+- Never recommend internal `node ... gsd-tools ...` commands to the user.

package/.codex/prompts/gsd-set-profile.md

@@ -3,8 +3,6 @@ description: Switch model profile for GSD agents (quality/balanced/budget)
 argument-hint: <profile>
 ---
 
-
-
 ## Objective
 Switch model profile for GSD agents (quality/balanced/budget)
 
@@ -12,10 +10,11 @@ Switch model profile for GSD agents (quality/balanced/budget)
 - Use .codex/skills/get-shit-done-codex semantics.
 - Treat upstream workflow as the source of truth.
 - Replace user-specific paths with workspace-relative paths (.claude/..., .planning/...).
-- Resolve gsd-tools path (prefer .cjs, fallback to .js):
-  $GsdTools = if (Test-Path ".claude/get-shit-done/bin/gsd-tools.cjs") { ".claude/get-shit-done/bin/gsd-tools.cjs" } elseif (Test-Path ".claude/get-shit-done/bin/gsd-tools.js") { ".claude/get-shit-done/bin/gsd-tools.js" } elseif (Test-Path "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs") { "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" } elseif (Test-Path "$HOME/.claude/get-shit-done/bin/gsd-tools.js") { "$HOME/.claude/get-shit-done/bin/gsd-tools.js" } else { throw "Missing gsd-tools in .claude or $HOME/.claude. Reinstall GSD." }
-- Run engine commands through PowerShell:
-  node $GsdTools ...
+- Use one of these engine paths (prefer local, fallback global):
+  node .claude/get-shit-done/bin/gsd-tools.js ...
+  node ~/.claude/get-shit-done/bin/gsd-tools.js ...
+- If `.js` is unavailable, use the same path with `.cjs`.
+- Run engine commands through PowerShell.
 - Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
 - No jq / bash-only constructs.
 
@@ -25,18 +24,17 @@ Switch model profile for GSD agents (quality/balanced/budget)
 - Spawn only when the upstream workflow defines an agent role.
 - Use `.claude/agents/gsd-*.md` as role context for each spawned agent.
 - Do not advance workflow steps until wait and close complete.
-## Update check
-- Best-effort only; do not fail if offline.
-- Run:
-  $installed = if (Test-Path ".codex/gsd/VERSION") { (Get-Content ".codex/gsd/VERSION" -Raw).Trim() } elseif (Test-Path "$HOME/.codex/gsd/VERSION") { (Get-Content "$HOME/.codex/gsd/VERSION" -Raw).Trim() } else { $null }
-  $latest = $null; try { $latest = (npm view gsd-codex-cli version).Trim() } catch {}
-- If $installed and $latest and $installed -ne $latest, surface:
-  "Update available: $installed -> $latest. Next: gsd-update (Codex) / /gsd:update (Claude) or re-run npx gsd-codex-cli@latest."
-
+
+## Update check
+- Best-effort only; do not fail if offline.
+- Check installed Codex fork version from `.codex/gsd/VERSION` (or `~/.codex/gsd/VERSION`).
+- Check latest published version with `npm view gsd-codex-cli version`.
+- If versions differ, surface: "Update available: <installed> -> <latest>. Next: gsd-update (Codex) / /gsd:update (Claude) or re-run npx gsd-codex-cli@latest."
+
 ## Execution
 1. Parse <profile> from the user input.
 2. Run init:
-node $GsdTools state load --raw
+node <gsd-tools-path> state load --raw
 
 3. Load .claude/get-shit-done/workflows/set-profile.md and execute it step-by-step.
 4. Translate each Task(...) in workflow into:
@@ -44,10 +42,10 @@ node $GsdTools state load --raw
    - wait for each spawned agent and apply returned output before moving forward.
 5. Preserve all gates and routing from upstream workflow.
 6. Preserve commit behavior using 
-node $GsdTools commit "message" --files ....
-7. If commit preflight fails (no git / no commit flag), proceed in read-only mode and report clearly.
-
-## Completion output
-- Summarize key artifacts created/updated.
-- Next recommended command: use the next user-facing GSD command (Codex prompt name + Claude slash command).
-- Never recommend internal `node ... gsd-tools ...` commands to the user.
+node <gsd-tools-path> commit "message" --files ....
+7. If commit preflight fails (no git / no commit flag), proceed in read-only mode and report clearly.
+
+## Completion output
+- Summarize key artifacts created/updated.
+- Next recommended command: use the next user-facing GSD command (Codex prompt name + Claude slash command).
+- Never recommend internal `node ... gsd-tools ...` commands to the user.