gsd-codex-cli 1.20.11 → 1.20.13

package/.codex/agents/gsd-codebase-mapper.toml

@@ -0,0 +1,2 @@
+model = "gpt-5.1-codex-mini"
+model_reasoning_effort = "high"

package/.codex/agents/gsd-debugger.toml

@@ -0,0 +1,2 @@
+model = "gpt-5.3-spark"
+model_reasoning_effort = "xhigh"

package/.codex/agents/gsd-executor.toml

@@ -0,0 +1,2 @@
+model = "gpt-5.3-spark"
+model_reasoning_effort = "xhigh"

package/.codex/agents/gsd-integration-checker.toml

@@ -0,0 +1,2 @@
+model = "gpt-5.3-spark"
+model_reasoning_effort = "xhigh"

package/.codex/agents/gsd-phase-researcher.toml

@@ -0,0 +1,2 @@
+model = "gpt-5.3-spark"
+model_reasoning_effort = "xhigh"

package/.codex/agents/gsd-plan-checker.toml

@@ -0,0 +1,2 @@
+model = "gpt-5.3-spark"
+model_reasoning_effort = "xhigh"

package/.codex/agents/gsd-planner.toml

@@ -0,0 +1,2 @@
+model = "gpt-5.3-codex"
+model_reasoning_effort = "xhigh"

package/.codex/agents/gsd-project-researcher.toml

@@ -0,0 +1,2 @@
+model = "gpt-5.3-spark"
+model_reasoning_effort = "xhigh"

package/.codex/agents/gsd-research-synthesizer.toml

@@ -0,0 +1,2 @@
+model = "gpt-5.3-spark"
+model_reasoning_effort = "xhigh"

package/.codex/agents/gsd-roadmapper.toml

@@ -0,0 +1,2 @@
+model = "gpt-5.3-spark"
+model_reasoning_effort = "xhigh"

package/.codex/agents/gsd-verifier.toml

@@ -0,0 +1,2 @@
+model = "gpt-5.3-spark"
+model_reasoning_effort = "xhigh"

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

@@ -38,6 +38,7 @@ node <gsd-tools-path> init phase-op "0" --raw
 3. Load .claude/get-shit-done/workflows/add-phase.md and execute it step-by-step.
 4. Translate each Task(...) in workflow into:
    - spawn_agent with the matching role file context from .claude/agents/.
+   - Set `agent_type` to the matching GSD role (gsd-*).
    - 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 

package/.codex/prompts/gsd-add-todo.md

@@ -38,6 +38,7 @@ node <gsd-tools-path> init todos [argument] --raw
 3. Load .claude/get-shit-done/workflows/add-todo.md and execute it step-by-step.
 4. Translate each Task(...) in workflow into:
    - spawn_agent with the matching role file context from .claude/agents/.
+   - Set `agent_type` to the matching GSD role (gsd-*).
    - 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 

package/.codex/prompts/gsd-audit-milestone.md

@@ -38,6 +38,7 @@ node <gsd-tools-path> init milestone-op --raw
 3. Load .claude/get-shit-done/workflows/audit-milestone.md and execute it step-by-step.
 4. Translate each Task(...) in workflow into:
    - spawn_agent with the matching role file context from .claude/agents/.
+   - Set `agent_type` to the matching GSD role (gsd-*).
    - 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 

package/.codex/prompts/gsd-check-todos.md

@@ -38,6 +38,7 @@ node <gsd-tools-path> init todos [argument] --raw
 3. Load .claude/get-shit-done/workflows/check-todos.md and execute it step-by-step.
 4. Translate each Task(...) in workflow into:
    - spawn_agent with the matching role file context from .claude/agents/.
+   - Set `agent_type` to the matching GSD role (gsd-*).
    - 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 

package/.codex/prompts/gsd-complete-milestone.md

@@ -38,6 +38,7 @@ node <gsd-tools-path> init execute-phase "1" --raw
 3. Load .claude/get-shit-done/workflows/complete-milestone.md and execute it step-by-step.
 4. Translate each Task(...) in workflow into:
    - spawn_agent with the matching role file context from .claude/agents/.
+   - Set `agent_type` to the matching GSD role (gsd-*).
    - 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 

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

@@ -38,6 +38,7 @@ node <gsd-tools-path> state load --raw
 3. Execute the debug flow defined in this command (no separate workflow file exists in the gsd commands set).
 4. Translate each Task(...) in the debug flow into:
    - spawn_agent with the matching role file context from .claude/agents/.
+   - Set `agent_type` to the matching GSD role (gsd-*).
    - 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 

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

@@ -38,6 +38,7 @@ node <gsd-tools-path> init phase-op [argument] --raw
 3. Load .claude/get-shit-done/workflows/discuss-phase.md and execute it step-by-step.
 4. Translate each Task(...) in workflow into:
    - spawn_agent with the matching role file context from .claude/agents/.
+   - Set `agent_type` to the matching GSD role (gsd-*).
    - 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 

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

@@ -24,12 +24,20 @@ Run these checks and then present a compact table: `check | status | details | f
   - `.claude/get-shit-done/VERSION`
   - `~/.claude/get-shit-done/VERSION`
 
-### Engine presence (required for Codex prompts)
-- `.claude/get-shit-done/bin/gsd-tools.cjs` OR `.claude/get-shit-done/bin/gsd-tools.js`
-- If only `gsd-tools.test.js` exists, treat engine as missing/incomplete.
-
-### Project state
-- `.planning/` exists (if missing, user hasn’t initialized a project).
+### Engine presence (required for Codex prompts)
+- `.claude/get-shit-done/bin/gsd-tools.cjs` OR `.claude/get-shit-done/bin/gsd-tools.js`
+- If only `gsd-tools.test.js` exists, treat engine as missing/incomplete.
+
+### Codex agent roles (recommended for model routing)
+- Role registrations exist (first match wins):
+  - `.codex/config.toml` contains `[agents.gsd-planner]`
+  - `~/.codex/config.toml` contains `[agents.gsd-planner]`
+- Role config layers exist (first match wins):
+  - `.codex/agents/gsd-planner.toml`
+  - `~/.codex/agents/gsd-planner.toml`
+
+### Project state
+- `.planning/` exists (if missing, user hasn’t initialized a project).
 
 ## Update check
 - Best-effort only; do not fail if offline.

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

@@ -51,6 +51,7 @@ node <gsd-tools-path> init execute-phase <phase> --raw
 6. Load .claude/get-shit-done/workflows/execute-phase.md and execute it step-by-step.
 7. Translate each Task(...) in workflow into:
    - spawn_agent with the matching role file context from .claude/agents/.
+   - Set `agent_type` to the matching GSD role (gsd-*).
    - wait for each spawned agent and apply returned output before moving forward.
 8. Preserve all gates and routing from upstream workflow.
 9. Preserve commit behavior using

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

@@ -38,6 +38,7 @@ Show available GSD commands and usage guide
 3. Load .claude/get-shit-done/workflows/help.md and execute it step-by-step.
 4. Translate each Task(...) in workflow into:
    - spawn_agent with the matching role file context from .claude/agents/.
+   - Set `agent_type` to the matching GSD role (gsd-*).
    - 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 

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

@@ -38,6 +38,7 @@ node <gsd-tools-path> init phase-op [after-phase] --raw
 3. Load .claude/get-shit-done/workflows/insert-phase.md and execute it step-by-step.
 4. Translate each Task(...) in workflow into:
    - spawn_agent with the matching role file context from .claude/agents/.
+   - Set `agent_type` to the matching GSD role (gsd-*).
    - 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 

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

@@ -38,6 +38,7 @@ 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:
    - spawn_agent with the matching role file context from .claude/agents/.
+   - Set `agent_type` to the matching GSD role (gsd-*).
    - 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 

package/.codex/prompts/gsd-map-codebase.md

@@ -38,6 +38,7 @@ 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:
    - spawn_agent with the matching role file context from .claude/agents/.
+   - Set `agent_type` to the matching GSD role (gsd-*).
    - 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 

package/.codex/prompts/gsd-new-milestone.md

@@ -46,6 +46,7 @@ node <gsd-tools-path> init new-milestone --raw
    Then summarize the chosen direction and ask for confirmation.
 5. Translate each Task(...) in workflow into:
    - spawn_agent with the matching role file context from .claude/agents/.
+   - Set `agent_type` to the matching GSD role (gsd-*).
    - wait for each spawned agent and apply returned output before moving forward.
 6. Preserve all gates and routing from upstream workflow.
 7. Before reporting success, verify `.planning/ROADMAP.md` exists. If missing, treat as blocked and continue workflow remediation.

package/.codex/prompts/gsd-new-project.md

@@ -38,6 +38,7 @@ 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:
    - spawn_agent with the matching role file context from .claude/agents/.
+   - Set `agent_type` to the matching GSD role (gsd-*).
    - 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 

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

@@ -38,6 +38,7 @@ 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:
    - spawn_agent with the matching role file context from .claude/agents/.
+   - Set `agent_type` to the matching GSD role (gsd-*).
    - 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 

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

@@ -38,6 +38,7 @@ 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:
    - spawn_agent with the matching role file context from .claude/agents/.
+   - Set `agent_type` to the matching GSD role (gsd-*).
    - 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 

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

@@ -38,6 +38,7 @@ node <gsd-tools-path> init plan-phase [phase] --include state,roadmap,requiremen
 3. Load .claude/get-shit-done/workflows/plan-phase.md and execute it step-by-step.
 4. Translate each Task(...) in workflow into:
    - spawn_agent with the matching role file context from .claude/agents/.
+   - Set `agent_type` to the matching GSD role (gsd-*).
    - 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 

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

@@ -38,6 +38,7 @@ 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:
    - spawn_agent with the matching role file context from .claude/agents/.
+   - Set `agent_type` to the matching GSD role (gsd-*).
    - 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 

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

@@ -38,6 +38,7 @@ 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:
    - spawn_agent with the matching role file context from .claude/agents/.
+   - Set `agent_type` to the matching GSD role (gsd-*).
    - 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 

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

@@ -38,6 +38,7 @@ 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:
    - spawn_agent with the matching role file context from .claude/agents/.
+   - Set `agent_type` to the matching GSD role (gsd-*).
    - 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 

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

@@ -38,6 +38,7 @@ 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:
    - spawn_agent with the matching role file context from .claude/agents/.
+   - Set `agent_type` to the matching GSD role (gsd-*).
    - 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 

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

@@ -38,6 +38,7 @@ 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:
    - spawn_agent with the matching role file context from .claude/agents/.
+   - Set `agent_type` to the matching GSD role (gsd-*).
    - 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 

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

@@ -38,6 +38,7 @@ 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:
    - spawn_agent with the matching role file context from .claude/agents/.
+   - Set `agent_type` to the matching GSD role (gsd-*).
    - 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 

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

@@ -38,6 +38,7 @@ node <gsd-tools-path> config-ensure-section --raw
 3. Load .claude/get-shit-done/workflows/settings.md and execute it step-by-step.
 4. Translate each Task(...) in workflow into:
    - spawn_agent with the matching role file context from .claude/agents/.
+   - Set `agent_type` to the matching GSD role (gsd-*).
    - 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 

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

@@ -44,6 +44,7 @@ Update GSD to latest version with changelog display
 3. Load .claude/get-shit-done/workflows/update.md and execute it step-by-step.
 4. Translate each Task(...) in workflow into:
    - spawn_agent with the matching role file context from .claude/agents/.
+   - Set `agent_type` to the matching GSD role (gsd-*).
    - 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 

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

@@ -38,6 +38,7 @@ node <gsd-tools-path> init verify-work [phase] --raw
 3. Load .claude/get-shit-done/workflows/verify-work.md and execute it step-by-step.
 4. Translate each Task(...) in workflow into:
    - spawn_agent with the matching role file context from .claude/agents/.
+   - Set `agent_type` to the matching GSD role (gsd-*).
    - 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 

package/.codex/skills/get-shit-done-codex/SKILL.md

@@ -21,20 +21,25 @@ Use this skill to run `gsd-*` prompts under `Codex` while preserving upstream GS
 4. Preserve step ordering and gate behavior from workflow files.
 5. User-facing guidance should recommend `/prompts:gsd-*` prompts (Codex) and `/gsd:*` commands (Claude), not internal `node ... gsd-tools ...` plumbing.
 
-## Mandatory codex translations
-- Replace each `Task(...)` with: `spawn_agent` + `wait`.
-- Replace Bash/JQ patterns with PowerShell and `ConvertFrom-Json`.
-- Replace AskUserQuestion interactions with direct user prompts in chat.
+## Mandatory codex translations
+- Replace each `Task(...)` with: `spawn_agent` + `wait`.
+- Replace Bash/JQ patterns with PowerShell and `ConvertFrom-Json`.
+- Replace AskUserQuestion interactions with direct user prompts in chat.
+- GSD Codex agent roles route models per role via `.codex/agents/gsd-*.toml`:
+  - Opus-tier work uses `gpt-5.3-codex` (`xhigh` reasoning effort)
+  - Sonnet-tier work uses `gpt-5.3-spark` (`xhigh` reasoning effort)
+  - Haiku-tier work uses `gpt-5.1-codex-mini` (`high` reasoning effort)
 
-## Subagent lifecycle (required)
-- Spawn only when the upstream workflow explicitly defines a `Task(...)` role.
-- For each spawned subagent:
-  - Start with `spawn_agent` and provide the role source from `.claude/agents/gsd-*.md`.
-  - Do not set `agent_type` to a GSD role. Codex only accepts `default`, `explorer`, or `worker` (or omit `agent_type`).
-  - Wait for completion before proceeding: `wait`.
-  - Explicitly close the agent after it finishes (`close_agent`) to release resources.
-- Keep prompt-level sequencing intact; do not continue to subsequent steps until waiting + closure are complete.
-- If an agent fails or exceeds retry policy, stop that phase of workflow and surface a clear remediation step.
+## Subagent lifecycle (required)
+- Spawn only when the upstream workflow explicitly defines a `Task(...)` role.
+- For each spawned subagent:
+  - Start with `spawn_agent` and provide the role source from `.claude/agents/gsd-*.md`.
+  - Set `agent_type` to the matching GSD role name (for example: `gsd-planner`, `gsd-executor`).
+  - These roles are registered under `[agents.*]` in `.codex/config.toml` and map to per-role Codex model settings via `.codex/agents/*.toml`.
+  - Wait for completion before proceeding: `wait`.
+  - Explicitly close the agent after it finishes (`close_agent`) to release resources.
+- Keep prompt-level sequencing intact; do not continue to subsequent steps until waiting + closure are complete.
+- If an agent fails or exceeds retry policy, stop that phase of workflow and surface a clear remediation step.
 
 ## Required GSD roles (must map by name)
 - `gsd-project-researcher`

package/.codex/skills/get-shit-done-codex/references/compat.md

@@ -19,7 +19,13 @@
 ## Subagent mapping
 - `subagent_type=gsd-*` maps to equivalent role contract in `.claude/agents/gsd-*.md`.
 - Unspecified `subagent_type` values default to command-context Codex agent behavior.
-- Do not pass `agent_type=gsd-*` to `spawn_agent`. Codex only accepts `default`, `explorer`, or `worker` (or omit `agent_type`).
+- Pass `agent_type=gsd-*` to `spawn_agent` so Codex can apply the matching role config.
+- GSD Codex roles are declared under `[agents.gsd-*]` in `.codex/config.toml`.
+- Each role points to a role config layer in `.codex/agents/gsd-*.toml` (used to route models and other Codex settings per role).
+- GSD model alias mapping (implemented by the default role config layers):
+  - `inherit` (opus tier) -> `gpt-5.3-codex` with `xhigh` reasoning effort
+  - `sonnet` -> `gpt-5.3-spark` with `xhigh` reasoning effort
+  - `haiku` -> `gpt-5.1-codex-mini` with `high` reasoning effort
 
 ## Required GSD subagents
 - `gsd-project-researcher`

package/README.md

@@ -4,11 +4,11 @@ This repository packages the get-shit-done (GSD) workflow for Codex. It installs
 
 Use this fork if you want the GSD workflow inside Codex with a simple installer that works for a single project or your home directory.
 
-## Quick Install
-
-```bash
-npx gsd-codex-cli@latest --path .
-```
+## Quick Install
+
+```bash
+npx gsd-codex-cli@latest --path .
+```
 
 Install globally (prompts available from any project):
 
@@ -22,15 +22,18 @@ You can combine both:
 npx gsd-codex-cli@latest --path . --global
 ```
 
-## What Gets Installed
-
-The installer copies these directories into the target location:
-
-- `.codex/prompts` and `.codex/skills` for Codex commands
-- `.claude/get-shit-done` for workflow references
-- `.claude/agents` for agent definitions
-
-This fork is Codex-first, but the Claude assets are kept alongside for compatibility with the upstream workflow files.
+## What Gets Installed
+
+The installer copies these directories into the target location:
+
+- `.codex/prompts` and `.codex/skills` for Codex commands
+- `.codex/agents` for Codex agent roles (model routing)
+- `.claude/get-shit-done` for workflow references
+- `.claude/agents` for agent definitions
+
+This fork is Codex-first, but the Claude assets are kept alongside for compatibility with the upstream workflow files.
+
+The installer also registers GSD agent roles under `[agents.gsd-*]` in your Codex config (`.codex/config.toml` for local installs and `~/.codex/config.toml` for global installs). It only appends missing sections.
 
 ## Using the Prompts
 
@@ -50,13 +53,21 @@ Re-run the installer to update your local or global install. It overwrites the e
 npx gsd-codex-cli@latest --path . --global
 ```
 
-## CLI Options
-
-```
---path <dir>   Install into a specific directory (defaults to current directory)
---global       Also install to your home directory (~/.codex and ~/.claude)
---help         Show help
-```
+## CLI Options
+
+```
+--path <target-dir>   Install into this directory (defaults to current directory)
+--global              Also install to your home directory
+--help                Show help
+```
+
+## Examples
+
+```bash
+npx gsd-codex-cli@latest --path .
+npx gsd-codex-cli@latest --global
+npx gsd-codex-cli@latest --path . --global
+```
 
 ## Development
 

package/bin/install-codex.js

@@ -1,23 +1,37 @@
 #!/usr/bin/env node
 
-const fs = require('fs');
-const path = require('path');
-const os = require('os');
-
-const args = process.argv.slice(2);
-const pkg = require('../package.json');
-const repoRoot = path.resolve(__dirname, '..');
-
-const helpText = `
-${pkg.name} v${pkg.version}
-
-Usage:
-  ${pkg.name} [--path <target-dir>] [--help]
-
-Options:
-  --path <target-dir>   Install into this directory (defaults to current directory)
-  --global              Also install .claude to your home directory (for manual sharing)
-  --help, -h            Show this help message
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const args = process.argv.slice(2);
+const pkg = require('../package.json');
+const repoRoot = path.resolve(__dirname, '..');
+
+const GSD_AGENT_ROLES = [
+  { name: 'gsd-project-researcher', description: 'GSD role: project researcher.' },
+  { name: 'gsd-research-synthesizer', description: 'GSD role: research synthesizer.' },
+  { name: 'gsd-roadmapper', description: 'GSD role: roadmap planning.' },
+  { name: 'gsd-phase-researcher', description: 'GSD role: phase research.' },
+  { name: 'gsd-planner', description: 'GSD role: phase planning.' },
+  { name: 'gsd-plan-checker', description: 'GSD role: plan verification.' },
+  { name: 'gsd-executor', description: 'GSD role: plan execution.' },
+  { name: 'gsd-verifier', description: 'GSD role: execution verification.' },
+  { name: 'gsd-debugger', description: 'GSD role: debugging.' },
+  { name: 'gsd-integration-checker', description: 'GSD role: integration verification.' },
+  { name: 'gsd-codebase-mapper', description: 'GSD role: codebase mapping.' },
+];
+
+const helpText = `
+${pkg.name} v${pkg.version}
+
+Usage:
+  ${pkg.name} [--path <target-dir>] [--global] [--help]
+
+Options:
+  --path <target-dir>   Install into this directory (defaults to current directory)
+  --global              Also install .claude to your home directory (for manual sharing)
+  --help, -h            Show this help message
 
 Examples:
   npx gsd-codex-cli@latest --path .
@@ -43,21 +57,57 @@ if (pathArgIndex !== -1) {
   targetDir = path.resolve(process.cwd(), userPath);
 }
 
-const installGlobal = args.includes('--global');
+const installGlobal = args.includes('--global');
 
 function copyRecursive(source, destination) {
   if (!fs.existsSync(source)) return;
   fs.cpSync(source, destination, { recursive: true, force: true });
 }
 
-function ensureDir(dirPath) {
-  fs.mkdirSync(dirPath, { recursive: true });
-}
-
-function resolveSourceDir(repoRelative, fallbackRelative) {
-  const primary = path.join(repoRoot, repoRelative);
-  const fallback = fallbackRelative ? path.join(repoRoot, fallbackRelative) : null;
-
+function ensureDir(dirPath) {
+  fs.mkdirSync(dirPath, { recursive: true });
+}
+
+function escapeRegExp(value) {
+  // Escape special regex characters.
+  return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+
+function ensureCodexConfigHasGsdAgentRoles(codexDir) {
+  const configPath = path.join(codexDir, 'config.toml');
+  const existing = fs.existsSync(configPath) ? fs.readFileSync(configPath, 'utf8') : '';
+  const eol = existing.includes('\r\n') ? '\r\n' : '\n';
+
+  const blocks = [];
+  for (const role of GSD_AGENT_ROLES) {
+    const header = `[agents.${role.name}]`;
+    const headerRegex = new RegExp(`^\\s*\\[agents\\.${escapeRegExp(role.name)}\\]\\s*$`, 'm');
+    if (headerRegex.test(existing)) continue;
+
+    blocks.push([
+      header,
+      `description = "${role.description}"`,
+      `config_file = "./agents/${role.name}.toml"`,
+    ].join(eol));
+  }
+
+  if (blocks.length === 0) {
+    return { changed: false, added_roles: [] };
+  }
+
+  let next = existing;
+  if (next.length > 0 && !next.endsWith(eol)) next += eol;
+  if (next.length > 0 && !next.endsWith(eol + eol)) next += eol;
+  next += blocks.join(eol + eol) + eol;
+
+  fs.writeFileSync(configPath, next, 'utf8');
+  return { changed: true, added_roles: blocks.map(b => b.split(eol, 1)[0]) };
+}
+
+function resolveSourceDir(repoRelative, fallbackRelative) {
+  const primary = path.join(repoRoot, repoRelative);
+  const fallback = fallbackRelative ? path.join(repoRoot, fallbackRelative) : null;
+
   if (fs.existsSync(primary)) return primary;
   if (fallback && fs.existsSync(fallback)) return fallback;
 
@@ -65,10 +115,10 @@ function resolveSourceDir(repoRelative, fallbackRelative) {
   throw new Error(`Missing source directory "${repoRelative}"${fallbackMessage} in repository root ${repoRoot}`);
 }
 
-function copyCodexToDirectory(baseDir) {
-  const targetCodex = path.join(baseDir, '.codex');
-  const targetClaude = path.join(baseDir, '.claude');
-  const sourceCodex = path.join(repoRoot, '.codex');
+function copyCodexToDirectory(baseDir) {
+  const targetCodex = path.join(baseDir, '.codex');
+  const targetClaude = path.join(baseDir, '.claude');
+  const sourceCodex = path.join(repoRoot, '.codex');
   const sourceGetShitDone = resolveSourceDir('get-shit-done', '.claude/get-shit-done');
   const sourceAgents = resolveSourceDir('agents', '.claude/agents');
   const versionDest = path.join(targetClaude, 'get-shit-done', 'VERSION');
@@ -77,31 +127,39 @@ function copyCodexToDirectory(baseDir) {
   ensureDir(baseDir);
   ensureDir(targetCodex);
   ensureDir(targetClaude);
-
-  copyRecursive(sourceCodex, targetCodex);
-  copyRecursive(sourceGetShitDone, path.join(targetClaude, 'get-shit-done'));
-  copyRecursive(sourceAgents, path.join(targetClaude, 'agents'));
-  ensureDir(path.dirname(versionDest));
-  fs.writeFileSync(versionDest, `${pkg.version}\n`);
-  ensureDir(path.dirname(codexVersionDest));
-  fs.writeFileSync(codexVersionDest, `${pkg.version}\n`);
-}
-
-copyCodexToDirectory(targetDir);
-
-if (installGlobal) {
-  // Global installs should place prompts at ~/.codex/prompts (not ~/.codex/.codex/prompts).
-  const globalBase = os.homedir();
-  copyCodexToDirectory(globalBase);
+
+  copyRecursive(sourceCodex, targetCodex);
+  copyRecursive(sourceGetShitDone, path.join(targetClaude, 'get-shit-done'));
+  copyRecursive(sourceAgents, path.join(targetClaude, 'agents'));
+  ensureCodexConfigHasGsdAgentRoles(targetCodex);
+  ensureDir(path.dirname(versionDest));
+  fs.writeFileSync(versionDest, `${pkg.version}\n`);
+  ensureDir(path.dirname(codexVersionDest));
+  fs.writeFileSync(codexVersionDest, `${pkg.version}\n`);
 }
 
-console.log(`\n${pkg.name}@${pkg.version} installed to:`);
-console.log(`  local: ${targetDir}`);
-if (installGlobal) {
-  console.log('  global: ~/.codex');
-}
-console.log('\nNext steps:');
-console.log('  1) Open your project in Codex');
-console.log('  2) Run /prompts:gsd-new-project, then /prompts:gsd-discuss-phase, /prompts:gsd-plan-phase, /prompts:gsd-execute-phase');
-console.log('  3) If something looks off, run /prompts:gsd-doctor');
-console.log('  4) Use .codex/prompts/* for all GSD commands in this fork');
+async function main() {
+  copyCodexToDirectory(targetDir);
+
+  if (installGlobal) {
+    // Global installs should place prompts at ~/.codex/prompts (not ~/.codex/.codex/prompts).
+    const globalBase = os.homedir();
+    copyCodexToDirectory(globalBase);
+  }
+
+  console.log(`\n${pkg.name}@${pkg.version} installed to:`);
+  console.log(`  local: ${targetDir}`);
+  if (installGlobal) {
+    console.log('  global: ~/.codex');
+  }
+  console.log('\nNext steps:');
+  console.log('  1) Open your project in Codex');
+  console.log('  2) Run /prompts:gsd-new-project, then /prompts:gsd-discuss-phase, /prompts:gsd-plan-phase, /prompts:gsd-execute-phase');
+  console.log('  3) If something looks off, run /prompts:gsd-doctor');
+  console.log('  4) Use .codex/prompts/* for all GSD commands in this fork');
+}
+
+main().catch((error) => {
+  console.error(error instanceof Error ? error.message : error);
+  process.exit(1);
+});

package/get-shit-done/bin/gsd-tools.cjs

@@ -129,29 +129,55 @@ const { execSync } = require('child_process');
 
 // ─── Model Profile Table ─────────────────────────────────────────────────────
 
-const MODEL_PROFILES = {
-  'gsd-planner':              { quality: 'opus', balanced: 'opus',   budget: 'sonnet' },
-  'gsd-roadmapper':           { quality: 'opus', balanced: 'sonnet', budget: 'sonnet' },
-  'gsd-executor':             { quality: 'opus', balanced: 'sonnet', budget: 'sonnet' },
+const MODEL_PROFILES = {
+  'gsd-planner':              { quality: 'opus', balanced: 'opus',   budget: 'sonnet' },
+  'gsd-roadmapper':           { quality: 'opus', balanced: 'sonnet', budget: 'sonnet' },
+  'gsd-executor':             { quality: 'opus', balanced: 'sonnet', budget: 'sonnet' },
   'gsd-phase-researcher':     { quality: 'opus', balanced: 'sonnet', budget: 'haiku' },
   'gsd-project-researcher':   { quality: 'opus', balanced: 'sonnet', budget: 'haiku' },
   'gsd-research-synthesizer': { quality: 'sonnet', balanced: 'sonnet', budget: 'haiku' },
   'gsd-debugger':             { quality: 'opus', balanced: 'sonnet', budget: 'sonnet' },
   'gsd-codebase-mapper':      { quality: 'sonnet', balanced: 'haiku', budget: 'haiku' },
   'gsd-verifier':             { quality: 'sonnet', balanced: 'sonnet', budget: 'haiku' },
-  'gsd-plan-checker':         { quality: 'sonnet', balanced: 'sonnet', budget: 'haiku' },
-  'gsd-integration-checker':  { quality: 'sonnet', balanced: 'sonnet', budget: 'haiku' },
-};
+  'gsd-plan-checker':         { quality: 'sonnet', balanced: 'sonnet', budget: 'haiku' },
+  'gsd-integration-checker':  { quality: 'sonnet', balanced: 'sonnet', budget: 'haiku' },
+};
+
+const CODEX_MODEL_MAP = {
+  // Opus-tier aliases resolve to `inherit` in GSD, then map to Codex 5.3 at xhigh effort.
+  inherit: { model: 'gpt-5.3-codex', reasoning_effort: 'xhigh' },
+  // Sonnet-tier aliases map to Spark 5.3 at xhigh effort.
+  sonnet: { model: 'gpt-5.3-spark', reasoning_effort: 'xhigh' },
+  // Haiku-tier aliases map to codex-mini at high effort.
+  haiku: { model: 'gpt-5.1-codex-mini', reasoning_effort: 'high' },
+};
 
 // ─── Helpers ──────────────────────────────────────────────────────────────────
 
-function parseIncludeFlag(args) {
+function parseIncludeFlag(args) {
   const includeIndex = args.indexOf('--include');
   if (includeIndex === -1) return new Set();
   const includeValue = args[includeIndex + 1];
   if (!includeValue) return new Set();
   return new Set(includeValue.split(',').map(s => s.trim()));
-}
+}
+
+function codexModelSpecFromAlias(alias) {
+  if (!alias) return null;
+  const normalized = String(alias).toLowerCase() === 'opus' ? 'inherit' : String(alias).toLowerCase();
+  return CODEX_MODEL_MAP[normalized] || null;
+}
+
+function withCodexModelHints(result) {
+  for (const [key, value] of Object.entries(result)) {
+    if (!key.endsWith('_model') || typeof value !== 'string') continue;
+    const spec = codexModelSpecFromAlias(value);
+    if (!spec) continue;
+    result[`${key}_codex`] = spec.model;
+    result[`${key}_reasoning_effort`] = spec.reasoning_effort;
+  }
+  return result;
+}
 
 function safeReadFile(filePath) {
   try {
@@ -1472,7 +1498,7 @@ function cmdStateRecordSession(cwd, options, raw) {
   }
 }
 
-function cmdResolveModel(cwd, agentType, raw) {
+function cmdResolveModel(cwd, agentType, raw) {
   if (!agentType) {
     error('agent-type required');
   }
@@ -1480,18 +1506,31 @@ function cmdResolveModel(cwd, agentType, raw) {
   const config = loadConfig(cwd);
   const profile = config.model_profile || 'balanced';
 
-  const agentModels = MODEL_PROFILES[agentType];
-  if (!agentModels) {
-    const result = { model: 'sonnet', profile, unknown_agent: true };
-    output(result, raw, 'sonnet');
-    return;
-  }
-
-  const resolved = agentModels[profile] || agentModels['balanced'] || 'sonnet';
-  const model = resolved === 'opus' ? 'inherit' : resolved;
-  const result = { model, profile };
-  output(result, raw, model);
-}
+  const agentModels = MODEL_PROFILES[agentType];
+  if (!agentModels) {
+    const codexSpec = codexModelSpecFromAlias('sonnet');
+    const result = {
+      model: 'sonnet',
+      profile,
+      unknown_agent: true,
+      codex_model: codexSpec?.model || null,
+      codex_reasoning_effort: codexSpec?.reasoning_effort || null,
+    };
+    output(result, raw, 'sonnet');
+    return;
+  }
+
+  const resolved = agentModels[profile] || agentModels['balanced'] || 'sonnet';
+  const model = resolved === 'opus' ? 'inherit' : resolved;
+  const codexSpec = codexModelSpecFromAlias(model);
+  const result = {
+    model,
+    profile,
+    codex_model: codexSpec?.model || null,
+    codex_reasoning_effort: codexSpec?.reasoning_effort || null,
+  };
+  output(result, raw, model);
+}
 
 function cmdFindPhase(cwd, phase, raw) {
   if (!phase) {
@@ -1998,8 +2037,9 @@ function cmdPhasePlanIndex(cwd, phase, raw) {
     has_checkpoints: hasCheckpoints,
   };
 
-  output(result, raw);
-}
+  withCodexModelHints(result);
+  output(result, raw);
+}
 
 function cmdStateSnapshot(cwd, raw) {
   const statePath = path.join(cwd, '.planning', 'STATE.md');
@@ -2099,8 +2139,9 @@ function cmdStateSnapshot(cwd, raw) {
     session,
   };
 
-  output(result, raw);
-}
+  withCodexModelHints(result);
+  output(result, raw);
+}
 
 function cmdSummaryExtract(cwd, summaryPath, fields, raw) {
   if (!summaryPath) {
@@ -2703,8 +2744,9 @@ function cmdRoadmapAnalyze(cwd, raw) {
     missing_phase_details: missingDetails.length > 0 ? missingDetails : null,
   };
 
-  output(result, raw);
-}
+  withCodexModelHints(result);
+  output(result, raw);
+}
 
 // ─── Phase Add ────────────────────────────────────────────────────────────────
 
@@ -3118,8 +3160,9 @@ function cmdPhaseRemove(cwd, targetPhase, options, raw) {
     state_updated: fs.existsSync(statePath),
   };
 
-  output(result, raw);
-}
+  withCodexModelHints(result);
+  output(result, raw);
+}
 
 // ─── Roadmap Update Plan Progress ────────────────────────────────────────────
 
@@ -3365,8 +3408,9 @@ function cmdPhaseComplete(cwd, phaseNum, raw) {
     state_updated: fs.existsSync(statePath),
   };
 
-  output(result, raw);
-}
+  withCodexModelHints(result);
+  output(result, raw);
+}
 
 // ─── Milestone Complete ───────────────────────────────────────────────────────
 
@@ -3502,8 +3546,9 @@ function cmdMilestoneComplete(cwd, version, options, raw) {
     state_updated: fs.existsSync(statePath),
   };
 
-  output(result, raw);
-}
+  withCodexModelHints(result);
+  output(result, raw);
+}
 
 // ─── Validate Consistency ─────────────────────────────────────────────────────
 
@@ -4299,8 +4344,9 @@ function cmdInitExecutePhase(cwd, phase, includes, raw) {
     result.roadmap_content = safeReadFile(path.join(cwd, '.planning', 'ROADMAP.md'));
   }
 
-  output(result, raw);
-}
+  withCodexModelHints(result);
+  output(result, raw);
+}
 
 function cmdInitPlanPhase(cwd, phase, includes, raw) {
   if (!phase) {
@@ -4395,10 +4441,11 @@ function cmdInitPlanPhase(cwd, phase, includes, raw) {
     } catch {}
   }
 
-  output(result, raw);
-}
+  withCodexModelHints(result);
+  output(result, raw);
+}
 
-function cmdInitNewProject(cwd, raw) {
+function cmdInitNewProject(cwd, raw) {
   const config = loadConfig(cwd);
 
   // Detect Brave Search API key availability
@@ -4451,10 +4498,11 @@ function cmdInitNewProject(cwd, raw) {
     brave_search_available: hasBraveSearch,
   };
 
-  output(result, raw);
-}
+  withCodexModelHints(result);
+  output(result, raw);
+}
 
-function cmdInitNewMilestone(cwd, raw) {
+function cmdInitNewMilestone(cwd, raw) {
   const config = loadConfig(cwd);
   const milestone = getMilestoneInfo(cwd);
 
@@ -4478,10 +4526,11 @@ function cmdInitNewMilestone(cwd, raw) {
     state_exists: pathExistsInternal(cwd, '.planning/STATE.md'),
   };
 
-  output(result, raw);
-}
+  withCodexModelHints(result);
+  output(result, raw);
+}
 
-function cmdInitQuick(cwd, description, raw) {
+function cmdInitQuick(cwd, description, raw) {
   const config = loadConfig(cwd);
   const now = new Date();
   const slug = description ? generateSlugInternal(description)?.substring(0, 40) : null;
@@ -4527,8 +4576,9 @@ function cmdInitQuick(cwd, description, raw) {
     planning_exists: pathExistsInternal(cwd, '.planning'),
   };
 
-  output(result, raw);
-}
+  withCodexModelHints(result);
+  output(result, raw);
+}
 
 function cmdInitResume(cwd, raw) {
   const config = loadConfig(cwd);
@@ -4557,7 +4607,7 @@ function cmdInitResume(cwd, raw) {
   output(result, raw);
 }
 
-function cmdInitVerifyWork(cwd, phase, raw) {
+function cmdInitVerifyWork(cwd, phase, raw) {
   if (!phase) {
     error('phase required for init verify-work');
   }
@@ -4583,8 +4633,9 @@ function cmdInitVerifyWork(cwd, phase, raw) {
     has_verification: phaseInfo?.has_verification || false,
   };
 
-  output(result, raw);
-}
+  withCodexModelHints(result);
+  output(result, raw);
+}
 
 function cmdInitPhaseOp(cwd, phase, raw) {
   const config = loadConfig(cwd);
@@ -4759,7 +4810,7 @@ function cmdInitMilestoneOp(cwd, raw) {
   output(result, raw);
 }
 
-function cmdInitMapCodebase(cwd, raw) {
+function cmdInitMapCodebase(cwd, raw) {
   const config = loadConfig(cwd);
 
   // Check for existing codebase maps
@@ -4790,10 +4841,11 @@ function cmdInitMapCodebase(cwd, raw) {
     codebase_dir_exists: pathExistsInternal(cwd, '.planning/codebase'),
   };
 
-  output(result, raw);
-}
+  withCodexModelHints(result);
+  output(result, raw);
+}
 
-function cmdInitProgress(cwd, includes, raw) {
+function cmdInitProgress(cwd, includes, raw) {
   const config = loadConfig(cwd);
   const milestone = getMilestoneInfo(cwd);
 
@@ -4897,8 +4949,9 @@ function cmdInitProgress(cwd, includes, raw) {
     result.config_content = safeReadFile(path.join(cwd, '.planning', 'config.json'));
   }
 
-  output(result, raw);
-}
+  withCodexModelHints(result);
+  output(result, raw);
+}
 
 // ─── CLI Router ───────────────────────────────────────────────────────────────
 

package/get-shit-done/references/model-profile-resolution.md

@@ -24,11 +24,22 @@ Task(
 )
 ```
 
-**Note:** Opus-tier agents resolve to `"inherit"` (not `"opus"`). This causes the agent to use the parent session's model, avoiding conflicts with organization policies that may block specific opus versions.
+**Note:** Opus-tier agents resolve to `"inherit"` (not `"opus"`). This causes the agent to use the parent session's model, avoiding conflicts with organization policies that may block specific opus versions.
+
+## Codex alias mapping
+
+When running under Codex, map the resolved aliases to concrete Codex models:
+
+| Alias | Codex model | Reasoning effort |
+|-------|-------------|------------------|
+| `inherit` (`opus` tier) | `gpt-5.3-codex` | `xhigh` |
+| `sonnet` | `gpt-5.3-spark` | `xhigh` |
+| `haiku` | `gpt-5.1-codex-mini` | `high` |
 
 ## Usage
 
 1. Resolve once at orchestration start
 2. Store the profile value
 3. Look up each agent's model from the table when spawning
-4. Pass model parameter to each Task call (values: `"inherit"`, `"sonnet"`, `"haiku"`)
+4. Pass model parameter to each Task call (values: `"inherit"`, `"sonnet"`, `"haiku"`)
+5. In Codex mode, translate those aliases with the table above before spawning subagents

package/package.json

@@ -1,25 +1,26 @@
 {
-  "name": "gsd-codex-cli",
-  "version": "1.20.11",
+  "name": "gsd-codex-cli",
+  "version": "1.20.13",
   "description": "Codex-native package for the get-shit-done workflow with native subagent orchestration.",
   "bin": {
     "gsd-codex-cli": "bin/install-codex.js",
     "get-shit-done-codex": "bin/install-codex.js",
     "get-shit-done-cc": "bin/install.js"
   },
-  "files": [
-    "bin",
-    ".codex",
-    "commands",
-    "get-shit-done",
-    "agents",
-    "hooks/dist",
-    "scripts",
-    "README.md",
-    "LICENSE",
-    "CHANGELOG.md",
-    "!**/*.bak"
-  ],
+  "files": [
+    "bin",
+    ".codex",
+    "commands",
+    "get-shit-done",
+    "agents",
+    "hooks/dist",
+    "scripts",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md",
+    "!**/*.bak",
+    "!.codex/gsd/**"
+  ],
   "keywords": [
     "codex",
     "claude",