Awesome Codex CLI

A curated list of awesome tools, skills, subagents, plugins, and resources for OpenAI Codex CLI - the open-source AI coding agent that runs in your terminal.

Codex CLI is OpenAI's open-source terminal-based coding agent. It lets you use GPT models to write, refactor, debug, and reason about code directly from the command line - with sandboxed execution, multi-agent orchestration, MCP support, and a growing ecosystem of skills and plugins. Think of it as an AI pair programmer that lives in your terminal.

Why this list? The Codex CLI ecosystem is fragmented across dozens of repos - subagents here, skills there, plugins somewhere else. This list consolidates 150+ resources into one place, organized by feature category, with opinionated descriptions so you know what's actually worth your time.

Looking for Claude Code or Gemini CLI? Check the comparison table below.

If you find this useful, please give it a star - it helps others discover the list.

Contents

• Official Resources
• Getting Started
• AGENTS.md Templates
• Subagents
• Skills
• Plugins
• Hooks
• MCP Servers
• IDE & Editor Integrations
• GUI & Desktop Apps
• Session & Workflow Management
• Model Providers & Proxies
• CI/CD & Automation
• Cross-Agent Tools
• Monitoring & Analytics
• Docker & Sandboxing
• Account & Auth
• Tutorials & Articles
• Videos & Podcasts
• Comparisons
• Community
• Shell & Terminal
• Remote Access

Official Resources

• Documentation - Official docs covering setup, config, security, and all features.
• Config Reference - All 85+ config properties for config.toml.
• Skills Docs - How to create and use SKILL.md files.
• Subagents Docs - Multi-agent orchestration with .toml agent definitions.
• Plugins Docs - Distributable bundles of skills + apps + MCP servers.
• MCP Docs - Using Codex as MCP client and server.
• Hooks Docs - User-defined shell scripts in the agentic loop (beta).
• Security & Sandboxing - Seatbelt (macOS), Landlock/Bubblewrap (Linux), restricted-token (Windows).
• Non-interactive Mode - codex exec for CI/CD and scripting.
• Slash Commands - All 29 built-in commands: /plan, /skills, /fast, /fork, /review, etc.
• Best Practices - Official tips for getting the most out of Codex.
• Multi-Agent Guide - Parallel fan-out, max_threads, depth control.
• Workflows - Automation recipes and patterns.
• Exec Policy - Starlark-based fine-grained permission rules.
• Speed / Fast Mode - 1.5x speed, 2x credits.
• AGENTS.md Guide - Project-level instructions for Codex.
• Codex Web - Cloud-hosted Codex via ChatGPT.
• Codex for OSS Fund - Free Codex access for open-source maintainers.

Getting Started

• DataCamp Tutorial - Beginner-friendly walkthrough with screenshots. Good first read.
• Blott Studio Guide - Practical getting-started guide focused on real development workflow.
• Medium Quick Setup - 2-minute install-to-first-prompt guide. No fluff.
• OpenReplay Integration Guide - How to weave Codex into an existing dev workflow.
• Machine Learning Mastery - Command reference with examples for each mode.

AGENTS.md Templates

Project-level instruction files that tell Codex how to work with your codebase - the equivalent of Claude Code's CLAUDE.md.

• agents.md (Open Standard) - The cross-agent standard used by 20k+ projects. Works with Codex, Claude Code, Gemini CLI, and more.
• codex-cli-best-practice - Battle-tested AGENTS.md patterns with sandbox mode recommendations and approval policies.
• claude-codex-settings - Dual AGENTS.md + CLAUDE.md setup for teams running both agents side-by-side.
• caliber-ai-org/ai-setup - Cross-tool config generator - outputs AGENTS.md, CLAUDE.md, and .cursorrules from one source.

Subagents

Multi-agent orchestration with .toml definitions. Codex supports parallel fan-out with up to 6 threads by default.

Collections

• VoltAgent/awesome-codex-subagents - The definitive collection. 136+ agents across 10 categories (core dev, language specialists, infra, security, data/AI, DX, domains, business, meta, orchestration). Just clone and use.
• betterup/codex-cli-subagents - Enterprise-focused agents for code review, migration, and compliance.

Specialized Subagents

• leonardsellem/codex-specialized-subagents - Niche agents: accessibility auditor, i18n extractor, performance profiler. Fills gaps VoltAgent doesn't cover.
• CoderMageFox/claudecode-codex-subagents - Agents that work across both Codex and Claude Code. Good for mixed teams.
• Alexin09/cc-subagent-codex - Lightweight subagent pack focused on TypeScript/React projects.

Multi-Agent Orchestration

• basilisk-labs/codex-swarm - Swarm intelligence pattern - multiple Codex agents collaborating on large refactors.
• aannoo/hcom - Hierarchical agent communication framework. Agents delegate subtasks with context preservation.
• obra/external-subagents - Run subagents as external processes with custom sandboxing.

Skills

Reusable instruction bundles in SKILL.md format. Place in ~/.codex/skills/ (global) or .agents/skills/ (project).

Collections

• ComposioHQ/awesome-codex-skills - 38 skills across dev tools, productivity, communication, data analysis. Heavy Composio integration for 1000+ SaaS apps.
• heilcheng/awesome-agent-skills - Cross-platform skills that work in Codex, Claude Code, and Gemini CLI.
• Prat011/awesome-llm-skills - Platform-agnostic skills organized by use case.
• skillmatic-ai/awesome-agent-skills - Community-driven skill marketplace with quality ratings.
• proflead/codex-skills-library - Focused collection: code review, Git workflow, documentation generation.

Specialized Skills

• Upskill - Hugging Face's official skill pack for ML/AI development workflows.
• Mukul975/Anthropic-Cybersecurity-Skills - Security-focused skills: vulnerability scanning, dependency auditing, OWASP checks. Works in Codex too despite the name.
• nicepkg/ai-workflow - Workflow automation skills - chained multi-step tasks with conditional logic.
• cathrynlavery/codex-skill - Clean, well-documented single-purpose skills. Good reference for writing your own.
• Karanjot786/agent-skills-cli - CLI tool to discover, install, and manage skills from the community.

Domain-Specific Skills

• aklofas/kicad-happy - KiCad PCB design assistant. Proof that skills can go deep into niche domains.
• qtzx06/yolodex - Computer vision / YOLO model training workflow.
• Frankieli123/grok-skill - Log analysis and pattern matching. Useful for debugging production issues.

Plugins

Distributable bundles combining skills + app integrations + MCP servers. Defined in .codex-plugin/plugin.json. Browse with /plugins.

• hashgraph-online/awesome-codex-plugins - The first plugin directory. Lists 12 official + ~20 community plugins with install instructions.
• agent-sh/agentsys - Plugin framework with dependency resolution and version management.
• xmm/codex-bmad-skills - BMAD methodology plugin - structured planning, design, and implementation workflow.

Hooks

User-defined shell scripts that run at specific points in the agentic loop. Requires codex_hooks = true feature flag.

• shanraisshan/codex-cli-hooks - Starter hooks collection: pre-commit validation, cost tracking, notification triggers.
• liewcf/codex-notify-macos - macOS notification hook - get alerted when long-running tasks complete.

MCP Servers

Codex can connect to MCP servers (as client) and expose itself as an MCP server (codex mcp-server).

Codex as MCP Client

• tuannvm/codex-mcp-server - General-purpose MCP server for Codex with file operations, web search, and database queries.
• FYZAFH/mcp-codex-dev - Development-focused MCP server: linting, testing, deployment tools.
• cexll/codex-mcp-server - Lightweight MCP server with minimal dependencies. Good starting point for custom servers.
• Wildcard-Official/deepcontext-mcp - Codebase understanding server - builds semantic index for smarter code navigation.
• DeusData/codebase-memory-mcp - Persistent project memory across sessions. Codex remembers decisions, patterns, and context.
• Shelpuk-AI-Technology-Consulting/kindly-web-search-mcp-server - Web search MCP with rate limiting and caching.
• milisp/mcp-linker - Link multiple MCP servers together. Chain tools across servers.

Codex as MCP Server

• leonardsellem/codex-subagents-mcp - Expose Codex subagents as MCP tools. Other agents (Claude Code, Cursor) can call Codex agents.
• Mr-Tomahawk/codex-cli-mcp-tool - Wrap Codex CLI as an MCP tool for use in other agent frameworks.
• agency-ai-solutions/openai-codex-mcp - Full-featured Codex MCP bridge with streaming support.

General-Purpose MCP

• PleasePrompto/notebooklm-mcp - Connect Codex to NotebookLM for research-augmented coding.

IDE & Editor Integrations

