Repository navigation
Releases
Releases · ardasevinc/codex-helpers
codex-auth v0.3.6
Install
curl -fsSL https://raw.githubusercontent.com/ardasevinc/codex-helpers/main/install.sh | sh -s -- codex-authUpdate
curl -fsSL https://raw.githubusercontent.com/ardasevinc/codex-helpers/main/install.sh | sh -s -- codex-auth 0.3.6Direct Downloads
- codex-auth-darwin-arm64: https://github.com/ardasevinc/codex-helpers/releases/download/codex-auth-v0.3.6/codex-auth-darwin-arm64
- codex-auth-darwin-x64: https://github.com/ardasevinc/codex-helpers/releases/download/codex-auth-v0.3.6/codex-auth-darwin-x64
- codex-auth-linux-arm64: https://github.com/ardasevinc/codex-helpers/releases/download/codex-auth-v0.3.6/codex-auth-linux-arm64
- codex-auth-linux-x64: https://github.com/ardasevinc/codex-helpers/releases/download/codex-auth-v0.3.6/codex-auth-linux-x64
Changes
- Add
codex-auth update [version]withupgradealias for binary self-updates - Add
--checkand JSON output for update status reporting - Refuse self-update for Bun-linked, symlinked, or script-based installs with a clear installer fallback hint
- Add regression tests and local install/update coverage for the updater flow
codex-auth v0.3.5
Install
curl -fsSL https://raw.githubusercontent.com/ardasevinc/codex-helpers/main/install.sh | sh -s -- codex-authUpdate
curl -fsSL https://raw.githubusercontent.com/ardasevinc/codex-helpers/main/install.sh | sh -s -- codex-auth 0.3.5Direct Downloads
- codex-auth-darwin-arm64: https://github.com/ardasevinc/codex-helpers/releases/download/codex-auth-v0.3.5/codex-auth-darwin-arm64
- codex-auth-darwin-x64: https://github.com/ardasevinc/codex-helpers/releases/download/codex-auth-v0.3.5/codex-auth-darwin-x64
- codex-auth-linux-arm64: https://github.com/ardasevinc/codex-helpers/releases/download/codex-auth-v0.3.5/codex-auth-linux-arm64
- codex-auth-linux-x64: https://github.com/ardasevinc/codex-helpers/releases/download/codex-auth-v0.3.5/codex-auth-linux-x64
Changes
- Add live
watchcommand for current account usage with TUI-style terminal output and--oncesnapshot mode - Normalize usage credit balances to numbers and fix watch frame alignment/padding issues
- Migrate the
codex-authtest suite frombun:testto Vitest and add root/package gate scripts - Upgrade the release workflow to
actions/checkout@v5
codex-auth v0.3.4
Install
curl -fsSL https://raw.githubusercontent.com/ardasevinc/codex-helpers/main/install.sh | sh -s -- codex-authUpdate
curl -fsSL https://raw.githubusercontent.com/ardasevinc/codex-helpers/main/install.sh | sh -s -- codex-auth 0.3.4Direct Downloads
- codex-auth-darwin-arm64: https://github.com/ardasevinc/codex-helpers/releases/download/codex-auth-v0.3.4/codex-auth-darwin-arm64
- codex-auth-darwin-x64: https://github.com/ardasevinc/codex-helpers/releases/download/codex-auth-v0.3.4/codex-auth-darwin-x64
- codex-auth-linux-arm64: https://github.com/ardasevinc/codex-helpers/releases/download/codex-auth-v0.3.4/codex-auth-linux-arm64
- codex-auth-linux-x64: https://github.com/ardasevinc/codex-helpers/releases/download/codex-auth-v0.3.4/codex-auth-linux-x64
Changes
- add command aliases:
switch -> use,ls -> list,remove|rm -> delete - opt the release workflow into Node 24 for GitHub JavaScript actions
- add a release-notes helper so release descriptions include install/update commands and direct download URLs
codex-auth v0.3.3
Install
curl -fsSL https://raw.githubusercontent.com/ardasevinc/codex-helpers/main/install.sh | sh -s -- codex-authUpdate
curl -fsSL https://raw.githubusercontent.com/ardasevinc/codex-helpers/main/install.sh | sh -s -- codex-auth 0.3.3Direct Downloads
- codex-auth-darwin-arm64: https://github.com/ardasevinc/codex-helpers/releases/download/codex-auth-v0.3.3/codex-auth-darwin-arm64
- codex-auth-darwin-x64: https://github.com/ardasevinc/codex-helpers/releases/download/codex-auth-v0.3.3/codex-auth-darwin-x64
- codex-auth-linux-arm64: https://github.com/ardasevinc/codex-helpers/releases/download/codex-auth-v0.3.3/codex-auth-linux-arm64
- codex-auth-linux-x64: https://github.com/ardasevinc/codex-helpers/releases/download/codex-auth-v0.3.3/codex-auth-linux-x64
Changes
- add JSON output mode and agent-aware non-interactive behavior across the CLI
- support
-jas shorthand for--json - reject unknown flags instead of silently ignoring them
- add package-local
lint,typecheck,test, andgatescripts usingbun run - make display time assertions deterministic so the package test gate is stable
- document version shortcuts and the updated automation behavior
codex-auth v0.3.2
Fixes a destructive import footgun in codex-auth import.
- reject a single raw
auth.jsonpayload instead of creating junk accounts - validate each imported account blob before writing snapshots
- add regressions for raw
auth.jsoninput and malformed auth blobs - document that
importexpectscodex-auth exportJSON
codex-auth v0.3.1
Fix
- Support
-vand-Vflags for version output (citty only handles--versionnatively)
Install / upgrade
curl -fsSL https://raw.githubusercontent.com/ardasevinc/codex-helpers/main/install.sh | sh -s -- codex-authcodex-auth v0.3.0
What's new
codex-auth delete <name>— delete a saved account with confirmationcodex-auth prune— detect expired accounts and bulk-delete themcodex-auth list— now shows plan type (e.g.[plus]) and flags expired accounts with clear status messages
Expiry detection heuristics
Accounts are classified as expired when:
- Token refresh fails (session expired, token revoked, token conflict)
- Auth fails (HTTP 401/403 after refresh retry)
- Plan type is
free(subscription lapsed)
Transient errors (network timeouts, server errors) are not treated as expiry.
Install / upgrade
curl -fsSL https://raw.githubusercontent.com/ardasevinc/codex-helpers/main/install.sh | sh -s -- codex-authcodex-auth v0.2.1
Hardening patch.
- Add MIT license
- Fix atomicWrite to use same-directory temp files (prevents EXDEV on cross-filesystem setups)
- Validate account names at read time to prevent injection via malicious filenames
Full changelog: codex-auth-v0.2.0...codex-auth-v0.2.1
codex-auth v0.2.0
Multi-machine account sync for codex-auth.
What's new
codex-auth export— dump all accounts as JSON to stdoutcodex-auth import [--overwrite]— import accounts from JSON on stdincodex-auth push <host> [--overwrite]— push accounts to a remote host via SSH (no codex-auth needed on remote)
Usage
# Push to any VPS in one command
codex-auth push my-vps
# Or pipe between machines
codex-auth export | ssh vps 'codex-auth import'Install
curl -fsSL https://raw.githubusercontent.com/ardasevinc/codex-helpers/main/install.sh | sh -s -- codex-authFull changelog: codex-auth-v0.1.0...codex-auth-v0.2.0
codex-auth v0.1.0
Initial release of codex-auth — multi-account switching for Codex CLI with usage monitoring.
Install
curl -fsSL https://raw.githubusercontent.com/ardasevinc/codex-helpers/main/install.sh | sh -s -- codex-authCommands
codex-auth save <name>— save current sessioncodex-auth use [name]— switch accounts (interactive if no name)codex-auth list— list accounts with usagecodex-auth current— show active account