Codex
Integration with OpenAI's Codex CLI.
AgentCraft supports Codex as a fully-supported coding agent alongside Claude Code. Spawn Codex heroes, watch their work on the map, and command them like any other AgentCraft hero.
Setup
If the codex CLI is installed and on your PATH, AgentCraft auto-detects it during setup and wires everything up for you:
npx @idosal/agentcraft installAfter install, Codex appears in the spawn picker and any codex session you start in a terminal shows up as an external hero on the map.
Spawning Codex Heroes
Open the spawn picker at the Town Hall and pick Codex to launch an internal hero. External Codex sessions (started from any terminal) are detected automatically and appear on the map in real time.
Reasoning Effort
Codex heroes expose a reasoning effort dropdown in the Side Panel:
| Effort | When to use |
|---|---|
| Low | Fast turns, lighter tasks |
| Medium | Balanced default |
| High | Harder problems where you want the agent to think more |
You can change reasoning effort per hero at any time — the next prompt picks up the new setting.
Features
Codex heroes support the core AgentCraft experience:
- Real-time conversation via the Side Panel
- Mission tracking with auto-generated quest names
- Map visualization and hero selection
- Fork and handoff to other heroes
- Integrated terminal and Git tab
- Reasoning effort control
Limitations
Some features are Claude Code-specific and not available for Codex heroes:
| Feature | Reason |
|---|---|
| Plan approval workflow | Claude Code-specific |
| Manual tool approval (Y/N) | Claude Code-specific |
| Agent Teams | Claude Code-specific |