Claude Skill MartBrowse skillsWhat is a Skill?
 
← Back to list

Add Codex Agent Provider

Installs OpenAI's Codex app-server as a first-class agent backend for NanoClaw, switchable per group.

Dev & CodingAdvanced★ 30,471⑂ 12,865AI score 6/10Last updated: Aug 9, 2026

What it does

Automates the full install of the OpenAI Codex app-server as an agent provider inside the NanoClaw project — alongside or instead of Claude.

  • Copies the Codex payload from the providers branch into the host, container and setup trees
  • Appends the self-registration import to all three provider barrels
  • Merges a pinned @openai/codex entry into container/cli-tools.json
  • Walks through build → tests → OneCLI vault authentication
  • Documents per-group switching and a troubleshooting checklist

Every nc: directive is idempotent, so re-running the skill is safe. Credentials are vault-only: no key in .env and nothing readable from inside the container.

Who it's for

  • NanoClaw operators who want different LLM backends per group
  • Developers with a ChatGPT subscription or OpenAI API key who want to benchmark Codex
  • Intermediate-to-advanced users comfortable with container rebuilds and pnpm/vitest/bun

Examples

  1. One-shot install: run pnpm exec tsx setup/index.ts --step provider-auth codex to copy files, wire barrels, rebuild the image and authenticate in one command.
  2. Switch a single group: ncl groups config update --id my-group --provider codex && ncl groups restart --id my-group — memory carries over because all providers share the memory/ tree.
  3. Debug a silent channel: grep 'Container exited non-zero' logs/nanoclaw.error.log; an Unknown provider: codex line means the barrels aren't wired into the running build.

· · · Install guide · · ·

Install in the Claude app (no terminal)
  1. Download the ZIP with the button below.
  2. In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
  3. Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
↓ Download ZIP
Install in Claude Code

Let Claude do it — paste this into Claude Code

Install the skill I found on Claude Skill Mart.
Copy the .claude/skills/add-codex folder from the GitHub repo nanocoai/nanoclaw into my ~/.claude/skills/add-codex/.
When it's done, tell me in one line what this skill can do.

Install with a command instead

git clone https://github.com/nanocoai/nanoclaw.git && mkdir -p ~/.claude/skills && cp -r nanoclaw/.claude/skills/add-codex ~/.claude/skills/

⚠ This is a third-party skill. Check the source repository before installing.

  1. Open a terminal and clone the repo: git clone https://github.com/nanocoai/nanoclaw.git
  2. The skill already lives at .claude/skills/add-codex. To use it globally run mkdir -p ~/.claude/skills && cp -r nanoclaw/.claude/skills/add-codex ~/.claude/skills/
  3. Enter the project and install dependencies: cd nanoclaw && pnpm install
  4. Launch Claude Code from the repo root and ask it to "install the Codex provider with the add-codex skill", or run pnpm exec tsx setup/index.ts --step provider-auth codex yourself
  5. Follow the prompts: sign in with your ChatGPT subscription or paste an OpenAI API key — it is stored in the OneCLI vault
  6. Verify the build: pnpm run build && ./container/build.sh
  7. Enable it for a group: ncl groups config update --id <group-id> --provider codex, then ncl groups restart --id <group-id>
View source on GitHub ↗License: MIT