Skip to main content
1

Add the hosted server

2

Sign in

Codex opens the browser: sign in to Spiral and click Authorize. No API key. codex mcp list then shows Spiral.
3

Try a starter prompt

Add this to ~/.codex/config.toml, keep SPIRAL_API_KEY set in your shell, then restart Codex:
This installs spiral, signs you in through the browser and adds Spiral’s skill for Codex (~/.agents/skills), so the agent can also run spiral commands in the terminal. It needs Node.js 22.12 or later.
If something does not work, see Troubleshooting.