https://github.com/felixwardus/codex-npm-check
Check whether Codex CLI npm releases include the platform packages you need.
https://github.com/felixwardus/codex-npm-check
cli cli-tool codex-cli devtools github-actions nodejs npm npm-package openai-codex openai-codex-cli release-checker release-monitoring
Last synced: about 22 hours ago
JSON representation
Check whether Codex CLI npm releases include the platform packages you need.
- Host: GitHub
- URL: https://github.com/felixwardus/codex-npm-check
- Owner: FelixWardUS
- License: mit
- Created: 2026-04-23T23:55:42.000Z (3 days ago)
- Default Branch: main
- Last Pushed: 2026-04-26T03:51:46.000Z (about 23 hours ago)
- Last Synced: 2026-04-26T04:22:29.484Z (about 23 hours ago)
- Topics: cli, cli-tool, codex-cli, devtools, github-actions, nodejs, npm, npm-package, openai-codex, openai-codex-cli, release-checker, release-monitoring
- Language: JavaScript
- Homepage: https://github.com/FelixWardUS/check-codex-release#readme
- Size: 37.1 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# codex-npm-check
[](https://github.com/FelixWardUS/codex-npm-check/actions/workflows/ci.yml)
[](https://www.npmjs.com/package/codex-npm-check)
[](LICENSE)
[](package.json)
Check whether a Codex CLI npm release is actually ready before you install or
upgrade it.
`cnc` verifies the main `@openai/codex` package and the platform builds you care
about. It checks both npm metadata and the real tarball URLs, using your
configured npm registry plus the official npm registry.
## Install
```bash
npm install -g codex-npm-check
cnc
```
On first run, `cnc` asks which platforms to check and how many latest stable
Codex versions to inspect.
## Usage
```bash
cnc
cnc 0.124.0
cnc --platform linux-x64,darwin-arm64 --latest 3
cnc 0.124.0 --platform win32-x64 --json
cnc --set
cnc --show
cnc --reset
```
- `cnc` checks the latest stable releases with your saved config.
- `cnc 0.124.0` checks one specific Codex version.
- `--platform` overrides platforms for one run.
- `--latest` overrides how many latest stable versions to check.
- `--json` prints machine-readable output.
- `--set`, `--show`, and `--reset` manage saved config.
## Output
```text
Checking latest 3 stable releases...
0.124.0: issues found ❌
main package: OK ✅
linux-x64: issues found ❌
configured: OK ✅
official: tarball unavailable ❌
darwin-arm64: OK ✅
0.123.0: OK ✅
main package: OK ✅
linux-x64: OK ✅
darwin-arm64: OK ✅
```
If any selected package is missing metadata or has an unavailable tarball in any
checked registry, `cnc` exits non-zero.
## What It Catches
`cnc` catches npm publishing and registry problems, including:
- Missing `@openai/codex` release metadata.
- Missing platform build metadata, such as `@openai/codex@0.124.0-win32-x64`.
- Tarball URLs that exist in metadata but return an error.
- Mirror registry drift from the official npm registry.
It does not run Codex after install, so it will not catch runtime bugs, macOS
signing problems, config regressions, or local npm optional dependency bugs when
the packages and tarballs are already available.
## Platforms
- `linux-x64`
- `linux-arm64`
- `darwin-x64`
- `darwin-arm64`
- `win32-x64`
- `win32-arm64`
## Config
Config is stored at:
- `~/.config/codex-npm-check/config.json`
- `$XDG_CONFIG_HOME/codex-npm-check/config.json`
Tests and scripts can override the config base directory with `CNC_CONFIG_HOME`.
## Development
```bash
git clone https://github.com/FelixWardUS/codex-npm-check.git
cd codex-npm-check
npm test
npm install -g .
```
Requires Node.js 20+ and `npm` in `PATH`.