How openai/codex works
Codex CLI is a local coding agent: a user starts a session, the agent works with repository context and tools, and results are presented in the terminal. The repository also includes MCP server integrations, extensible plugins, and app-server interfaces. The source index and excerpts establish several MCP module relationships; the broader session-to-model and CLI-to-terminal flow is described only at product level here, so those links are marked unverified rather than inferred from module names.
Main entry points: rmcp_client.rs RMCP client · runtime.rs MCP runtime · session.rs Agent session · manager.rs Plugin manager
Components 20
CLI and interaction
- CLI entry
codex-rs/cli/src/main.rs - Terminal UI
codex-rs/tui/src/app.rs
Agent sessions
- Thread manager
codex-rs/core/src/thread_manager.rs - Agent session
codex-rs/core/src/session/session.rs - Command execution
codex-rs/core/src/unified_exec/process_manager.rs
MCP integrations
- MCP runtime
codex-rs/codex-mcp/src/runtime.rs - Connection manager
codex-rs/codex-mcp/src/connection_manager.rs - RMCP client
codex-rs/codex-mcp/src/rmcp_client.rs - Server config
codex-rs/codex-mcp/src/server.rs - Tool catalog
codex-rs/codex-mcp/src/tools.rs - Client tool catalog
codex-rs/codex-mcp/src/client_tool_catalog.rs - MCP auth
codex-rs/codex-mcp/src/auth.rs - User elicitation
codex-rs/codex-mcp/src/elicitation.rs - MCP OAuth
codex-rs/rmcp-client/src/oauth.rs
Plugins
- Plugin manager
codex-rs/core-plugins/src/manager.rs - Plugin loader
codex-rs/core-plugins/src/loader.rs - Remote plugins
codex-rs/core-plugins/src/remote.rs
App interfaces
- App server
codex-rs/app-server/src - App protocol
codex-rs/app-server-protocol
Other components
- Developer
Connections 20
- Developer → CLI entry: starts
README.md - CLI entry → Thread manager: starts session
- Thread manager → Agent session: manages
- Agent session → Terminal UI: streams results
- Agent session → Command execution: runs commands
- Agent session → MCP runtime: uses tools
- MCP runtime → Connection manager: manages
codex-rs/codex-mcp/src/runtime.rs - MCP runtime → RMCP client: starts clients
codex-rs/codex-mcp/src/runtime.rs - MCP runtime → Server config: publishes config
codex-rs/codex-mcp/src/runtime.rs - RMCP client → Server config: connects to
codex-rs/codex-mcp/src/rmcp_client.rs - RMCP client → Tool catalog: filters tools
codex-rs/codex-mcp/src/rmcp_client.rs - RMCP client → Client tool catalog: updates catalog
codex-rs/codex-mcp/src/rmcp_client.rs - RMCP client → MCP auth: uses auth
codex-rs/codex-mcp/src/rmcp_client.rs - RMCP client → User elicitation: requests input
codex-rs/codex-mcp/src/rmcp_client.rs - RMCP client → MCP OAuth: uses OAuth
- Plugin manager → Plugin loader: loads plugins
- Plugin manager → Remote plugins: refreshes remotes
- Plugin manager → MCP runtime: configures tools
- App server → App protocol: uses protocol
- Developer → App server: may use app
README.md