gsd-codex-cli 1.20.12 → 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

@@ -25,20 +25,21 @@ Use this skill to run `gsd-*` prompts under `Codex` while preserving upstream GS
 - 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.
-- Translate resolved model aliases before Codex subagent spawn:
-  - `inherit` (opus tier) -> `gpt-5.3-codex` (`xhigh`)
-  - `sonnet` -> `gpt-5.3-spark` (`xhigh`)
-  - `haiku` -> `gpt-5.1-codex-mini` (`high`)
+- 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,8 +19,10 @@
 ## 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`).
-- Translate GSD model aliases to Codex models when spawning:
+- 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

package/README.md

@@ -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
 

package/bin/install-codex.js

@@ -4,13 +4,27 @@ 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}
-
+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]
 
@@ -53,11 +67,47 @@ function copyRecursive(source, destination) {
 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 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,14 +127,15 @@ 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`);
+
+  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`);
 }
 
 async function main() {

package/package.json

@@ -1,25 +1,26 @@
 {
-  "name": "gsd-codex-cli",
-  "version": "1.20.12",
+  "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",