Skip to content

Latest commit

History

9,712 Commits

Folders and files

NameName
Last commit message
Last commit date

Repository files navigation

ApexCode — Codex+++

ApexCode is an independent open-source engineering control-plane project built on OpenAI Codex.

Status: bootstrap / experimental. ApexCode is not an official OpenAI product and is not endorsed by OpenAI.

ApexCode Status

These documents describe reviewed experimental candidates; they do not claim production readiness or official OpenAI endorsement.

The project focuses on capabilities around Codex rather than replacing its core unnecessarily:

  • persistent long-horizon task state
  • multi-agent role orchestration
  • evidence-driven completion gates
  • anti-destructive R0–R5 policy classification
  • provider-neutral model routing
  • isolated Git worktrees
  • browser/application verification
  • remote and fleet-aware engineering
  • reproducible ApexBench evaluation

ApexCode's core safety principle is:

Agent autonomy may increase. Authority does not automatically increase with it.

Current ApexCode-specific work is intentionally isolated under apexcode/ while integration points are validated. The current foundation is:

  • apex-policy: risk and authority classification
  • apex-task-state: persistent long-horizon state and safe transitions
  • apex-evidence: revision-bound proof and completion gates

These crates do not change upstream Codex runtime behavior.

Project documents:


Upstream Codex README

The content below is retained from the upstream Codex project for compatibility and attribution while ApexCode's integration evolves.

Codex CLI is a coding agent from OpenAI that runs locally on your computer.

Codex CLI splash


If you want Codex in your code editor (VS Code, Cursor, Windsurf), install in your IDE.
If you want the desktop app experience, run codex app or visit the Codex App page.
If you are looking for the cloud-based agent from OpenAI, Codex Web, go to chatgpt.com/codex.


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 | sh

Run the following on Windows to install Codex CLI:

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

The standalone installers download from https://releases.openai.com/codex by default and fall back to GitHub Releases if a metadata or asset download is unavailable. To force GitHub Releases, set CODEX_INSTALLER_USE_RELEASES_OPENAI_COM to false (0 and no are also accepted):

curl -fsSL https://chatgpt.com/codex/install.sh | CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false sh
$env:CODEX_INSTALLER_USE_RELEASES_OPENAI_COM='false'; 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 codex

Then simply run codex to get started.

You can also go to the latest GitHub Release and download the appropriate binary for your platform.

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
  • Linux
    • x86_64: codex-x86_64-unknown-linux-musl.tar.gz
    • arm64: codex-aarch64-unknown-linux-musl.tar.gz

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.

About

Production-grade autonomous engineering control plane built on OpenAI Codex.

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages