Build on Frontal.
Client libraries, a typed API, and the references you need to ship your first integration today.
Start here
Authentication
Sign in to Codex locally or provide an API key to the CLI process.
Requests and responses
Understand the SDK calls and MCP messages that make up a Codex integration.
Threads
Create, resume, fork, and inspect persisted Codex conversations.
Turns and events
Submit Codex work and consume the structured events produced while it runs.
Essentials
Authentication
Sign in to Codex locally or provide an API key to the CLI process.
Requests and responses
Understand the SDK calls and MCP messages that make up a Codex integration.
Listing threads
Read persisted Codex threads through the MCP server interface.
Repeated work
Make retries safe when submitting turns or reconnecting to Codex.
Errors
Handle failed turns, command executions, MCP calls, and process errors safely.
Resource limits
Design integrations around local process, model, and tool limits.
Versioning
Track the CLI, SDK, and experimental MCP interface versions you depend on.
API reference
Threads
Create, resume, fork, and inspect persisted Codex conversations.
Working directories and configuration
Control where Codex works and how the child CLI process is configured.
Turns and events
Submit Codex work and consume the structured events produced while it runs.
MCP servers
Configure external Model Context Protocol servers for the Codex CLI.
Items
Understand the structured items returned by Codex turns.
Structured output
Require a Codex turn to return JSON that conforms to a schema.
Notifications
Consume live Codex progress through SDK streams or MCP notifications.
Authentication and environment
Configure ChatGPT or API-key authentication for the local Codex process.
SDKs
SDKs
Embed Codex with the official TypeScript SDK or integrate through its CLI and MCP interfaces.
TypeScript SDK
Embed the Codex coding agent in a Node.js application with a typed client.
Python integration
Integrate Codex from Python by invoking the CLI or implementing an MCP client.
Go integration
Integrate Codex from Go by invoking the CLI or implementing an MCP client.