Install any skill in seconds. Free to start, no credit card required.
Get Started Free →majiayu000/add-codex
Use Codex (CLI + AppServer) as the full agent provider — planning, tool orchestration, native compaction, MCP tools, session resume — in place of the Claude Agent SDK. ChatGPT subscription or OPENAI_API_KEY. Per-group via agent_provider. Distinct from using OpenAI as an MCP tool (where Claude remains the planner).
Passed 20 of 21 test cases with the skill, and 5 of 21 without it.
and 24 more in the full report
17 fixed4 passed either way0 still failing1 broke
Tokens, turns and time describe resource use, not a dollar price.
One of 16 test cases the skill fixed. Same model, same prompt, with and without the skill.
After adding the Codex provider source files to NanoClaw, what commands verify container TypeScript types and rebuild the Docker container image?
| Checked | Without skill | With skill |
|---|---|---|
| Specifies running pnpm exec tsc -p container/agent-runner/tsconfig.json --noEmit for container typechecking. | Missed | Passed |
| Specifies running ./container/build.sh to build the container image. | Missed | Passed |
The instructions your model reads when the skill loads.
NanoClaw runs agents in a long-lived poll loop inside the container. The backend is selected with AGENT_PROVIDER (claude | opencode | codex | mock).
Trunk ships with only the claude provider baked in. This skill copies the Codex provider files in from the providers branch, wires them into the host and container barrels, updates the Dockerfile to install the Codex CLI, and rebuilds the image.
The Codex provider runs codex app-server as a child process and speaks JSON-RPC over stdio. That gives it native session resume, streaming events, MCP tool access, and thread/compact/start compaction — same feature bar as the Claude Agent SDK, without the Anthropic-only lock-in.
If all of the following are already present, skip to Configuration:
src/providers/codex.tscontainer/agent-runner/src/providers/codex.tscontainer/agent-runner/src/providers/codex-app-server.tscontainer/agent-runner/src/providers/codex.factory.test.tsimport './codex.js'; line in src/providers/index.tsimport './codex.js'; line in container/agent-runner/src/providers/index.tsARG CODEX_VERSION and "@openai/codex@${CODEX_VERSION}" in the pnpm global-install block in container/DockerfileMissing pieces — continue below. All steps are idempotent; re-running is safe.
git fetch origin providers
Wholesale copies (owned entirely by this skill — user edits to these files won't survive a re-run, as designed):
git show origin/providers:src/providers/codex.ts > src/providers/codex.ts
git show origin/providers:container/agent-runner/src/providers/codex.ts > container/agent-runner/src/providers/codex.ts
git show origin/providers:container/agent-runner/src/providers/codex-app-server.ts > container/agent-runner/src/providers/codex-app-server.ts
git show origin/providers:container/agent-runner/src/providers/codex.factory.test.ts > container/agent-runner/src/providers/codex.factory.test.ts
test cases passed, vs 5 / 21 without
Published skills whose descriptions closely match this one, with their headline benchmark lift.
More skills from the same source and nearby in the registry, with their headline benchmark lift.