Skip to main content
1

Run OpenAI Codex

npx -y @openai/codex
2

Follow the login instructions

Complete the authentication flow as prompted. Follow the authentication instructions from the OpenAI help centre to use Codex with your ChatGPT plan.Alternatively, Codex can be used via the OpenAI API by setting the OPENAI_API_KEY environment variable. For more details, see the OpenAI documentation
3

Start Vibe Kanban

Once authenticated, launch Vibe Kanban:
npx vibe-kanban
You can now select OpenAI Codex when creating task attempts.

​
Custom Configuration Directory

By default, Codex stores its configuration and session data in ~/.codex. If you have configured a custom location using the CODEX_HOME environment variable, Vibe Kanban will automatically detect and use that location. 
# Example: Using a project-specific Codex configuration
export CODEX_HOME=/path/to/custom/codex
npx vibe-kanban
This is useful for:
  • Project-specific Codex profiles
  • Separating work and personal configurations
  • Custom automation setups