Skip to main content

​
Overview

Connect CodeAlive with OpenAI’s Codex CLI to enhance your AI coding agent with deep codebase understanding. Codex uses a TOML configuration format, which is unique among MCP clients.
Quick install: Run npx @codealive/installer to automatically configure CodeAlive for Codex. See the Installation Guide for details.

​
Prerequisites

​
Setup

1

Locate Config File

Codex reads MCP configuration from:
~/.codex/config.toml
Create the file if it doesn’t exist.
2

Add CodeAlive Server

Replace YOUR_API_KEY_HERE with your actual CodeAlive API key.
3

Restart Codex

Restart the Codex CLI to pick up the new configuration.
4

Verify Integration

Try these commands with Codex:
  • “Show me all available repositories”
  • “Find authentication code in my codebase”

​
Usage

Once connected, Codex can:
  • Search your codebase semantically across all indexed repositories
  • Answer architecture questions with full project context
  • Find patterns and implementations across multiple services
"Find all error handling patterns in the payment service"
"Explain how the user registration flow works"
"Search for database migration code"

​
Troubleshooting

  1. Verify the config file is at ~/.codex/config.toml
  2. Check TOML syntax (use a TOML validator)
  3. Ensure Docker is running (for STDIO option)
  4. Restart Codex
Streamable HTTP requires the experimental Rust MCP client. If it doesn’t work, use the Docker STDIO option instead.
  1. Verify your API key is correct
  2. Check the TOML syntax for headers
  3. Try regenerating your API key in the dashboard
For more solutions, see the Troubleshooting Guide.