Neura Market
aresyn/codex-control-plane-mcp logo

aresyn/codex-control-plane-mcp

Free

面向 Codex Desktop 长任务的持久化 MCP 控制平面，统一调度、跟踪与恢复长时运行的智能体任务，让 AI 可靠地驱动长周期编码工作流。

FreeFree tier
Type
Open Source
Visit Website GitHub (40 stars)

About aresyn/codex-control-plane-mcp

Codex Control Plane MCP turns Codex Desktop and codex-app-server into a durable worker that an MCP client can drive safely for long-running tasks. It provides an async queue for Codex write operations, retry-safe client_request_id handling, active duplicate prompt detection, SQLite leases and heartbeats for competing MCP processes, and recovery after crashes. Clients submit a task and immediately receive an operationId or workflowId. They can poll status, answer approvals or approve plans in Plan Mode, and then read the final report. The server handles app-server startup, thread and turn creation, retry safety, duplicate prompt protection, Plan Mode, approvals, local history, diagnostics, and repair. OpenClaw and Hermes are first-class clients, but the server is useful for any local orchestrator that needs Codex Desktop to do long-running work without holding one MCP call open for hours.

Key Features

Durable async queue for Codex write operations
Retry-safe client_request_id handling
Active duplicate prompt detection
SQLite leases and heartbeats for competing MCP processes
Recovery after crashes
Plan Mode workflow support with pollable state and approvals
Local history and diagnostics
Approvals and pending interactions handling

Pros & Cons

Pros
  • Durable async operation eliminates blocking multi-hour MCP calls
  • Client timeout recovery and retry-safe design
  • Duplicate turn protection prevents redundant Codex executions
  • Pollable workflow state with Plan Mode and approval support
  • Persisted operation state survives restarts
  • Includes health, diagnostics, and repair tools
Cons
  • Full live support only on Windows with Codex Desktop and codex-app-server; Linux and macOS limited to protocol-level checks
  • Local-first design; not intended for public network exposure without authentication
  • Requires Codex Desktop and codex-app-server to be installed

Best For

Running long-duration code modifications with Codex DesktopOrchestrating Plan Mode approval workflowsAutomating multi-step software development tasksHandling client recovery and duplicate prevention in long-running agent tasksLocal CI/CD integration with Codex Desktop

FAQ

Why not just call Codex directly?
A thin Codex wrapper blocks on multi-hour tasks, has fragile client timeout recovery, no duplicate turn protection, no active prompt detection, manual Plan Mode workflow, blocking approvals, no persisted state, and limited diagnostics. Codex Control Plane MCP provides durable async operation, retry safety, duplicate protection, pollable workflow state, and comprehensive diagnostics.
What platforms are supported?
Full live target is Windows with Codex Desktop and codex-app-server. Linux and macOS have protocol-only checks for now.
Is this tool safe to expose as a network service?
No. It is a local-first control plane for trusted Codex Desktop environments. Do not expose it as a network service without authentication.