• VS Code Extension (Official) - The official extension. Inline chat, terminal integration, code actions.
• johnseth97/codex.nvim - Neovim plugin with floating terminal, keybindings, and context passing.
• milanglacier/yarepl.nvim - REPL framework for Neovim. Supports Codex as a REPL target alongside Python, R, etc.
• xenodium/agent-shell - Emacs integration that works with Codex, Claude Code, and other terminal agents. Best-in-class Emacs experience.
• tninja/ai-code-interface.el - Emacs interface for multiple AI coding agents including Codex.
• bennfocus/codex-cli.el - Lightweight Emacs wrapper. Minimal, focused.
• dliedke/ClaudeCodeExtension - Visual Studio .NET extension that supports both Claude Code and Codex CLI.
• smallmain/vscode-unify-chat-provider - Unify multiple AI agents (Codex, Claude, Copilot) under one VS Code chat interface.

GUI & Desktop Apps

• milisp/codexia - Desktop GUI for Codex CLI. macOS/Windows/Linux. Visual session management, file tree, diff viewer.
• xintaofei/codeg - Electron-based GUI with project templates and one-click sandboxing.
• nkmr-jp/prompt-line - Minimal prompt-centric UI. Stays out of your way.
• zhu1090093659/CodeConductor - Orchestrator GUI for managing multiple Codex agents visually.

Session & Workflow Management

• UfoMiao/zcf - Zero-config workflow framework. Chain prompts, branch on results, auto-retry failures.
• gotalab/cc-sdd - Spec-driven development workflow. Write specs, Codex implements, auto-validates against spec.
• covibes/zeroshot - Zero-shot task runner. Describe what you want in plain English, get a working codebase.
• waskosky/codex-cli-farm - Run multiple Codex instances in parallel on different tasks. Session isolation built-in.
• joseferben/hands-please - Human-in-the-loop workflow. Codex pauses at decision points and asks for your input.

Model Providers & Proxies

Codex supports openai_base_url for custom model providers. Use any OpenAI-compatible API.

• feiskyer/codex-settings - Ready-to-use configs for LiteLLM, Ollama, LM Studio, OpenRouter, and Azure OpenAI.
• teabranch/open-responses-server - OpenAI Responses API-compatible server. Run Codex with local models.
• erans/lunaroute - Model router with cost tracking, rate limiting, and fallback chains.
• ben-vargas/ai-sdk-provider-codex-cli - Vercel AI SDK provider for Codex. Use Codex in your AI applications.

CI/CD & Automation

Use codex exec for non-interactive automation in pipelines.

• onurkanbakirci/awesome-codex-automations - 35 automation recipes organized by category: code quality, CI/CD, releases, deps, security.

Patterns

# Run Codex in CI to auto-fix lint errors
codex exec "Fix all ESLint errors in src/" --approval-mode full-auto

# Generate PR descriptions from diffs
git diff main | codex exec "Write a PR description for these changes"

# Pipe output for processing
codex exec "List all TODO comments" --ephemeral | sort

Cross-Agent Tools

Tools that bridge Codex with other AI coding agents.

• DeepMyst/Mysti - Universal agent orchestrator. Route tasks between Codex, Claude Code, and Gemini CLI based on model strengths.
• athola/skrills - Cross-platform skill format. Write once, use in Codex and Claude Code.
• jcputney/agent-peer-review - Codex reviews Claude Code's output (and vice versa). Catches model-specific blind spots.
• abhishekgahlot2/codex-claude-bridge - Run Codex and Claude Code in tandem on the same codebase.
• lbb00/ai-rules-sync - Sync AGENTS.md ↔ CLAUDE.md ↔ .cursorrules. One source, all formats.
• sypsyp97/claude-skill-codex - Run Codex CLI as a Claude Code skill.

Monitoring & Analytics

• NihilDigit/waybar-ai-usage - Waybar widget showing real-time Codex token usage and costs. Linux desktop integration.
• yoavf/ai-sessions-mcp - MCP server that tracks session history, token usage, and cost across agents.
• HizTam/codex-history-viewer - Browse and search past Codex sessions with full context.

Docker & Sandboxing

• Codex Universal - Official Docker base image. Pre-configured sandbox, multi-language support.

Account & Auth

• numman-ali/opencode-openai-codex-auth - Use your ChatGPT Plus/Pro subscription as a Codex auth source. The most popular auth tool.
• Lampese/codex-switcher - Switch between multiple OpenAI accounts. Useful for work/personal separation.
• bashar94/codex-cli-account-switcher - Simple account switcher with profile support.
• bddiudiu/cpa-codex-auth-sweep-cliproxy - Auth proxy for enterprise SSO environments.

Tutorials & Articles

• How Codex is Built (Pragmatic Engineer) - Deep technical dive into Codex's architecture. Rust, sandboxing, the TUI. Essential reading.
• Dogfood: Codex Builds Codex (Stack Overflow) - How the Codex team uses their own tool. Real-world workflow patterns.
• How Codex Team Uses Their Agent (Every) - Transcript of the team discussing daily usage, tips, and antipatterns.
• Why Humans are AI's Biggest Bottleneck (Lenny's Newsletter) - Broader perspective on AI coding agents, with Codex as a case study.
• Apidog: OpenAI Codex CLI - API-focused guide. Good for integrating Codex into existing toolchains.

Videos & Podcasts

Know a great video or podcast episode about Codex CLI? Submit it!

Comparisons

Codex CLI vs Claude Code vs Gemini CLI

Feature	Codex CLI	Claude Code	Gemini CLI
Language	Rust	TypeScript	Python
License	Apache-2.0	Proprietary	Apache-2.0
Pricing	ChatGPT Pro $20/mo or API usage	Max $100/mo or API usage	Free (Gemini API)
Config file	config.toml	settings.json	settings.json
Project instructions	AGENTS.md	CLAUDE.md	GEMINI.md
Sandbox	Seatbelt/Landlock/Bubblewrap	macOS Seatbelt, Linux containers	Docker-based
Multi-agent	Built-in (6 parallel threads)	Subagent spawning	Limited
Skills	SKILL.md files	Slash-command skills	N/A
Plugins	.codex-plugin/ bundles	N/A	Extensions
Hooks	Shell scripts (beta)	Pre/post hooks	N/A
MCP support	Client + Server	Client only	Client only
IDE	VS Code, Neovim, Emacs, Zed	VS Code, JetBrains, Web	VS Code
Auth	ChatGPT sub or API key	Anthropic API key	Google account
Models	GPT-5.x, o-series	Claude 4.x	Gemini 2.x
Non-interactive	codex exec	claude -p	gemini exec
Context window	200k tokens	200k tokens	1M tokens
Image input	Yes	Yes	Yes
GitHub stars		Closed source
Ecosystem size	Growing (plugins, skills, subagents)	Mature (MCP, skills, hooks)	Early (extensions)

Related Comparisons

• Hacker News Discussion - Community comparison thread with real-world experiences.
• Reddit AMA with Codex Team - Team answers questions about design decisions and how Codex differs from alternatives.
• duanyytop/agents-radar - Side-by-side benchmark of terminal AI agents on real coding tasks.

Community

• GitHub Discussions - Official discussion forum. Feature requests, bug reports, tips.
• Reddit r/ChatGPT - Active discussions about Codex CLI in the broader ChatGPT community.
• OpenAI Developer Forum - Official OpenAI community with Codex-specific threads.
• @OpenAIDevs on X - Official announcements and tips.

People to Follow

Codex CLI team members and frequent contributors:

• @thsottiaux - Tibo, Codex team.
• @embirico - Embiricos, Codex team.
• @jxnlco - Jason, Codex team.
• @romainhuet - Romain Huet, OpenAI DevRel.
• @dkundel - Dominik Kundel, OpenAI DevRel.
• @fouadmatin - Fouad Matin, Codex team.
• @bolinfest - Bolin Fest, Codex team.

Shell & Terminal

• tom-doerr/zsh_codex - Zsh plugin for AI-powered command completion using Codex.
• gravtice/ohmyzsh-ai-cli-plugins - Oh My Zsh plugins for AI coding agents.
• sadjow/codex-cli-nix - Nix flake for reproducible Codex CLI installation.
• kunal12203/Codex-CLI-Compact - Stripped-down Codex binary. Smaller install, faster startup.

Remote Access

• K9i-0/ccpocket - Access Codex from mobile devices via web UI.
• MackDing/CodexClaw - Telegram bot that proxies commands to a remote Codex instance.
• chuvadenovembro/script-to-use-codex-cli-on-remote-server - Headless server setup guide with auth workarounds.

Contributing

Contributions welcome! Please read the contribution guidelines first.

To the extent possible under law, the authors have waived all copyright and related or neighboring rights to this work.