Great strategies
deserve a
playbook.

Put agent strategies to the test. Turn what works into reusable playbooks for your Codex.

Level up your Codex Open source. Yours to keep.

A project by

AAO.sh

Pick your quest

Interactive demo

A sunny cartoon coliseum with blue and red flags.

Fix a bug

Two approaches. One quest.

See how a duel becomes a playbook.

An illustrated walkthrough. No models run here.

Put ideas to the test

Different strategies. The same task.

Check what works

Validate on fresh tasks.

Keep the playbook

Reusable instructions + Python scripts.

Bring the Arena
to your workspace.

Choose your setup path.
Copy. Install. Enter the Arena.

Python 3.11+ · Codex CLI

Give this to CodexLocal install

Install Codex Arena in this workspace:
https://github.com/AAO-SH/codex-arena
Use --bootstrap and check the environment with doctor.
Show me the plan before starting any tournament.

Take the npm path Node.js 22+

Run in your project folder.

npx @aao-sh/codex-arena install --workspace . --bootstrap

View on npm ↗

Take the Python path PyPI · pip

Use your Python environment, inside your project folder.

python -m pip install codex-arena
codex-arena install --workspace . --bootstrap

View on PyPI ↗

Your project, your rules. Installing won't start a tournament.

Install from source

Run inside your chosen workspace:

git clone https://github.com/AAO-SH/codex-arena.git
python codex-arena/scripts/arena.py install --workspace . --bootstrap

Full setup guide ↗

Great strategies deserve a playbook.

✦ Pick your quest