Claude Skill MartBrowse skillsQuick linesLearn by videoTerminal guideWhat is a Skill?
 
← Back to list

Add Codex Agent Provider (add-codex)

Installs, authenticates and enables OpenAI Codex (app-server) as a first-class agent backend in NanoClaw, switchable per group.

Dev & CodingAdvanced★ 30,829⑂ 12,827AI score 7/10Last updated: Sep 22, 2026

What it does

  • Copies the Codex provider payload from the providers branch into the host, container and setup trees.
  • Appends the import './codex.js'; self-registration line to five barrel files.
  • Merges a pinned @openai/codex entry into container/cli-tools.json and rebuilds the container image.
  • Runs the provider-contract verifier and the OneCLI vault auth walk-through (ChatGPT login or OpenAI API key — nothing stored in .env).
  • Documents per-group switching, optional instance default flip, and troubleshooting for boot failures, spawn codex ENOENT, and stale auth.

Who it's for

  • Operators running their own NanoClaw instance who want a non-Claude agent backend.
  • Teams that require credentials to live only in a vault, never in env files or the container.
  • Anyone who wants an agent to apply a deterministic, idempotent install straight from the doc.

Examples

  1. Ask "install the Codex provider" — the skill pre-flights, copies files, wires barrels, builds, and verifies.
  2. Move one group: ncl groups config update --id <group-id> --provider codex then ncl groups restart.
  3. Make new groups default to Codex by setting DEFAULT_AGENT_PROVIDER=codex and restarting the host service.

· · · Install guide · · ·

Try it now, no install

Paste this into Claude to use the skill without installing anything.

Read the instructions in this file and follow them to help me:
https://raw.githubusercontent.com/nanocoai/nanoclaw/HEAD/.claude/skills/add-codex/SKILL.md

What I want: (describe your task here)

If Claude can't open the link, open it yourself and paste the contents instead.

↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.

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 /tmp/nanoclaw && mkdir -p ~/.claude/skills && cp -r /tmp/nanoclaw/.claude/skills/add-codex ~/.claude/skills/

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

  1. Open a terminal.
  2. Clone the repo: git clone https://github.com/nanocoai/nanoclaw.git
  3. Copy the skill: mkdir -p ~/.claude/skills && cp -r nanoclaw/.claude/skills/add-codex ~/.claude/skills/
  4. Change into your NanoClaw project directory — this skill only works inside that repo.
  5. Confirm src/project-doc-compose.ts exists; if not, run /update-nanoclaw first.
  6. In Claude Code, ask it to "install the Codex provider using the add-codex skill", or run the one-shot command: pnpm exec tsx setup/index.ts --step provider-auth codex.
  7. Follow the prompts to log in with a ChatGPT subscription or paste an OpenAI API key; it is stored in the OneCLI vault.
View source on GitHub ↗License: MIT