Skip to main content

codex

Provides a CLI wrapper for OpenAI Codex with modes for code review, challenge, and consultation, enhancing coding efficiency.

Install this skill

or
0/100

Security score

The codex skill was audited on Jun 10, 2026 and we found 102 security issues across 3 threat categories, including 1 high-severity. Review the findings below before installing.

Categories Tested

Security Issues

medium line 34

Template literal with variable interpolation in command context

SourceSKILL.md
34```bash
medium line 284

Template literal with variable interpolation in command context

SourceSKILL.md
284```bash
medium line 419

Template literal with variable interpolation in command context

SourceSKILL.md
419```bash
medium line 453

Template literal with variable interpolation in command context

SourceSKILL.md
453echo "before relying on \`gbrain search\` for code questions in this worktree."
medium line 581

Template literal with variable interpolation in command context

SourceSKILL.md
581```bash
high line 851

Template literal with variable interpolation in command context

SourceSKILL.md
851set, or `${CODEX_HOME:-~/.codex}/auth.json` exists. Avoids false-negatives for
medium line 1218

Template literal with variable interpolation in command context

SourceSKILL.md
1218```bash
medium line 1375

Template literal with variable interpolation in command context

SourceSKILL.md
1375```bash
medium line 1428

Template literal with variable interpolation in command context

SourceSKILL.md
1428```bash
low line 35

Access to hidden dotfiles in home directory

SourceSKILL.md
35_UPD=$(~/.claude/skills/gstack/bin/gstack-update-check 2>/dev/null || .claude/skills/gstack/bin/gstack-update-check 2>/dev/null || true)
low line 37

Access to hidden dotfiles in home directory

SourceSKILL.md
37mkdir -p ~/.gstack/sessions
low line 38

Access to hidden dotfiles in home directory

SourceSKILL.md
38touch ~/.gstack/sessions/"$PPID"
low line 39

Access to hidden dotfiles in home directory

SourceSKILL.md
39_SESSIONS=$(find ~/.gstack/sessions -mmin -120 -type f 2>/dev/null | wc -l | tr -d ' ')
low line 40

Access to hidden dotfiles in home directory

SourceSKILL.md
40find ~/.gstack/sessions -mmin +120 -type f -exec rm {} + 2>/dev/null || true
low line 41

Access to hidden dotfiles in home directory

SourceSKILL.md
41_PROACTIVE=$(~/.claude/skills/gstack/bin/gstack-config get proactive 2>/dev/null || echo "true")
low line 42

Access to hidden dotfiles in home directory

SourceSKILL.md
42_PROACTIVE_PROMPTED=$([ -f ~/.gstack/.proactive-prompted ] && echo "yes" || echo "no")
low line 45

Access to hidden dotfiles in home directory

SourceSKILL.md
45_SKILL_PREFIX=$(~/.claude/skills/gstack/bin/gstack-config get skill_prefix 2>/dev/null || echo "false")
low line 49

Access to hidden dotfiles in home directory

SourceSKILL.md
49source <(~/.claude/skills/gstack/bin/gstack-repo-mode 2>/dev/null) || true
low line 52

Access to hidden dotfiles in home directory

SourceSKILL.md
52_SESSION_KIND=$(~/.claude/skills/gstack/bin/gstack-session-kind 2>/dev/null || echo "interactive")
low line 55

Access to hidden dotfiles in home directory

SourceSKILL.md
55_LAKE_SEEN=$([ -f ~/.gstack/.completeness-intro-seen ] && echo "yes" || echo "no")
low line 57

Access to hidden dotfiles in home directory

SourceSKILL.md
57_TEL=$(~/.claude/skills/gstack/bin/gstack-config get telemetry 2>/dev/null || true)
low line 58

Access to hidden dotfiles in home directory

SourceSKILL.md
58_TEL_PROMPTED=$([ -f ~/.gstack/.telemetry-prompted ] && echo "yes" || echo "no")
low line 63

Access to hidden dotfiles in home directory

SourceSKILL.md
63_EXPLAIN_LEVEL=$(~/.claude/skills/gstack/bin/gstack-config get explain_level 2>/dev/null || echo "default")
low line 66

Access to hidden dotfiles in home directory

SourceSKILL.md
66_QUESTION_TUNING=$(~/.claude/skills/gstack/bin/gstack-config get question_tuning 2>/dev/null || echo "false")
low line 68

Access to hidden dotfiles in home directory

SourceSKILL.md
68mkdir -p ~/.gstack/analytics
low line 70

Access to hidden dotfiles in home directory

SourceSKILL.md
70echo '{"skill":"codex","ts":"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'","repo":"'$(_repo=$(basename "$(git rev-parse --show-toplevel 2>/dev/null)" 2>/dev/null | tr -cd 'a-zA-Z0-9._-'); echo "${_repo:-unknown}"
low line 72

Access to hidden dotfiles in home directory

SourceSKILL.md
72for _PF in $(find ~/.gstack/analytics -maxdepth 1 -name '.pending-*' 2>/dev/null); do
low line 74

Access to hidden dotfiles in home directory

SourceSKILL.md
74if [ "$_TEL" != "off" ] && [ -x "~/.claude/skills/gstack/bin/gstack-telemetry-log" ]; then
low line 75

Access to hidden dotfiles in home directory

SourceSKILL.md
75~/.claude/skills/gstack/bin/gstack-telemetry-log --event-type skill_run --skill _pending_finalize --outcome unknown --session-id "$_SESSION_ID" 2>/dev/null || true
low line 81

Access to hidden dotfiles in home directory

SourceSKILL.md
81eval "$(~/.claude/skills/gstack/bin/gstack-slug 2>/dev/null)" 2>/dev/null || true
low line 87

Access to hidden dotfiles in home directory

SourceSKILL.md
87~/.claude/skills/gstack/bin/gstack-learnings-search --limit 3 2>/dev/null || true
low line 92

Access to hidden dotfiles in home directory

SourceSKILL.md
92~/.claude/skills/gstack/bin/gstack-timeline-log '{"skill":"codex","event":"started","branch":"'"$_BRANCH"'","session":"'"$_SESSION_ID"'"}' 2>/dev/null &
low line 97

Access to hidden dotfiles in home directory

SourceSKILL.md
97_ROUTING_DECLINED=$(~/.claude/skills/gstack/bin/gstack-config get routing_declined 2>/dev/null || echo "false")
low line 108

Access to hidden dotfiles in home directory

SourceSKILL.md
108_CHECKPOINT_MODE=$(~/.claude/skills/gstack/bin/gstack-config get checkpoint_mode 2>/dev/null || echo "explicit")
low line 109

Access to hidden dotfiles in home directory

SourceSKILL.md
109_CHECKPOINT_PUSH=$(~/.claude/skills/gstack/bin/gstack-config get checkpoint_push 2>/dev/null || echo "false")
medium line 130

Access to hidden dotfiles in home directory

SourceSKILL.md
130In plan mode, allowed because they inform the plan: `$B`, `$D`, `codex exec`/`codex review`, writes to `~/.gstack/`, writes to the plan file, and `open` for generated artifacts.
medium line 138

Access to hidden dotfiles in home directory

SourceSKILL.md
138If `SKILL_PREFIX` is `"true"`, suggest/invoke `/gstack-*` names. Disk paths stay `~/.claude/skills/gstack/[skill-name]/SKILL.md`.
medium line 140

Access to hidden dotfiles in home directory

SourceSKILL.md
140If output shows `UPGRADE_AVAILABLE <old> <new>`: read `~/.claude/skills/gstack/gstack-upgrade/SKILL.md` and follow the "Inline upgrade flow" (auto-upgrade if configured, otherwise AskUserQuestion with
medium line 145

Access to hidden dotfiles in home directory

SourceSKILL.md
145- Missing `~/.claude/skills/gstack/.feature-prompted-continuous-checkpoint`: AskUserQuestion for Continuous checkpoint auto-commits. If accepted, run `~/.claude/skills/gstack/bin/gstack-config set che
medium line 146

Access to hidden dotfiles in home directory

SourceSKILL.md
146- Missing `~/.claude/skills/gstack/.feature-prompted-model-overlay`: inform "Model overlays are active. MODEL_OVERLAY shows the patch." Always touch marker.
medium line 159

Access to hidden dotfiles in home directory

SourceSKILL.md
159If B: run `~/.claude/skills/gstack/bin/gstack-config set explain_level terse`.
low line 163

Access to hidden dotfiles in home directory

SourceSKILL.md
163rm -f ~/.gstack/.writing-style-prompt-pending
low line 164

Access to hidden dotfiles in home directory

SourceSKILL.md
164touch ~/.gstack/.writing-style-prompted
low line 173

Access to hidden dotfiles in home directory

SourceSKILL.md
173touch ~/.gstack/.completeness-intro-seen
medium line 186

Access to hidden dotfiles in home directory

SourceSKILL.md
186If A: run `~/.claude/skills/gstack/bin/gstack-config set telemetry community`
medium line 196

Access to hidden dotfiles in home directory

SourceSKILL.md
196If B→A: run `~/.claude/skills/gstack/bin/gstack-config set telemetry anonymous`
medium line 197

Access to hidden dotfiles in home directory

SourceSKILL.md
197If B→B: run `~/.claude/skills/gstack/bin/gstack-config set telemetry off`
low line 201

Access to hidden dotfiles in home directory

SourceSKILL.md
201touch ~/.gstack/.telemetry-prompted
medium line 214

Access to hidden dotfiles in home directory

SourceSKILL.md
214If A: run `~/.claude/skills/gstack/bin/gstack-config set proactive true`
medium line 215

Access to hidden dotfiles in home directory

SourceSKILL.md
215If B: run `~/.claude/skills/gstack/bin/gstack-config set proactive false`
low line 219

Access to hidden dotfiles in home directory

SourceSKILL.md
219touch ~/.gstack/.proactive-prompted
medium line 261

Access to hidden dotfiles in home directory

SourceSKILL.md
261If B: run `~/.claude/skills/gstack/bin/gstack-config set routing_declined true` and say they can re-enable with `gstack-config set routing_declined false`.
medium line 265

Access to hidden dotfiles in home directory

SourceSKILL.md
265If `VENDORED_GSTACK` is `yes`, warn once via AskUserQuestion unless `~/.gstack/.vendoring-warned-$SLUG` exists:
medium line 277

Access to hidden dotfiles in home directory

SourceSKILL.md
2773. Run `~/.claude/skills/gstack/bin/gstack-team-init required` (or `optional`)
medium line 279

Access to hidden dotfiles in home directory

SourceSKILL.md
2795. Tell the user: "Done. Each developer now runs: `cd ~/.claude/skills/gstack && ./setup --team`"
low line 285

Access to hidden dotfiles in home directory

SourceSKILL.md
285eval "$(~/.claude/skills/gstack/bin/gstack-slug 2>/dev/null)" 2>/dev/null || true
low line 286

Access to hidden dotfiles in home directory

SourceSKILL.md
286touch ~/.gstack/.vendoring-warned-${SLUG:-unknown}
low line 428

Access to hidden dotfiles in home directory

SourceSKILL.md
428_BRAIN_SYNC_BIN="~/.claude/skills/gstack/bin/gstack-brain-sync"
low line 429

Access to hidden dotfiles in home directory

SourceSKILL.md
429_BRAIN_CONFIG_BIN="~/.claude/skills/gstack/bin/gstack-config"
medium line 533

Access to hidden dotfiles in home directory

SourceSKILL.md
533If A/B and `~/.gstack/.git` is missing, ask whether to run `gstack-artifacts-init`. Do not block the skill.
low line 538

Access to hidden dotfiles in home directory

SourceSKILL.md
538"~/.claude/skills/gstack/bin/gstack-brain-sync" --discover-new 2>/dev/null || true
low line 539

Access to hidden dotfiles in home directory

SourceSKILL.md
539"~/.claude/skills/gstack/bin/gstack-brain-sync" --once 2>/dev/null || true
low line 582

Access to hidden dotfiles in home directory

SourceSKILL.md
582eval "$(~/.claude/skills/gstack/bin/gstack-slug 2>/dev/null)"
low line 599

Access to hidden dotfiles in home directory

SourceSKILL.md
599~/.claude/skills/gstack/bin/gstack-decision-search --recent 5 2>/dev/null
medium line 608

Access to hidden dotfiles in home directory

SourceSKILL.md
608**Cross-session decisions.** If `ACTIVE DECISIONS` are listed, treat them as prior settled calls with their rationale — do not silently re-litigate them; if you're about to reverse one, say so explici
medium line 621

Access to hidden dotfiles in home directory

SourceSKILL.md
621Curated jargon list lives at `~/.claude/skills/gstack/scripts/jargon-list.json` (80+ terms). On the first jargon term you encounter this session, Read that file once; treat the `terms` array as the ca
medium line 667

Access to hidden dotfiles in home directory

