Overview
add-codex is an open-source workflow skill for Codex, published by nanocoai. Its author describes it as: “Use Codex (OpenAI's codex app-server) as a full agent provider — planning, tool orchestration, MCP tools, server-side history, session resume — alongside or instead of Claude. ChatGPT subscription or OpenAI API key, v…”. The project has 31k stars on GitHub and is available under the MIT license. Add it to your setup with `git clone https://github.com/nanocoai/nanoclaw ~/.claude/skills/add-codex`.
What add-codex does
> Shortcut: `pnpm exec tsx setup/index.ts --step provider-auth codex` performs this whole install (manifest-driven from the providers branch: files, barrels, CLI manifest entry, image rebuild) plus auth in one command. The steps below are the same operations, for agent-driven or manual application.
What’s inside
The SKILL.md for add-codex is organised into these sections:
- Install
- Pre-flight
- 1. Fetch and copy the payload
- 2. Wire the barrels
- 3. CLI manifest
- 4. Build
- 5. Validate
- Authenticate
- Use it
- Default new groups to codex (optional)
- Troubleshooting
Installation
Add add-codex to your agent with:
git clone https://github.com/nanocoai/nanoclaw ~/.claude/skills/add-codexReview a skill’s source before installing it — skills can instruct your agent to run commands. This command comes from the skill’s public repository, which is the source of truth for setup steps. New to skills? Read how to install Claude Code skills.
Supported agents
- Claude Code — declared in the repository topics
- Codex — named in the skill.md
License
add-codex is published under the MIT license.
Strengths
- Clear MIT license — safe to read and adapt within its terms
- Ships in nanocoai/nanoclaw, an established project with 30,542 GitHub stars
- Works with Claude Code, Codex
- Actively maintained — repository updated in the last 90 days
Author
Topics
Alternatives to add-codex
Similar skills from other repositories:
Frequently asked questions
- What does add-codex do?
- Use Codex (OpenAI's codex app-server) as a full agent provider — planning, tool orchestration, MCP tools, server-side history, session resume — alongside or instead of Claude. ChatGPT subscription or OpenAI API key, vault-only via OneCLI. Per-group via `ncl groups config update --provider codex`. Distinct from using OpenAI as an MCP tool (where Claude remains the planner).
- How do I install add-codex?
- Run git clone https://github.com/nanocoai/nanoclaw ~/.claude/skills/add-codex in your agent, then reload your skills. Review the source at https://github.com/nanocoai/nanoclaw before installing.
- Is add-codex free to use?
- Yes. add-codex is free and open source under the MIT license, so you can read, run, and adapt it within that license's terms.
- Which agents does add-codex work with?
- add-codex lists Claude Code and Codex — named in its SKILL.md, its plugin marketplace or its repository topics. Skills use the portable SKILL.md format, so other agents that read that format may load it too.
- Where does add-codex come from?
- add-codex ships inside nanocoai/nanoclaw, a repository that contains 41 catalogued skills in total. The repository's 30,542 GitHub stars apply to that whole collection, not to this skill on its own.
