Codex CLI
kortix-ai/suna
Drive OpenAI's Codex CLI (codex exec) as a non-interactive coding sub-agent from inside Claude Code.
Delegates code generation, editing and explanation tasks to the OpenAI Codex CLI, with commands for interactive, auto-edit, question-only and model-specific runs.
Install OpenAI Codex CLI Bridge
$ npx skills add taracodlabs/aiden --skill codex -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install taracodlabs/aiden codex --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/taracodlabs/aiden.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/codex .claude/skills/codex && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "codex" agent skill from https://github.com/taracodlabs/aiden/tree/main/skills/codex into .claude/skills/codex/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "codex", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/taracodlabs/aiden/tree/main/skills/codexType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add taracodlabs/aiden --skill codex -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install taracodlabs/aiden codex --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/taracodlabs/aiden.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/codex .agents/skills/codex && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "codex" agent skill from https://github.com/taracodlabs/aiden/tree/main/skills/codex into .agents/skills/codex/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "codex", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add taracodlabs/aiden --skill codex -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install taracodlabs/aiden codex --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/taracodlabs/aiden.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/codex .cursor/skills/codex && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "codex" agent skill from https://github.com/taracodlabs/aiden/tree/main/skills/codex into .cursor/skills/codex/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "codex", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/taracodlabs/aiden.git --path skills/codex--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add taracodlabs/aiden --skill codex -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install taracodlabs/aiden codex --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/taracodlabs/aiden.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/codex .gemini/skills/codex && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "codex" agent skill from https://github.com/taracodlabs/aiden/tree/main/skills/codex into .gemini/skills/codex/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "codex", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install taracodlabs/aiden codexInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add taracodlabs/aiden --skill codex -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/taracodlabs/aiden.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/codex .github/skills/codex && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "codex" agent skill from https://github.com/taracodlabs/aiden/tree/main/skills/codex into .github/skills/codex/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "codex", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add taracodlabs/aiden --skill codex -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install taracodlabs/aiden codex --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/taracodlabs/aiden.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/codex .opencode/skills/codex && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "codex" agent skill from https://github.com/taracodlabs/aiden/tree/main/skills/codex into .opencode/skills/codex/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "codex", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
codex- GitHub stars
- 851
- Used in
- 1 other repo
- Token cost
- ~826 tokens
- SKILL.md length
- 270 words
- Files
- 2
- Skills in repo
- 63
- Repo updated
- First seen
- Licence
- Apache-2.0
At a glance
Delegates code generation, editing and explanation tasks to the OpenAI Codex CLI, with commands for interactive, auto-edit, question-only and model-specific runs.
- Works in 7 steps: Install Codex CLI → Run a coding task interactively → Non-interactive mode → …
- Handing a coding task to an OpenAI model instead of the current agent
- SKILL.md covers When to Use, How to Use, Examples and Cautions
- Calls codex and npm; needs OPENAI_API_KEY
What it does
The skill treats Codex CLI as an agentic coding loop running GPT-4o with sandboxed code execution, useful when you want an OpenAI model, sandboxed execution, an alternative to Claude Code, or a comparison between providers. Setup is a global npm install of `@openai/codex` on Node.js 18 or newer. The skill then shows how to run a task in a project folder, run non-interactively with `--approval-mode auto-edit`, pick a model with `--model`, ask a question with `--question` so nothing is edited, generate a new module, and explain existing code.
Cautions apply. The `full-auto` approval mode applies every change without confirmation, so it should run on a clean Git branch, Codex bills against your OpenAI API key, and `OPENAI_API_KEY` must be set in the environment first. The examples are written for PowerShell on Windows.
When your agent uses it
- Handing a coding task to an OpenAI model instead of the current agent
- Comparing code generation between providers
- Getting an explanation of existing code without modifying files
Example prompts
- “Use the Codex CLI to add input validation to every form field in the React components.”
- “Ask Codex in question mode what the middleware chain in src/app.ts does.”
- “Have Codex generate a TypeScript GitHub API client and save it to src/github-client.ts.”
Requirements
- Node.js 18 or newer
- The OpenAI Codex CLI installed with npm
- An OpenAI API key in OPENAI_API_KEY
Workflow steps
7 steps, taken from the step headings in SKILL.md.
What it can do on your machine
Read from SKILL.md and the folder at commit 3704204. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
codexnpm
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use npm, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names these keys or tokens, usually read from environment variables:
OPENAI_API_KEY
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
OpenAI Codex CLI Bridge loads about 826 tokens when it runs. Until then it costs about 12 tokens; SKILL.md has 270 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from taracodlabs/aiden at commit 3704204, republished under its Apache-2.0 licence (© taracodlabs). 270 words, ~826 tokens.
Download SKILL.mdSave it as
.claude/skills/codex/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.- name
- codex
- description
- Delegate coding tasks to OpenAI Codex CLI
- category
- agent-bridge
- version
- 1.0.0
- origin
- aiden
- license
- Apache-2.0
- tags
- openai, codex, cli, code-generation, agent-bridge, gpt, automation, coding, delegation
OpenAI Codex CLI Agent Bridge
Delegate code generation, editing, and explanation tasks to the OpenAI Codex CLI. Codex CLI runs GPT-4o in an agentic coding loop with sandboxed code execution.
When to Use
- User wants to generate code using OpenAI's GPT-4o model
- Task requires code execution in a sandboxed environment
- User wants an alternative to Claude Code using the OpenAI API
- User wants to benchmark or compare code generation between providers
- Task requires OpenAI-specific features or models
How to Use
1. Install Codex CLI
# Requires Node.js 18+
npm install -g @openai/codex
# Verify
codex --version
# Set API key
$env:OPENAI_API_KEY = "sk-..."2. Run a coding task interactively
Set-Location "C:\Users\<you>\myproject"
codex "Add input validation to all form fields in the React components"3. Non-interactive mode
# Auto-approve all edits (use with caution)
codex --approval-mode auto-edit "Add JSDoc comments to all exported functions in src/"
# Full auto mode (applies changes without confirmation)
codex --approval-mode full-auto "Fix all ESLint errors in the project"4. Use a specific model
# Use GPT-4o (default)
codex --model gpt-4o "Optimize the database query in src/db.js"
# Use GPT-4o-mini for faster, cheaper tasks
codex --model gpt-4o-mini "Add error handling to the fetch calls"5. Ask a coding question without editing files
# Question mode — returns explanation only
codex --question "What does the middleware chain in src/app.ts do?"6. Generate code from scratch
# Create a new file/module
codex "Create a TypeScript utility module with functions for:
- Formatting currency (Indian Rupee)
- Parsing date strings to Date objects
- Debouncing function calls
Save to src/utils/format.ts"7. Explain existing code
codex "Explain what the agentLoop.ts file does, focusing on the tool execution flow"Examples
"Generate a REST API client for the GitHub API in TypeScript"
→ Use step 6: codex "Create a TypeScript GitHub API client with methods for: list repos, create issue, get PR. Save to src/github-client.ts".
"Fix all TypeScript compilation errors in the project"
→ Use step 3 with --approval-mode auto-edit after reviewing what changes will be made.
"Explain how the authentication middleware works" → Use step 5 or 7 in question mode — returns an explanation without modifying files.
Cautions
--approval-mode full-autoapplies all changes without confirmation — always run on a clean git branch- Codex CLI bills against your OpenAI API key — monitor usage at platform.openai.com/usage
OPENAI_API_KEYmust be set in the environment before running any commands- Codex executes code in a sandbox but may read any files in the current directory — scope to the right project folder
- For very large codebases, provide a focused scope (specific file or module) rather than asking it to scan the entire project
© taracodlabs, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 1 other file in skills/codex of taracodlabs/aiden.
- SKILL.md
- skill.json
Open the folder on GitHubat commit 3704204
Used in 1 other repository
We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in taracodlabs/aiden, which our catalogue first saw on October 7, 2026.
Compare with similar skills
OpenAI Codex CLI Bridge next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| OpenAI Codex CLI Bridge this skilltaracodlabs/aiden | 851 | 1 repos | ~826 | Automated safety check: Pass | Apache-2.0 | |
| Codex CLIkortix-ai/suna | 20k | — | ~1.6k | Automated safety check: Pass | Custom licence | |
| WebGPTNhahan/WebGPT | 117 | — | ~1.4k | Automated safety check: Pass | MIT | |
| Skill Base CLIginuim/skill-base | 120 | 1 repos | ~1.9k | Automated safety check: Pass | None | |
| Codex Workflowsscasella/claude-dynamic-workflows-codex | 324 | — | ~13k | Automated safety check: Pass | MIT | |
| Fusion Setupmihneaptu/opencode-fusion | 217 | — | ~7.5k | Automated safety check: Pass | MIT |
Similar skills
WebGPT
Nhahan/WebGPT
Hands bounded tasks from Codex to a signed-in ChatGPT web session at a chosen reasoning level, or opens a terminal chat in your project that you control.
Skill Base CLI
ginuim/skill-base
Uses the skb command to search, install, update, delete, publish and import skills on a Skill Base site, including curated collections and GitHub imports.
Codex Workflows
scasella/claude-dynamic-workflows-codex
Run a dynamic-workflow script on a local Codex App Server — orchestrate many Codex / GPT agents (the agent / parallel / pipeline / phase / budget DSL) instead of Claude subagents, for codebase…
Fusion Setup
mihneaptu/opencode-fusion
A skill your agent uses when a user wants to set up, configure, install, or reconfigure the opencode Fusion agent team - a strong main/build agent that plans and reviews but cannot edit files…
Vinkius Deploy
vinkius-labs/mcpfusion
How to deploy MCP servers to Vinkius Edge using mcpfusion deploy.
More from taracodlabs/aiden
All 63 skills in this repoGoogle Flights Search
taracodlabs/aiden
Searches Google Flights for prices, schedules and availability through browser automation with URL-based queries, and stops short of booking.
Google Hotels Search
taracodlabs/aiden
Searches Google Hotels through the agent-browser tool for prices, ratings, amenities and availability, building a search URL from the location and dates and reporting a results table.
HTML Architecture Diagram Maker
taracodlabs/aiden
Generates dark-themed architecture, component, data-flow and network diagrams as self-contained HTML and SVG files that open in any browser.
Indian Broker Portfolio Bridge
taracodlabs/aiden
Aggregates holdings across Zerodha, Upstox and Angel One and normalizes order parameters into one format, with confirmation required before any routing.
arXiv Paper Search
taracodlabs/aiden
Searches arXiv by keyword, category, author or paper ID through its public API and downloads PDFs, with no API key needed.
ASCII Art Banners
taracodlabs/aiden
Produces ASCII text banners, cowsay-style speech bubbles and bordered boxes for terminal scripts, READMEs and CLI splash screens with pyfiglet, cowsay and boxes.
Related
Categories
Questions about OpenAI Codex CLI Bridge
What does OpenAI Codex CLI Bridge do?
Delegates code generation, editing and explanation tasks to the OpenAI Codex CLI, with commands for interactive, auto-edit, question-only and model-specific runs. The skill treats Codex CLI as an agentic coding loop running GPT-4o with sandboxed code execution, useful when you want an OpenAI model, sandboxed execution, an alternative to Claude Code, or a comparison between providers.js 18 or newer.
When should I use OpenAI Codex CLI Bridge?
OpenAI Codex CLI Bridge fits situations like: handing a coding task to an OpenAI model instead of the current agent; comparing code generation between providers; getting an explanation of existing code without modifying files.
How do I install OpenAI Codex CLI Bridge in Claude Code?
Run `npx skills add taracodlabs/aiden --skill codex -a claude-code`. Or copy the skill folder (skills/codex in taracodlabs/aiden) into .claude/skills/codex in your project. Claude Code loads it when a task matches its description.
How do I install OpenAI Codex CLI Bridge in Codex?
Run `npx skills add taracodlabs/aiden --skill codex -a codex`. Or copy the skill folder (skills/codex in taracodlabs/aiden) into .agents/skills/codex in your project. Codex loads it when a task matches its description.
Can I use OpenAI Codex CLI Bridge in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add taracodlabs/aiden --skill codex -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/codex, .gemini/skills/codex, .github/skills/codex and .opencode/skills/codex in your project.
What does OpenAI Codex CLI Bridge need to run?
Going by SKILL.md and its folder, OpenAI Codex CLI Bridge needs the command-line tools its instructions call (codex and npm) and credentials named OPENAI_API_KEY. Our summary lists: Node.js 18 or newer; The OpenAI Codex CLI installed with npm; An OpenAI API key in OPENAI_API_KEY.
Does OpenAI Codex CLI Bridge access the network?
SKILL.md contains no URLs. Its commands use npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
Is OpenAI Codex CLI Bridge safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does OpenAI Codex CLI Bridge use?
OpenAI Codex CLI Bridge is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does OpenAI Codex CLI Bridge use?
About 826 tokens (SKILL.md is roughly 3.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to OpenAI Codex CLI Bridge?
Skills that share tags, products or a category with OpenAI Codex CLI Bridge: Codex CLI (kortix-ai/suna, 20k stars), WebGPT (Nhahan/WebGPT, 117 stars), Skill Base CLI (ginuim/skill-base, 120 stars) and Codex Workflows (scasella/claude-dynamic-workflows-codex, 324 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains OpenAI Codex CLI Bridge?
taracodlabs (a GitHub organization) maintains it in taracodlabs/aiden, which has 851 GitHub stars. The repository holds 63 skills in this directory. The repository was last updated on September 13, 2026.
Source: taracodlabs/aiden on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.