> ## Documentation Index
> Fetch the complete documentation index at: https://vibekanban.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenAI Codex

> Set up OpenAI Codex integration

<Steps>
  <Step title="Run OpenAI Codex">
    ```bash theme={null}
    npx -y @openai/codex
    ```
  </Step>

  <Step title="Follow the login instructions">
    Complete the authentication flow as prompted. Follow the authentication instructions from the [OpenAI help centre](https://help.openai.com/en/articles/11369540-using-codex-with-your-chatgpt-plan) 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](https://developers.openai.com/codex/pricing/#use-an-openai-api-key)
  </Step>

  <Step title="Start Vibe Kanban">
    Once authenticated, launch Vibe Kanban:

    ```bash theme={null}
    npx vibe-kanban
    ```

    You can now select OpenAI Codex when creating task attempts.
  </Step>
</Steps>

## 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.

```bash theme={null}
# 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