Codex

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 install

After 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:

You can change reasoning effort per hero at any time — the next prompt picks up the new setting.

Internal Session Isolation

Internal Codex heroes use an AgentCraft-owned CODEX_HOME under ~/.agentcraft/codex-home. AgentCraft copies only the authentication and configuration inputs needed to run Codex. Resumable internal threads therefore stay available to AgentCraft without appearing in the Codex desktop app's normal task list.

When you resume or fork an older internal hero whose thread still lives in the default ~/.codex, AgentCraft imports only that requested thread into the isolated home.

Linux Sandbox Requirement

Codex write mode on Linux requires Bubblewrap:

sudo apt install -y bubblewrap

AgentCraft reports this through agentcraft doctor but does not install privileged OS packages automatically.

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: