gsd-codex-cli 1.20.3 → 1.20.5

package/.codex/prompts/gsd-list-phase-assumptions.md

@@ -12,8 +12,11 @@ Surface Claude's assumptions about a phase approach before planning
 - 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/...).
-- Run engine commands through PowerShell: 
-node .claude/get-shit-done/bin/gsd-tools.js ...
+- 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.
 
@@ -24,16 +27,15 @@ node .claude/get-shit-done/bin/gsd-tools.js ...
 - Use `.claude/agents/gsd-*.md` as role context for each spawned agent.
 - Do not advance workflow steps until wait and close complete.
 ## Update check
-- Run:
-  $update = node .claude/get-shit-done/bin/gsd-tools.cjs update check --raw | ConvertFrom-Json
-- If $update.update_available is true, surface:
-  "Update available: $($update.installed) -> $($update.latest). Run /gsd:update or re-run npx gsd-codex-cli@latest."
-
+- 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 .claude/get-shit-done/bin/gsd-tools.js init phase-op $ARG --raw
+node <gsd-tools-path> init phase-op [argument] --raw
 
 3. Load .claude/get-shit-done/workflows/list-phase-assumptions.md and execute it step-by-step.
 4. Translate each Task(...) in workflow into:
@@ -41,10 +43,10 @@ node .claude/get-shit-done/bin/gsd-tools.js 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 .claude/get-shit-done/bin/gsd-tools.js 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 and next recommended command.
-
-
+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-map-codebase.md

@@ -12,8 +12,11 @@ Analyze codebase with parallel mapper agents to produce .planning/codebase/ docu
 - 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/...).
-- Run engine commands through PowerShell: 
-node .claude/get-shit-done/bin/gsd-tools.js ...
+- 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.
 
@@ -24,16 +27,15 @@ node .claude/get-shit-done/bin/gsd-tools.js ...
 - Use `.claude/agents/gsd-*.md` as role context for each spawned agent.
 - Do not advance workflow steps until wait and close complete.
 ## Update check
-- Run:
-  $update = node .claude/get-shit-done/bin/gsd-tools.cjs update check --raw | ConvertFrom-Json
-- If $update.update_available is true, surface:
-  "Update available: $($update.installed) -> $($update.latest). Run /gsd:update or re-run npx gsd-codex-cli@latest."
-
+- 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 "[optional: specific area to map, for example api or auth]" from the user input.
 2. Run init:
-node .claude/get-shit-done/bin/gsd-tools.js init map-codebase --raw
+node <gsd-tools-path> init map-codebase --raw
 
 3. Load .claude/get-shit-done/workflows/map-codebase.md and execute it step-by-step.
 4. Translate each Task(...) in workflow into:
@@ -41,10 +43,10 @@ node .claude/get-shit-done/bin/gsd-tools.js init map-codebase --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 .claude/get-shit-done/bin/gsd-tools.js 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 and next recommended command.
-
-
+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-new-milestone.md

@@ -12,8 +12,11 @@ Start a new milestone cycle — update PROJECT.md and route to requirements
 - 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/...).
-- Run engine commands through PowerShell: 
-node .claude/get-shit-done/bin/gsd-tools.js ...
+- 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.
 
@@ -24,16 +27,15 @@ node .claude/get-shit-done/bin/gsd-tools.js ...
 - Use `.claude/agents/gsd-*.md` as role context for each spawned agent.
 - Do not advance workflow steps until wait and close complete.
 ## Update check
-- Run:
-  $update = node .claude/get-shit-done/bin/gsd-tools.cjs update check --raw | ConvertFrom-Json
-- If $update.update_available is true, surface:
-  "Update available: $($update.installed) -> $($update.latest). Run /gsd:update or re-run npx gsd-codex-cli@latest."
-
+- 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 "[milestone name, for example v1.1 Notifications]" from the user input.
 2. Run init:
-node .claude/get-shit-done/bin/gsd-tools.js init new-milestone --raw
+node <gsd-tools-path> init new-milestone --raw
 
 3. Load .claude/get-shit-done/workflows/new-milestone.md and execute it step-by-step.
 4. Translate each Task(...) in workflow into:
@@ -41,10 +43,10 @@ node .claude/get-shit-done/bin/gsd-tools.js init new-milestone --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 .claude/get-shit-done/bin/gsd-tools.js 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 and next recommended command.
-
-
+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-new-project.md

@@ -12,8 +12,11 @@ Initialize a new project with deep context gathering and PROJECT.md
 - 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/...).
-- Run engine commands through PowerShell: 
-node .claude/get-shit-done/bin/gsd-tools.js ...
+- 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.
 
@@ -24,16 +27,15 @@ node .claude/get-shit-done/bin/gsd-tools.js ...
 - Use `.claude/agents/gsd-*.md` as role context for each spawned agent.
 - Do not advance workflow steps until wait and close complete.
 ## Update check
-- Run:
-  $update = node .claude/get-shit-done/bin/gsd-tools.cjs update check --raw | ConvertFrom-Json
-- If $update.update_available is true, surface:
-  "Update available: $($update.installed) -> $($update.latest). Run /gsd:update or re-run npx gsd-codex-cli@latest."
-
+- 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 "[--auto]" from the user input.
 2. Run init:
-node .claude/get-shit-done/bin/gsd-tools.js init new-project --raw
+node <gsd-tools-path> init new-project --raw
 
 3. Load .claude/get-shit-done/workflows/new-project.md and execute it step-by-step.
 4. Translate each Task(...) in workflow into:
@@ -41,10 +43,10 @@ node .claude/get-shit-done/bin/gsd-tools.js init new-project --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 .claude/get-shit-done/bin/gsd-tools.js 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 and next recommended command.
-
-
+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-discuss-phase 1` (Codex) / `/gsd:discuss-phase 1` (Claude)
+- Never recommend internal `node ... gsd-tools ...` commands to the user.

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

@@ -12,8 +12,11 @@ Create context handoff when pausing work mid-phase
 - 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/...).
-- Run engine commands through PowerShell: 
-node .claude/get-shit-done/bin/gsd-tools.js ...
+- 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.
 
@@ -24,16 +27,15 @@ node .claude/get-shit-done/bin/gsd-tools.js ...
 - Use `.claude/agents/gsd-*.md` as role context for each spawned agent.
 - Do not advance workflow steps until wait and close complete.
 ## Update check
-- Run:
-  $update = node .claude/get-shit-done/bin/gsd-tools.cjs update check --raw | ConvertFrom-Json
-- If $update.update_available is true, surface:
-  "Update available: $($update.installed) -> $($update.latest). Run /gsd:update or re-run npx gsd-codex-cli@latest."
-
+- 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 .claude/get-shit-done/bin/gsd-tools.js state load --raw
+node <gsd-tools-path> state load --raw
 
 3. Load .claude/get-shit-done/workflows/pause-work.md and execute it step-by-step.
 4. Translate each Task(...) in workflow into:
@@ -41,10 +43,10 @@ node .claude/get-shit-done/bin/gsd-tools.js 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 .claude/get-shit-done/bin/gsd-tools.js 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 and next recommended command.
-
-
+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-milestone-gaps.md

@@ -12,8 +12,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/...).
-- Run engine commands through PowerShell: 
-node .claude/get-shit-done/bin/gsd-tools.js ...
+- 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.
 
@@ -24,16 +27,15 @@ node .claude/get-shit-done/bin/gsd-tools.js ...
 - Use `.claude/agents/gsd-*.md` as role context for each spawned agent.
 - Do not advance workflow steps until wait and close complete.
 ## Update check
-- Run:
-  $update = node .claude/get-shit-done/bin/gsd-tools.cjs update check --raw | ConvertFrom-Json
-- If $update.update_available is true, surface:
-  "Update available: $($update.installed) -> $($update.latest). Run /gsd:update or re-run npx gsd-codex-cli@latest."
-
+- 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 .claude/get-shit-done/bin/gsd-tools.js 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:
@@ -41,10 +43,10 @@ node .claude/get-shit-done/bin/gsd-tools.js 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 .claude/get-shit-done/bin/gsd-tools.js 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 and next recommended command.
-
-
+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

@@ -12,8 +12,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/...).
-- Run engine commands through PowerShell: 
-node .claude/get-shit-done/bin/gsd-tools.js ...
+- 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.
 
@@ -24,16 +27,15 @@ node .claude/get-shit-done/bin/gsd-tools.js ...
 - Use `.claude/agents/gsd-*.md` as role context for each spawned agent.
 - Do not advance workflow steps until wait and close complete.
 ## Update check
-- Run:
-  $update = node .claude/get-shit-done/bin/gsd-tools.cjs update check --raw | ConvertFrom-Json
-- If $update.update_available is true, surface:
-  "Update available: $($update.installed) -> $($update.latest). Run /gsd:update or re-run npx gsd-codex-cli@latest."
-
+- 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 .claude/get-shit-done/bin/gsd-tools.js 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:
@@ -41,10 +43,10 @@ node .claude/get-shit-done/bin/gsd-tools.js init plan-phase $PHASE --include sta
    - 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 .claude/get-shit-done/bin/gsd-tools.js 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 and next recommended command.
-
-
+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

@@ -12,8 +12,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/...).
-- Run engine commands through PowerShell: 
-node .claude/get-shit-done/bin/gsd-tools.js ...
+- 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.
 
@@ -24,16 +27,15 @@ node .claude/get-shit-done/bin/gsd-tools.js ...
 - Use `.claude/agents/gsd-*.md` as role context for each spawned agent.
 - Do not advance workflow steps until wait and close complete.
 ## Update check
-- Run:
-  $update = node .claude/get-shit-done/bin/gsd-tools.cjs update check --raw | ConvertFrom-Json
-- If $update.update_available is true, surface:
-  "Update available: $($update.installed) -> $($update.latest). Run /gsd:update or re-run npx gsd-codex-cli@latest."
-
+- 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 .claude/get-shit-done/bin/gsd-tools.js 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:
@@ -41,10 +43,10 @@ node .claude/get-shit-done/bin/gsd-tools.js init progress --include state,roadma
    - 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 .claude/get-shit-done/bin/gsd-tools.js 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 and next recommended command.
-
-
+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

@@ -12,8 +12,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/...).
-- Run engine commands through PowerShell: 
-node .claude/get-shit-done/bin/gsd-tools.js ...
+- 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.
 
@@ -24,16 +27,15 @@ node .claude/get-shit-done/bin/gsd-tools.js ...
 - Use `.claude/agents/gsd-*.md` as role context for each spawned agent.
 - Do not advance workflow steps until wait and close complete.
 ## Update check
-- Run:
-  $update = node .claude/get-shit-done/bin/gsd-tools.cjs update check --raw | ConvertFrom-Json
-- If $update.update_available is true, surface:
-  "Update available: $($update.installed) -> $($update.latest). Run /gsd:update or re-run npx gsd-codex-cli@latest."
-
+- 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 .claude/get-shit-done/bin/gsd-tools.js 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:
@@ -41,10 +43,10 @@ node .claude/get-shit-done/bin/gsd-tools.js 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 .claude/get-shit-done/bin/gsd-tools.js 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 and next recommended command.
-
-
+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

@@ -12,8 +12,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/...).
-- Run engine commands through PowerShell: 
-node .claude/get-shit-done/bin/gsd-tools.js ...
+- 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.
 
@@ -24,16 +27,15 @@ node .claude/get-shit-done/bin/gsd-tools.js ...
 - Use `.claude/agents/gsd-*.md` as role context for each spawned agent.
 - Do not advance workflow steps until wait and close complete.
 ## Update check
-- Run:
-  $update = node .claude/get-shit-done/bin/gsd-tools.cjs update check --raw | ConvertFrom-Json
-- If $update.update_available is true, surface:
-  "Update available: $($update.installed) -> $($update.latest). Run /gsd:update or re-run npx gsd-codex-cli@latest."
-
+- 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 .claude/get-shit-done/bin/gsd-tools.js 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:
@@ -41,10 +43,10 @@ node .claude/get-shit-done/bin/gsd-tools.js 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 .claude/get-shit-done/bin/gsd-tools.js 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 and next recommended command.
-
-
+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

@@ -12,8 +12,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/...).
-- Run engine commands through PowerShell: 
-node .claude/get-shit-done/bin/gsd-tools.js ...
+- 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.
 
@@ -24,16 +27,15 @@ node .claude/get-shit-done/bin/gsd-tools.js ...
 - Use `.claude/agents/gsd-*.md` as role context for each spawned agent.
 - Do not advance workflow steps until wait and close complete.
 ## Update check
-- Run:
-  $update = node .claude/get-shit-done/bin/gsd-tools.cjs update check --raw | ConvertFrom-Json
-- If $update.update_available is true, surface:
-  "Update available: $($update.installed) -> $($update.latest). Run /gsd:update or re-run npx gsd-codex-cli@latest."
-
+- 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 .claude/get-shit-done/bin/gsd-tools.js 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:
@@ -41,10 +43,10 @@ node .claude/get-shit-done/bin/gsd-tools.js 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 .claude/get-shit-done/bin/gsd-tools.js 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 and next recommended command.
-
-
+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.