Codex Bridge FAQs

Question 1

What is Codex Bridge and how does it help developers?

Accepted Answer

Codex Bridge is an MCP server that grants AI agents and MCP clients read-only access to your local OpenAI Codex CLI session history. It helps developers unify their AI workflows by allowing agents like Claude Code or Cursor to search, read, and reference past Codex conversations, preventing context loss and repetitive explanations across different AI tools.

Question 2

Does Codex Bridge require any API keys or transfer data externally?

Accepted Answer

No, Codex Bridge operates entirely locally. It directly reads your `~/.codex/` data files (state.sqlite and session JSONL files) without needing any API keys, internet connection, or transferring any data to external services.

Question 3

How do I get started with Codex Bridge?

Accepted Answer

To get started, you'll need Python 3.11+ and OpenAI Codex CLI installed with existing sessions. You can then install it directly into Claude Code with a one-liner command, or configure it in your `.mcp.json` file for other MCP clients like Claude Desktop or Cursor.

Question 4

What kind of information can I retrieve from my Codex sessions?

Accepted Answer

You can use Codex Bridge to search and list sessions by keyword, retrieving metadata like model, timestamp, and title. You can also read full conversations for any given session ID, including all user messages, agent responses, and tool calls.

Question 5

Is Codex Bridge compatible with other AI development tools?

Accepted Answer

Yes, Codex Bridge is compatible with any AI agent or client that supports the Model Context Protocol (MCP). This includes tools like Claude Code, Cursor, and Windsurf, allowing for seamless integration into various AI-powered development environments.

Codex Bridge

Codex Bridge

主要功能

使用案例

主要功能

使用案例