Skip to content

Retro2512/CodexZero

Repository files navigation

CodexZero

Zero Wasted Tokens, Same Benchmark Scores & Quality, More Usage Limits, Less Cost

Highest recorded token reduction for CodexZero Max, CodexZero, RTK, standard Codex, Caveman, and RTK plus Caveman

CI Release License: MIT

CodexZero recorded the largest token reduction in our completed comparisons. In the strongest repeated benchmark, it:

  • used 15% fewer tokens
  • matched Codex’s 29/36 task score
  • processed 3.89 million fewer tokens
  • ran the same 12 software tasks three times per setup

CodexZero installs beside Codex. Your regular CLI remains available, and the full command result stays available whenever Codex needs it.

Install

Windows

irm https://raw.githubusercontent.com/Retro2512/CodexZero/main/scripts/bootstrap.ps1 | iex

macOS

curl -fsSL https://raw.githubusercontent.com/Retro2512/CodexZero/main/scripts/bootstrap.sh | sh

Release packages include the runtime. Supported targets are Windows x64, Intel Mac, and Apple silicon Mac.

Prefer to inspect the installer first? Open the Windows script, macOS script, or latest release.

Run it

codex-zero run

Use the optimized side-by-side CLI.

codex-zero savings

See the tokens CodexZero saved on your own work.

codex-zero stock

Open regular Codex at any time.

The repeated result

Regular Codex processed 26.58 million tokens and CodexZero processed 22.69 million while both scored 29 out of 36; CodexZero Max is projected at 19.62 million

Codex and CodexZero each completed 12 software tasks three times. CodexZero matched the final task score while processing 22.69 million tokens instead of 26.58 million.

Benchmark summary

How it works

CodexZero keeps the original command result available, removes repeated text when that produces a smaller result, and otherwise leaves the result alone.

  1. Your command runs normally.
  2. CodexZero saves the full result locally.
  3. Repeated output can be represented more briefly.
  4. If the shorter result does not save tokens, Codex receives the original.

Your model, reasoning level, tools, project instructions, permissions, and existing Codex installation remain under your control.

Settings

Standard is the default and keeps Codex’s normal model instructions. This is the setting used for the repeated 15% result.

codex-zero mode safe

Max Savings uses a leaner setup for repeatable work. Switch back whenever you want.

codex-zero mode max-save

Compatibility

  • Windows x64
  • Intel Mac
  • Apple silicon Mac
  • Codex CLI and Codex Desktop
  • Node.js 20+ for source-checkout development

For Desktop, quit Codex completely before running:

codex-zero desktop

Trust and control

  • CodexZero is free and open source under the MIT license.
  • Regular Codex remains available through codex-zero stock.
  • Full command results stay available locally.
  • Errors, warnings, exit codes, and non-repeated lines are preserved.
  • codex-zero savings reports measured local results rather than a universal estimate.

Token reductions do not translate directly into the same percentage reduction on every bill or plan. Output, caching, pricing, and workload shape the final result.

More information

CodexZero is an independent project and is not an official OpenAI product.

About

Measured, monotonic, lossless input savings for Codex.

Topics

Resources

Contributing

Security policy

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages