Codex CLI: App-Server Filesystem RPCs & Python SDK
CodexCodex CLI 0.115.0 expands the v2 app-server with a comprehensive suite of filesystem RPCs — covering file reads, writes, copies, directory operations, and path watching — accessible over the JSON-RPC protocol. Alongside this, OpenAI ships an official Python SDK for the app-server API, ending a gap that had prompted the developer community to build independent wrappers since late 2025. Together these additions make Python-based agent orchestration and automation around Codex significantly more accessible.
Sources & Mentions
4 external resources covering this update
App-Server Filesystem RPCs
Codex CLI 0.115.0 significantly expands the v2 app-server with a suite of filesystem RPCs. Clients connecting to the app-server can now perform file reads, file writes, file copies, directory operations, and path watching — all via the JSON-RPC over stdio protocol that underpins the app-server.
This capability matters for any tooling that wraps or builds on top of Codex's agent runtime. Rather than managing filesystem interactions independently and passing results in separately, external clients can now delegate those operations directly through the app-server's protocol surface. Path watching in particular enables reactive integrations: a client can subscribe to filesystem changes and respond to them as part of a broader agent workflow.
Moving Beyond v1
The v2 app-server continues to supersede the older v1 protocol. PR #13375 removes v1 RPC methods and notifications, with only the small subset still required by the main Codex app client preserved temporarily. Developers building integrations should target the v2 protocol and its expanded filesystem operation set.
Official Python SDK
Alongside the filesystem RPCs, OpenAI ships an official Python SDK for the Codex app-server. The SDK provides a clean programmatic interface for Python developers to interact with the app-server API, including subprocess management through AppServerClient.start().
This is a notable milestone. GitHub issue #5320 — filed in October 2025 and drawing over 10 comments from developers who had built their own independent Python wrappers — documented the community demand for an official supported SDK. Codex 0.115.0 directly addresses that gap.
Impact for Developers
Python is the dominant language in the AI/ML ecosystem. Having an officially maintained SDK means developers building orchestration layers, CI/CD integrations, or multi-agent pipelines around Codex can now do so with confidence in API stability and support. Combined with the new filesystem RPCs, the v2 app-server becomes a far more capable integration surface — not just for running agent sessions, but for full programmatic control over filesystem state as part of those sessions.