2.2.1 - 2026-08-23

Release Notes

🔌 API

• (api) Document the preference keys that exist and stop mocking ones that don't

🚀 Features

• (contracts) Make the reading-session rules a shared file instead of test code

⚙️ Miscellaneous Tasks

• Wait out npm's registry propagation before installing the published SDK
• (changelog) Give API changes their own group and fix the group ordering
• Fail a PR that breaks the API contract, and check the spec is current first
• Report API contract changes on the PR instead of failing the job

Install codex 2.2.1

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/AshDevFr/codex/releases/download/v2.2.1/codex-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/AshDevFr/codex/releases/download/v2.2.1/codex-installer.ps1 | iex"

Download codex 2.2.1

File	Platform	Checksum
codex-aarch64-apple-darwin.tar.xz	Apple Silicon macOS	checksum
codex-x86_64-apple-darwin.tar.xz	Intel macOS	checksum
codex-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
codex-aarch64-unknown-linux-gnu.tar.xz	ARM64 Linux	checksum
codex-x86_64-unknown-linux-gnu.tar.xz	x64 Linux	checksum

Verifying GitHub Artifact Attestations

The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:

gh attestation verify <file-path of downloaded artifact> --repo AshDevFr/codex

You can also download the attestation from GitHub and verify against that directly:

gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>