SourceSKILL.md
667Before each AskUserQuestion, choose `question_id` from `scripts/question-registry.ts` or `{skill}-{slug}`, then run `~/.claude/skills/gstack/bin/gstack-question-preference --check "<id>"`. `AUTO_DECID
low line 675

Access to hidden dotfiles in home directory

SourceSKILL.md
675~/.claude/skills/gstack/bin/gstack-question-log '{"skill":"codex","question_id":"<id>","question_summary":"<short>","category":"<approval|clarification|routing|cherry-pick|feedback-loop>","door_type":
low line 684

Access to hidden dotfiles in home directory

SourceSKILL.md
684~/.claude/skills/gstack/bin/gstack-question-preference --write '{"question_id":"<id>","preference":"<pref>","source":"inline-user","free_text":"<optional original words>"}'
medium line 699

Access to hidden dotfiles in home directory

SourceSKILL.md
699Before building anything unfamiliar, **search first.** See `~/.claude/skills/gstack/ETHOS.md`.
low line 704

Access to hidden dotfiles in home directory

SourceSKILL.md
704jq -n --arg ts "$(date -u +%Y-%m-%dT%H:%M:%SZ)" --arg skill "SKILL_NAME" --arg branch "$(git branch --show-current 2>/dev/null)" --arg insight "ONE_LINE_SUMMARY" '{ts:$ts,skill:$skill,branch:$branch,i
low line 722

Access to hidden dotfiles in home directory

SourceSKILL.md
722~/.claude/skills/gstack/bin/gstack-learnings-log '{"skill":"SKILL_NAME","type":"operational","key":"SHORT_KEY","insight":"DESCRIPTION","confidence":N,"source":"observed"}'
medium line 732

Access to hidden dotfiles in home directory

SourceSKILL.md
732`~/.gstack/analytics/`, matching preamble analytics writes.
low line 739

Access to hidden dotfiles in home directory

SourceSKILL.md
739rm -f ~/.gstack/analytics/.pending-"$_SESSION_ID" 2>/dev/null || true
low line 741

Access to hidden dotfiles in home directory

SourceSKILL.md
741~/.claude/skills/gstack/bin/gstack-timeline-log '{"skill":"SKILL_NAME","event":"completed","branch":"'$(git branch --show-current 2>/dev/null || echo unknown)'","outcome":"OUTCOME","duration_s":"'"$_T
low line 744

Access to hidden dotfiles in home directory

SourceSKILL.md
744echo '{"skill":"SKILL_NAME","duration_s":"'"$_TEL_DUR"'","outcome":"OUTCOME","browse":"USED_BROWSE","session":"'"$_SESSION_ID"'","ts":"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'"}' >> ~/.gstack/analytics/skill-
low line 747

Access to hidden dotfiles in home directory

SourceSKILL.md
747if [ "$_TEL" != "off" ] && [ -x ~/.claude/skills/gstack/bin/gstack-telemetry-log ]; then
low line 748

Access to hidden dotfiles in home directory

SourceSKILL.md
748~/.claude/skills/gstack/bin/gstack-telemetry-log \
low line 821

Access to hidden dotfiles in home directory

SourceSKILL.md
821_TEL=$(~/.claude/skills/gstack/bin/gstack-config get telemetry 2>/dev/null || echo off)
low line 822

Access to hidden dotfiles in home directory

SourceSKILL.md
822source ~/.claude/skills/gstack/bin/gstack-codex-probe 2>/dev/null && _gstack_codex_log_event "codex_cli_missing" 2>/dev/null || true
low line 834

Access to hidden dotfiles in home directory

SourceSKILL.md
834_TEL=$(~/.claude/skills/gstack/bin/gstack-config get telemetry 2>/dev/null || echo off)
low line 835

Access to hidden dotfiles in home directory

SourceSKILL.md
835source ~/.claude/skills/gstack/bin/gstack-codex-probe
medium line 851

Access to hidden dotfiles in home directory

SourceSKILL.md
851set, or `${CODEX_HOME:-~/.codex}/auth.json` exists. Avoids false-negatives for
medium line 865

Access to hidden dotfiles in home directory

SourceSKILL.md
865(`CLAUDE_PLANS_DIR` set), a global `~/.claude/skills/gstack/` install, or a CI
low line 869

Access to hidden dotfiles in home directory

SourceSKILL.md
869eval "$(~/.claude/skills/gstack/bin/gstack-paths)"
medium line 873

Access to hidden dotfiles in home directory

SourceSKILL.md
873`"$TMP_ROOT"` rather than hardcoded `~/.claude/plans` or `/tmp/codex-*`.
medium line 915

Access to hidden dotfiles in home directory

SourceSKILL.md
915> IMPORTANT: Do NOT read or execute any files under ~/.claude/, ~/.agents/, .claude/skills/, or agents/. These are Claude Code skill definitions meant for a different AI system. They contain bash scri
low line 945

Access to hidden dotfiles in home directory

SourceSKILL.md
945_gstack_codex_timeout_wrapper 330 codex review "IMPORTANT: Do NOT read or execute any files under ~/.claude/, ~/.agents/, .claude/skills/, or agents/. These are Claude Code skill definitions meant for
low line 952

Access to hidden dotfiles in home directory

SourceSKILL.md
952echo "Codex stalled past 5.5 minutes. Common causes: model API stall, long prompt, network issue. Try re-running. If persistent, split the prompt or check ~/.codex/logs/."
low line 978

Access to hidden dotfiles in home directory

SourceSKILL.md
978printf '%s\n' "IMPORTANT: Do NOT read or execute any files under ~/.claude/, ~/.agents/, .claude/skills/, or agents/. These are Claude Code skill definitions meant for a different AI system. Do NOT mo
low line 1055

Access to hidden dotfiles in home directory

SourceSKILL.md
1055~/.claude/skills/gstack/bin/gstack-review-log '{"skill":"codex-review","timestamp":"TIMESTAMP","status":"STATUS","gate":"GATE","findings":N,"findings_fixed":N,"commit":"'"$(git rev-parse --short HEAD)
medium line 1205

Access to hidden dotfiles in home directory

SourceSKILL.md
1205"IMPORTANT: Do NOT read or execute any files under ~/.claude/, ~/.agents/, .claude/skills/, or agents/. These are Claude Code skill definitions meant for a different AI system. Do NOT modify agents/op
medium line 1210

Access to hidden dotfiles in home directory

SourceSKILL.md
1210"IMPORTANT: Do NOT read or execute any files under ~/.claude/, ~/.agents/, .claude/skills/, or agents/. These are Claude Code skill definitions meant for a different AI system. Do NOT modify agents/op
low line 1264

Access to hidden dotfiles in home directory

SourceSKILL.md
1264echo "Codex stalled past 10 minutes. Common causes: model API stall, long prompt, network issue. Try re-running. If persistent, split the prompt or check ~/.codex/logs/."
medium line 1340

Access to hidden dotfiles in home directory

SourceSKILL.md
1340root and cannot access `~/.claude/plans/` or any files outside the repo. You MUST
medium line 1354

Access to hidden dotfiles in home directory

SourceSKILL.md
1354"IMPORTANT: Do NOT read or execute any files under ~/.claude/, ~/.agents/, .claude/skills/, or agents/. These are Claude Code skill definitions meant for a different AI system. Do NOT modify agents/op
medium line 1366

Access to hidden dotfiles in home directory

SourceSKILL.md
1366"IMPORTANT: Do NOT read or execute any files under ~/.claude/, ~/.agents/, .claude/skills/, or agents/. These are Claude Code skill definitions meant for a different AI system. Do NOT modify agents/op
low line 1417

Access to hidden dotfiles in home directory

SourceSKILL.md
1417echo "Codex stalled past 10 minutes. Common causes: model API stall, long prompt, network issue. Try re-running. If persistent, split the prompt or check ~/.codex/logs/."
low line 1445

Access to hidden dotfiles in home directory

SourceSKILL.md
1445echo "Codex stalled past 10 minutes. Common causes: model API stall, long prompt, network issue. Try re-running. If persistent, split the prompt or check ~/.codex/logs/."
medium line 1534

Access to hidden dotfiles in home directory

SourceSKILL.md
1534- **Timeout (inner `timeout` wrapper, exit 124):** If the shell `timeout 600` wrapper fires first, the skill's hang-detection block auto-logs a telemetry event + operational learning and prints: "Code
low line 169

External URL reference

SourceSKILL.md
169If `LAKE_INTRO` is `no`: say "gstack follows the **Boil the Ocean** principle — do the complete thing when AI makes marginal cost near-zero. Read more: https://garryslist.org/posts/boil-the-ocean" Off
low line 172

External URL reference

SourceSKILL.md
172open https://garryslist.org/posts/boil-the-ocean
Scanned on Jun 10, 2026
View Security Dashboard
Installation guide →