# Reported issues for Codex Control Plane MCP

Pod holds 16 of 18 problems reported by people outside the maintainer team. Issues filed by the project's own owners, members and collaborators are excluded entirely — a maintainer's release checklist is not a warning to a prospective user.

Back to [Codex Control Plane MCP](/mcp/codex-control-plane-mcp).

## Most discussed

### Add redacted account, usage, and rate limit status

## Goal

Expose a privacy-safe account and quota status view from Codex app-server.

## Candidate app-server methods

- `account/read`
- `account/usage/read`
- `account/rateLimits/read`

## Privacy rules

- Do not return tokens.
- Do not return raw email by default.
- Do not return account identifiers unless explicitly needed.
- Prefer booleans and coarse status fields.

## Acceptance criteria

- Health/runtime capabilities can show whether Codex is authenticated.
- Rate-limit information is inc

[Read the thread](https://github.com/aresyn/codex-control-plane-mcp/issues/19) · 2026-06-17 · closed · 2 comments

### Sync Codex thread goals with workflow state

## Goal

Use Codex app-server `thread/goal/get`, `thread/goal/set`, and `thread/goal/clear` to synchronize high-level workflow goals.

## Why

The MCP workflow already has durable goal-like state. Mirroring it into Codex thread goals can improve visibility in Codex Desktop and make resumed threads easier to understand.

## Acceptance criteria

- Workflow start can optionally set a thread goal.
- Workflow completion can clear or update the goal based on configuration.
- `codex_get_workflow_status

[Read the thread](https://github.com/aresyn/codex-control-plane-mcp/issues/16) · 2026-06-17 · closed · 2 comments

### Add thread lifecycle management tools

## Goal

Expose safe thread lifecycle operations around Codex app-server thread management.

## Candidate operations

- `thread/archive`
- `thread/unarchive`
- `thread/compact/start`
- possibly `thread/delete` only behind explicit destructive confirmation

## Design notes

These should stay outside the hot write path. They are management/maintenance tools, not replacements for durable operations.

## Acceptance criteria

- Archive and unarchive are available as safe MCP tools.
- Compact is avail

[Read the thread](https://github.com/aresyn/codex-control-plane-mcp/issues/15) · 2026-06-17 · closed · 2 comments

### Support outputSchema for structured final reports

## Goal

Allow MCP clients to pass Codex app-server `outputSchema` through durable task and workflow operations.

## Why

OpenClaw/Hermes can use structured final reports directly:

- summary;
- root cause;
- proposed fix;
- risks;
- touched files;
- analyst comment draft;
- developer plan.

## Proposed shape

- Add optional `output_schema` to `codex_submit_task`.
- Add optional `output_schema` to workflow planning/execution where appropriate.
- Persist parsed final JSON in `final_report_json` w

[Read the thread](https://github.com/aresyn/codex-control-plane-mcp/issues/14) · 2026-06-17 · closed · 2 comments

### Add durable thread fork operation

## Goal

Expose Codex app-server `thread/fork` as a durable operation.

## Why

Forking lets an MCP client safely branch from an existing thread:

- try an alternative analysis;
- continue from an older state;
- compare two solution plans;
- keep the original thread intact.

## Proposed shape

- Add operation type `fork_thread`.
- Accept source `threadId`, optional target cwd/config overrides, and optional initial message.
- Persist new `threadId` as soon as app-server returns it.
- If an initia

[Read the thread](https://github.com/aresyn/codex-control-plane-mcp/issues/13) · 2026-06-17 · closed · 2 comments

### Add runtime capabilities endpoint for Codex app-server inventory

## Goal

Add a read-only runtime capabilities endpoint that summarizes what the local Codex app-server can do.

## Data to include

- app-server platform and user agent from `initialize`;
- supported schema methods from generated or cached schema;
- available models from `model/list`;
- permission profiles from `permissionProfile/list`;
- sandbox readiness from `windowsSandbox/readiness`;
- hooks status from `hooks/list`;
- skills count from `skills/list`;
- model provider capabilities from `mod

[Read the thread](https://github.com/aresyn/codex-control-plane-mcp/issues/12) · 2026-06-17 · closed · 2 comments

### Capture richer app-server progress events in the journal

## Goal

Persist a richer, redacted progress journal from Codex app-server notifications.

## Events to support

- `item/agentMessage/delta`
- `item/plan/delta`
- `item/reasoning/summaryPartAdded`
- `item/reasoning/summaryTextDelta`
- `turn/diff/updated`
- `thread/tokenUsage/updated`
- `model/rerouted`
- `warning`
- `configWarning`
- `guardianWarning`

## Constraints

- Do not store raw command output by default.
- Do not expose raw tool payloads by default.
- Keep sensitive text redacted or tru

[Read the thread](https://github.com/aresyn/codex-control-plane-mcp/issues/11) · 2026-06-17 · closed · 2 comments

### Support image and local image inputs for Codex turns

## Goal

Allow MCP clients to send image inputs supported by Codex app-server `turn/start`.

## Use cases

- attach screenshots for UI/debug analysis;
- pass error dialogs or visual evidence;
- include local image files in a task.

## Design notes

- Validate file paths and size limits.
- Do not copy image contents into logs.
- Store only metadata in operation diagnostics by default.
- Keep the text-only API path unchanged.

## Acceptance criteria

- `codex_submit_task` accepts image/local image

[Read the thread](https://github.com/aresyn/codex-control-plane-mcp/issues/18) · 2026-06-17 · closed · 1 comment

## Most recent

### Add durable code review workflow via review/start

## Goal

Expose Codex app-server `review/start` as a durable MCP workflow for code review scenarios.

## Proposed behavior

- Start a review through app-server.
- Persist review operation and associated thread/turn ids.
- Poll progress through existing operation/workflow status.
- Capture final review output as a structured report when possible.

## Open questions

- What input shape should be public: branch, diff, PR URL, local checkout, or all of them?
- Should this be a separate tool or an op

[Read the thread](https://github.com/aresyn/codex-control-plane-mcp/issues/17) · 2026-06-17 · closed · 1 comment

### Add durable turn steering without creating duplicate turns

## Goal

Expose Codex app-server `turn/steer` through the durable operation layer so an MCP client can add context to an active turn without starting a second turn.

## Why

OpenClaw/Hermes often needs to pass a clarification while Codex is still working:

- add an analyst note;
- ask for an additional technical plan;
- answer a question from the user;
- correct scope without creating a duplicate turn.

Today the safe path is mostly "start another turn later". `turn/steer` should make this a fir

[Read the thread](https://github.com/aresyn/codex-control-plane-mcp/issues/10) · 2026-06-17 · closed · 1 comment

### Publish troubleshooting guide from real install failures

Turn real install and setup failures into a troubleshooting guide. Include symptoms, likely cause, and the exact command or config change that fixes each case.

[Read the thread](https://github.com/aresyn/codex-control-plane-mcp/issues/8) · 2026-06-17 · open · 0 comments

### Improve first-run security presets

Review the first-run security posture and propose safer presets or clearer prompts for users who start with untrusted repositories.

[Read the thread](https://github.com/aresyn/codex-control-plane-mcp/issues/7) · 2026-06-17 · open · 0 comments

### Add comparison docs for thin Codex wrappers

Expand the README comparison into a short docs page that explains when a thin wrapper is enough and when a durable control plane is useful.

[Read the thread](https://github.com/aresyn/codex-control-plane-mcp/issues/6) · 2026-06-17 · closed · 1 comment

### Collect MCP client config examples

Collect working MCP client config snippets for common clients. Keep secrets out of examples and prefer copy-paste snippets that work with the PyPI package.

[Read the thread](https://github.com/aresyn/codex-control-plane-mcp/issues/5) · 2026-06-17 · open · 0 comments

### Add Docker/devcontainer smoke environment

Add a lightweight Docker or devcontainer setup for protocol smoke checks. This should help contributors run tests without needing a full local Codex Desktop setup.

[Read the thread](https://github.com/aresyn/codex-control-plane-mcp/issues/4) · 2026-06-17 · open · 0 comments

### Test live workflows on macOS

Run the live workflow checks on macOS and document what works, what is protocol-only, and what needs platform-specific handling before macOS can be claimed as a full live target.

[Read the thread](https://github.com/aresyn/codex-control-plane-mcp/issues/3) · 2026-06-17 · open · 0 comments

The remaining reports are on [the project's issue tracker](https://github.com/aresyn/codex-control-plane-mcp/issues).