/awesome-codex-cli

A curated list of awesome resources, tools, and tutorials for OpenAI Codex CLI

Creative Commons Zero v1.0 UniversalCC0-1.0

icon

Awesome Codex CLI 🚀

Awesome Stars

A curated list of awesome resources, tools, and tutorials for OpenAI Codex CLI - the lightweight coding agent that runs in your terminal.

Codex CLI | Codex Web | Codexia GUI

What is OpenAI Codex CLI?

OpenAI Codex CLI is an open-source command-line tool that brings the power of OpenAI's latest reasoning models directly to your terminal. It acts as a lightweight coding agent that can read, modify, and run code on your local machine to help you build features faster, squash bugs, and understand unfamiliar code.

Key Features

  • 🔒 Privacy First: Your source code never leaves your environment - all operations happen locally
  • ⚡ Zero Setup: Single command installation with npm install -g @openai/codex
  • 🖼️ Multimodal: Support for text, screenshots, and diagrams as inputs
  • 🤖 Model Flexibility: Supports GPT-5, o3, o4-mini, and third-party models
  • 🌍 Cross-Platform: Official support for macOS and Linux (Windows via WSL)

Installation & Setup

Quick Start

npm install -g @openai/codex # Alternatively: `brew install codex`
codex

Reasoning high

codex -m gpt-5 -c model_reasoning_effort="high"

Ollama

ollama download - open models

codex --oss -m gpt-oss:20b

Requirements

  • Node.js and npm
  • ChatGPT Plus, Pro, or Team account
  • macOS or Linux (Windows via WSL)

Configuration

~/.codex/config.toml

[model_providers.gemini]
name = "gemini"
base_url = "https://generativelanguage.googleapis.com/v1beta/openai"
env_key = "GEMINI_API_KEY"

[profiles.gemini]
model_provider = "gemini"
model = "gemini-2.5-pro"

after config

codex --profile gemini

Official Resources

Documentation

Blog Posts & Tutorials

GUI & Web Interface Extensions

Official Web Interface

  • Codex Web - Official cloud-based agent with web interface
  • Cloud Codex - Sandbox environments preloaded with repositories (ChatGPT Pro/Enterprise/Team/Plus users)

GUI Desktop Applications

  • Codexia - Modern GUI for OpenAI Codex CLI with multi-session support and real-time streaming (Tauri v2)

IDE Integrations

  • Codex VS Code Extension: Codex is OpenAI's coding agent that helps you write, review, and ship code faster. Use it side-by-side in your IDE or delegate larger tasks to the cloud.
  • Codexia VS Code Extension: A VS Code extension that provides a chat interface for the OpenAI Codex CLI, allowing you to interact with AI coding assistants directly from your editor.

Use Cases

Development Tasks

  • Refactoring: Modernize legacy code and improve structure
  • Testing: Generate comprehensive test suites
  • Bug Fixes: Identify and resolve issues quickly
  • Documentation: Generate and maintain code documentation
  • Feature Development: Scaffold new features and components

Specialized Tasks

  • Frontend Development: React components, CSS generation, responsive designs
  • Data Analysis: Dataset exploration, Python scripting, ML projects
  • Code Understanding: Legacy code analysis, code reviews, architecture insights

Community

Discussions

Learning Resources

  • Apidog Blog - Open source coding agent overview
  • Community tutorials and examples (contribute yours!)

Community Projects

  • Plux - AI finder/explorer with visual file tree and one-click @files to AI context
  • MCP-Linker - Cross-platform GUI for managing MCP configs across AI clients
  • awesome-claude-dxt - Curated list of Claude Desktop Extensions
  • awesome-gpt-oss - Curated GPT open-source resources and tools
  • awesome-chatgpt-claude-agents - A curated collection of awesome ChatGPT & Claude agents, subagents, and AI-powered development tools

Contributing

This is an awesome list! Contributions are welcome. Please:

  1. Read the contribution guidelines first
  2. Check existing resources to avoid duplicates
  3. Ensure links are working and relevant
  4. Follow the established format
  5. Submit a pull request with clear descriptions

Related Projects

License

CC0

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