Skip to content

0.5.1 — refresh model recommendations for mid-2026 codex lineup#5

Merged
wenqingyu merged 1 commit into
mainfrom
docs/0.5.1-model-recommendations
Apr 29, 2026
Merged

0.5.1 — refresh model recommendations for mid-2026 codex lineup#5
wenqingyu merged 1 commit into
mainfrom
docs/0.5.1-model-recommendations

Conversation

@wenqingyu
Copy link
Copy Markdown
Owner

Summary

Docs-only refresh of the model recommendations to match the mid-2026 codex CLI surface (`gpt-5.5` baseline + reasoning-effort profiles), plus two real bug fixes in the example files.

Why

The 2025-era per-role split was `gpt-5.2-codex` for implementer / `gpt-5` for reviewer / `o3` for planner — three different models, each playing to a different strength. In 2026, `gpt-5.5` handles all three workloads at the top of the lineup, and the dial that matters is reasoning effort, configured at the codex CLI level via profiles (`[profiles.coding]`, `[profiles.deep]`, `[profiles.fast]`). The previous docs were prescribing the wrong abstraction.

Changes

  • README "Choosing models" section now leads with: leave `model` unset in `magic-codex.toml`, configure your `~/.codex/config.toml` with profiles, switch profiles via `codex --profile `. Shows in-magic-codex pinning only for the budget-cap case (e.g., `[roles.generic] model = "gpt-5-codex-mini"`).
  • `magic-codex.toml.example` rewritten with a richer codex baseline + the same profile-driven story.
  • Bug: `magic-codex.toml.example` header referenced the wrong filename (`codex-team.toml`). Loader at `src/index.ts:157` actually reads `magic-codex.toml`. Fixed.
  • Bug: README role table still showed implementer's old `workspace-write` sandbox. Default has been `danger-full-access` since 0.4.0. Fixed.
  • Version literals bumped 0.5.0 → 0.5.1; build-time drift guard validated.

Test plan

  • `npm run typecheck` — clean
  • `npm test` — 117 passing (no code changes)
  • `npm run build` — drift guard validates 5 version literals match 0.5.1

🤖 Generated with Claude Code

The 2025-era per-role split (gpt-5.2-codex / gpt-5 / o3) collapsed.
gpt-5.5 now handles implementation, review, and planning; the dial
that matters is reasoning effort, configured via codex CLI profiles
([profiles.coding], [profiles.deep], [profiles.fast]).

README and magic-codex.toml.example now lead with "leave model unset,
configure your ~/.codex/config.toml" and only show in-magic-codex
pinning for the budget-cap case (e.g., generic role -> mini).

Also fixes:
- magic-codex.toml.example header referenced the wrong filename
  (codex-team.toml). Loader actually reads magic-codex.toml.
- README role table still showed implementer's old workspace-write
  sandbox; corrected to danger-full-access (default since 0.4.0).

No code changes; tests still 117 passing.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@wenqingyu wenqingyu merged commit c1e9e85 into main Apr 29, 2026
2 checks passed
@wenqingyu wenqingyu deleted the docs/0.5.1-model-recommendations branch April 29, 2026 05:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants