MCP Codex Worker

Stop feeding Codex giant diffs. Delegate expensive code-reading and repair loops to a cheaper async worker, then return only compact, verified results.

View on GitHub Quick start

The Plain Flow

Codex Plans, reviews, decides.
->
MCP Worker Runs Claude Code in the background.
->
Cheap Gateway Handles bulky model tokens.
Back to Codex: changed files, checks, logs, and optional diff.

Before And After

Without Worker

Codex reads large files, watches repair loops, ingests full diffs, and burns premium context on repetitive implementation work.

With Worker

Codex sends one compact task. The worker reads, edits, tests, and returns evidence that Codex can review quickly.

Why Teams Use It

Cleaner Codex Context

Codex sees evidence, not every intermediate file read and patch attempt.

Cheaper Backends

The local adapter translates Claude Code traffic to OpenAI-compatible gateways.

Verification First

Scoped patch checks, test commands, deterministic assessment, and bounded auto-revise keep results auditable.

Quick Start

npm install
npm run build
npm run test
npm run smoke
Configure real gateway credentials through environment variables. Never commit provider keys.

Best Fit

Large Code Reads

Move repository exploration out of the premium orchestration context.

Scoped Fixes

Let the worker patch and run checks while Codex keeps the decision surface small.

Read-Only Summaries

Use the lite analyze tool when a full Claude Code loop would be overkill.