skills.rest
roseDwayane
roseDwayaneCOMMUNITY
Explore all skills by this author →
GitHub

add-codex

Installs the Codex CLI provider into NanoClaw as an alternative agent backend.

1|Updated May 22, 2026
Search Tags:#cli#codex#docker#openai#nanoclaw#provider configuration#agent provider
One-click install
npx skills add https://github.com/roseDwayane/LocalizeAgenticSys --skill add-codex-rosedwayane
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: add-codex
Source: https://github.com/roseDwayane/LocalizeAgenticSys/tree/main/nanoclaw/.claude/skills/add-codex
Command: npx skills add https://github.com/roseDwayane/LocalizeAgenticSys --skill add-codex-rosedwayane

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @openai/codex.

What problem does it solve? NanoClaw ships with only the Claude Agent SDK as its agent backend. This Skill wires in OpenAI's Codex (CLI + AppServer) as a full agent provider — planning, tool orchestration, native compaction, MCP tools, and session resume — so agents can run on a ChatGPT subscription or OPENAI_API_KEY instead of Anthropic. ## Core Features & Use Cases - Provider Installation: Copies Codex provider source files from the providers branch into both the host (src/providers/) and container (container/agent-runner/src/providers/) trees, registers them via barrel imports, and adds the Codex CLI install layer to the container Dockerfile. - Registration Guards: Ships structural tests that verify the barrel imports and Dockerfile edits stay intact, going red if the wiring drifts. - Flexible Auth: Supports ChatGPT subscription OAuth (codex login), API key via OPENAI_API_KEY, or BYO OpenAI-compatible endpoints via OPENAI_BASE_URL, selectable per group with agent_provider. - Use Case: A team wants some NanoClaw groups to run on GPT models through their ChatGPT subscription while others stay on Claude — set "provider": "codex" in the group's container.json after running this Skill. ## Quick Start Ask the agent to install the Codex provider into NanoClaw and rebuild the container image, then set a test group's provider to codex.

Frequently Asked Questions about add-codex

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add Codex as an agent provider in NanoClaw?▼

Run this Skill to copy the Codex provider files from the providers branch, add `import './codex.js';` to both provider barrels, add the Codex CLI install layer to container/Dockerfile, then rebuild with `pnpm run build` and `./container/build.sh`.

How do I switch a NanoClaw group to use Codex instead of Claude?▼

Set `"provider": "codex"` in the group's `groups/<folder>/container.json` file. The in-container runner reads the provider from container.json; the DB columns `agent_provider` only drive host-side env passthrough and mounts.

Can I use Codex with a ChatGPT subscription instead of an API key?▼

Yes. Run `codex login` on the host to write `~/.codex/auth.json` with a subscription token. The host provider copies it into a per-session `~/.codex` directory mounted into the container, with no `.env` variables required.

Does the Codex provider support OpenAI-compatible endpoints like Groq?▼

Yes, experimentally. Set `OPENAI_BASE_URL` to any OpenAI-compatible endpoint such as Groq or a self-hosted vLLM server along with `OPENAI_API_KEY` and `CODEX_MODEL`. Tool-calling quality depends on the model and endpoint.

How do I remove the Codex provider from NanoClaw?▼

Follow the bundled REMOVE.md: delete the barrel import lines, remove the copied provider files, revert the Dockerfile ARG and install layer, unset Codex env vars, then rebuild and restart. The steps are idempotent.

Related Skills

Explore More Software Engineering Skills→
RADHA0-maxRADHA0-max
2

update-skills

Re-applies installed skills to fetch their latest code from upstream git branches.

Community
Intermediate
thmtzthmtz
5

add-ollama-provider

Route NanoClaw agent groups to a local Ollama model via configuration changes.

Community
Advanced
gabesan21gabesan21
1

coding-sandbox

Proposes and operates confirmed local Docker sandboxes for coding agents.

Community
Advanced
GayanKavindaGayanKavinda

claude-api

Build and migrate Claude API integrations across multiple SDKs.

Community
Advanced