codex-protocol README appears stale about app-server protocol types

Open 💬 0 comments Opened Jun 1, 2026 by bar-d

What happened?

codex-rs/protocol/README.md says codex-protocol defines both internal types for communication between codex-core and codex-tui and “external types” used with codex app-server.

The app-server JSON-RPC surface now appears to live in the separate codex-app-server-protocol crate:

  • codex-rs/app-server-protocol/Cargo.toml defines package codex-app-server-protocol.
  • codex-rs/app-server-protocol/src/lib.rs exports the app-server protocol modules and v1/v2 types.
  • The app-server docs point readers to app-server-protocol for request/response shapes.

codex-protocol is still used by other crates and is also a dependency of codex-app-server-protocol, but the README wording makes it sound like the app-server external protocol types live directly in codex-protocol.

Expected behavior

The codex-protocol README should clarify the current crate split: which protocol types remain in codex-protocol, and which app-server JSON-RPC/API types live in codex-app-server-protocol.

Additional context

I searched open issues and PRs for terms including codex-protocol README, app-server external types, and codex-app-server-protocol, and did not find an existing open item that appears to cover this specific README drift.

View original on GitHub ↗