
openai / codex
✓ Official★ 95,500A skill package that teaches your agent 12 capabilities — every one documented and browsable below, no GitHub required · by openai.
Each skill below is one capability this package teaches your agent. Install the whole package, or open a skill to install just that one.
Babysit a GitHub pull request after creation by continuously polling review comments, CI checks/workflow runs, and mergeability state until the PR is…
9 files — installable on its own
Run a final code review on a pull request
1 file — installable on its own
Change size guidance (800 lines)
1 file — installable on its own
Model visible context
1 file — installable on its own
Test authoring guidance
1 file — installable on its own
Diagnose GitHub bug reports in openai/codex. Use when given a GitHub issue URL from openai/codex and asked to decide next steps such as verifying against the…
1 file — installable on its own
Run a GitHub issue digest for openai/codex by feature-area labels, all areas, and configurable time windows. Use when asked to summarize recent Codex bug…
6 files — installable on its own
Update the title and body of one or more pull requests.
1 file — installable on its own
Create and scaffold plugin directories for Codex with a required `.codex-plugin/plugin.json`, optional plugin folders/files, and baseline placeholders you can…
14 files — installable on its own
How to run tests using remote executor.
1 file — installable on its own
Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Codex's…
13 files — installable on its own
Guide for testing Codex TUI interactively
1 file — installable on its own
Quickstart
Installing and running Codex CLI
Run the following on Mac or Linux to install Codex CLI:
curl -fsSL https://chatgpt.com/codex/install.sh | shRun the following on Windows to install Codex CLI:
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"Codex CLI can also be installed via the following package managers:
# Install using npm
npm install -g @openai/codex# Install using Homebrew
brew install --cask codexThen simply run codex to get started.
Each GitHub Release contains many executables, but in practice, you likely want one of these:
- macOS
- Apple Silicon/arm64:
codex-aarch64-apple-darwin.tar.gz - x86_64 (older Mac hardware):
codex-x86_64-apple-darwin.tar.gz
- Apple Silicon/arm64:
- Linux
- x86_64:
codex-x86_64-unknown-linux-musl.tar.gz - arm64:
codex-aarch64-unknown-linux-musl.tar.gz
- x86_64:
Each archive contains a single entry with the platform baked into the name (e.g., codex-x86_64-unknown-linux-musl), so you likely want to rename it to codex after extracting it.
Using Codex with your ChatGPT plan
Run codex and select Sign in with ChatGPT. We recommend signing into your ChatGPT account to use Codex as part of your Plus, Pro, Business, Edu, or Enterprise plan. Learn more about what's included in your ChatGPT plan.
You can also use Codex with an API key, but this requires additional setup.
Docs
This repository is licensed under the Apache-2.0 License.
Install the whole package (12 skills):
npx skills add https://github.com/openai/codexOr install a single skill:
npx skills add https://github.com/openai/codex --skill <name>Pick the skill name from the Skills tab — each entry there installs independently.