From 901267bf9bdcae0dab1e4fcf4d834d691f673da6 Mon Sep 17 00:00:00 2001 From: Cathryn Lavery Date: Thu, 9 Jul 2026 15:26:09 -0700 Subject: [PATCH] codex: refresh model docs to GPT-5.6 family, add max reasoning level Keeps the no-hardcode default (auto-frontier). Updates the illustrative model names in the Model & Reasoning section to the current GPT-5.6 family (sol/terra/luna, bare gpt-5.6 -> sol) and documents the new `max` reasoning-effort level above xhigh. --- codex/SKILL.md | 9 ++++++--- codex/SKILL.md.tmpl | 9 ++++++--- 2 files changed, 12 insertions(+), 6 deletions(-) diff --git a/codex/SKILL.md b/codex/SKILL.md index 33228ff9b..fc7fc307b 100644 --- a/codex/SKILL.md +++ b/codex/SKILL.md @@ -1537,7 +1537,8 @@ The reason must engage with a specific Codex insight and compare against an alte **Model:** No model is hardcoded — codex uses whatever its current default is (the frontier agentic coding model). This means as OpenAI ships newer models, /codex automatically -uses them. If the user wants a specific model, pass `-m` through to codex. +uses them. As of July 2026 that frontier is the GPT-5.6 family (ladder: `sol` > `terra` > `luna`, +where bare `gpt-5.6` aliases to `sol`). If the user wants a specific model, pass `-m` through to codex. **Reasoning effort (per-mode defaults):** - **Review (2A):** `high` — bounded diff input, needs thoroughness but not max tokens @@ -1547,12 +1548,14 @@ uses them. If the user wants a specific model, pass `-m` through to codex. `xhigh` uses ~23x more tokens than `high` and causes 50+ minute hangs on large context tasks (OpenAI issues #8545, #8402, #6931). Users can override with `--xhigh` flag (e.g., `/codex review --xhigh`) when they want maximum reasoning and are willing to wait. +The GPT-5.6 family adds a `max` level above `xhigh` — even more token-hungry, so gstack +wires no flag for it; pass `-c model_reasoning_effort=max` manually if you truly need it. **Web search:** All codex commands use `--enable web_search_cached` so Codex can look up docs and APIs during review. This is OpenAI's cached index — fast, no extra cost. -If the user specifies a model (e.g., `/codex review -m gpt-5.1-codex-max` -or `/codex challenge -m gpt-5.2`), pass the `-m` flag through to codex. +If the user specifies a model (e.g., `/codex review -m gpt-5.6-sol` +or `/codex challenge -m gpt-5.6-luna`), pass the `-m` flag through to codex. --- diff --git a/codex/SKILL.md.tmpl b/codex/SKILL.md.tmpl index 333de7d8d..c6567be13 100644 --- a/codex/SKILL.md.tmpl +++ b/codex/SKILL.md.tmpl @@ -606,7 +606,8 @@ The reason must engage with a specific Codex insight and compare against an alte **Model:** No model is hardcoded — codex uses whatever its current default is (the frontier agentic coding model). This means as OpenAI ships newer models, /codex automatically -uses them. If the user wants a specific model, pass `-m` through to codex. +uses them. As of July 2026 that frontier is the GPT-5.6 family (ladder: `sol` > `terra` > `luna`, +where bare `gpt-5.6` aliases to `sol`). If the user wants a specific model, pass `-m` through to codex. **Reasoning effort (per-mode defaults):** - **Review (2A):** `high` — bounded diff input, needs thoroughness but not max tokens @@ -616,12 +617,14 @@ uses them. If the user wants a specific model, pass `-m` through to codex. `xhigh` uses ~23x more tokens than `high` and causes 50+ minute hangs on large context tasks (OpenAI issues #8545, #8402, #6931). Users can override with `--xhigh` flag (e.g., `/codex review --xhigh`) when they want maximum reasoning and are willing to wait. +The GPT-5.6 family adds a `max` level above `xhigh` — even more token-hungry, so gstack +wires no flag for it; pass `-c model_reasoning_effort=max` manually if you truly need it. **Web search:** All codex commands use `--enable web_search_cached` so Codex can look up docs and APIs during review. This is OpenAI's cached index — fast, no extra cost. -If the user specifies a model (e.g., `/codex review -m gpt-5.1-codex-max` -or `/codex challenge -m gpt-5.2`), pass the `-m` flag through to codex. +If the user specifies a model (e.g., `/codex review -m gpt-5.6-sol` +or `/codex challenge -m gpt-5.6-luna`), pass the `-m` flag through to codex. ---