Changelog

Full Changelog: v0.3.2-alpha.1...v0.3.2-alpha.2

• docs: explain schema versioning rationale (05d50bc)
• fix(switch): add explicit daemon restart and stale-auth recovery (#164) (7746e07)
• refactor(table): unify responsive column allocation across list and live views (#170) (64e2d6d)
• feat: expose credential expiry and reset credits in list output (#159) (ada9b7e)
• ci: allow manual workflow runs (2ae316b)

Changelog

Full Changelog: v0.3.1...v0.3.2-alpha.1

• test: silence library warnings in registry import tests (a56e38c)
• fix: install codext releases as package trees for app launches (8b1e1c9)

Changelog

Full Changelog: v0.3.0...v0.3.1

• docs: mention credits column in v0.3.0 changelog [skip ci] (0562816)
• docs: remove v0.2.x/alpha install notice from README [skip ci] (1c1c623)
• Nudge running codext app-server daemon to reload auth after switch (9a1bdcb)
• Revert "Nudge running codext app-server daemon to reload auth after switch" (4b5989e)
• fix: preserve UTF-8 characters when truncating account table labels (#165) (bd60dc4)

This release is a major rework since v0.2.x: the experimental background auto-switch is gone,
replaced by a foreground live TUI + explicit commands model, with new Codex App support,
JSON output, and several new account management commands.

✨ Highlights

Live TUI

• list --live, switch --live, remove --live: continuously refreshing table views with mouse-wheel scrolling and a copy-friendly layout.
• config live --interval <5-3600>: configure the live refresh interval (default 60s).
• list --active: refresh only the active account for a fast result.

New commands

• codex-auth app (experimental): injects the managed codext CLI through CODEX_CLI_PATH so the Codex App can switch accounts without a restart — new chats, resumed conversations, and continued conversations.
• codex-auth export [<dir>] / export --cpa: export stored auth snapshots or CLIProxyAPI token JSON.
• codex-auth alias set|clear <query> [<alias>]: set or clear an account alias.
• codex-auth clean: prune managed backups and stale snapshots; clean background removes background registrations left by older versions.

Account selection and switching

• codex-auth - and switch - jump back to the previous active account.
• Selectors are unified across commands: alias, email, display number, or partial query. remove accepts multiple selectors and --all.
• Support for API key accounts and phone-login organization accounts.

API and data

• --api / --skip-api control remote refresh per command (API-backed refresh is the default), replacing the global config api toggle.
• list shows CREDITS (credit balance) and RESET CREDITS columns.
• --json for list, switch <query>, and remove emits one machine-readable document under a schema_version: 1 compatibility contract — suitable for building a GUI on top. See docs/json-api.md.

Import

• Supports JSON array imports; CPA auth field handling is normalized.

💥 Breaking Changes

• Background auto-switch removed. config auto enable|disable, the threshold options, the systemd / LaunchAgent / scheduled-task services, and the codex-auth-auto binary are all gone. The tool now runs in the foreground only. Clean up old registrations with codex-auth clean background.
• codex-auth status removed, along with the global config api toggle — use per-command --api / --skip-api.
• list --debug removed.
• registry.json moves to schema_version = 4 (migrated automatically from 3). To downgrade to v0.2.x, manually set "schema_version": 3.
• Plan naming semantics changed: legacy team becomes business, legacy business becomes enterprise.
• Node.js is no longer required. All API requests go through curl, which must be available on PATH. Proxy settings are handled by curl's own environment variables.

🐛 Fixes and Improvements

• Windows: fixed Codex launcher resolution (.cmd, .bat, PowerShell wrappers), bypassed the PowerShell script policy for the .ps1 fallback, hid API child-process windows, and fixed list colors in Windows terminals.
• Login runs in an isolated scratch CODEX_HOME and syncs the active auth beforehand, so existing credentials are not disturbed.
• Credential files and account directories are created with restrictive (0600-style) permissions.
• Removed browser user-agent spoofing for ChatGPT API requests in favor of a codex-auth user agent.
• Upgraded to Zig 0.16.0; clearer usage error codes and registry version errors.

📖 Documentation

Added per-command documentation under docs/commands/, plus
docs/json-api.md, docs/api.md,
docs/schema-migration.md, and
docs/table-layout.md.

Changelog

Full Changelog: v0.3.0-alpha.9...v0.3.0-alpha.10

• docs(readme): update misleading version [skip ci] (d410605)
• fix: remove browser UA spoofing for ChatGPT API requests (#124) (5706e85)
• docs: document codex-auth user agent [skip ci] (f7cf942)
• docs: add alias command to README [skip ci] (1e1fc5e)
• refactor: replace Node.js with curl for API requests (#128) (e53c646)
• feat: add previous account switch (#133) (2ef8259)
• fix(cpa): normalize CPA auth field handling (#135) (b25c261)
• fix(registry): create private dirs with restrictive mode (#137) (ea770fe)
• fix(login): resolve Windows codex launchers (06e5742)
• fix(login): preserve missing launcher hint (c18c9c3)
• fix(login): preserve Windows launcher resolution order (a82e3f7)
• fix(login): keep PowerShell as fallback (6555192)
• fix(login): harden Windows launcher fallback (54c12ba)
• fix(login): narrow Windows launcher support (b82f3b3)
• fix(login): run Windows cmd launchers via cmd.exe (73a7018)
• fix(login): support Windows PowerShell wrappers (7c41e2b)
• fix(login): narrow Windows retry behavior (0fa4559)
• fix(login): clarify Windows launcher hints (6d5cce6)
• fix(login): prefer actionable Windows launch errors (2c1d49c)
• fix(login): simplify Windows Codex PATH resolution (86ed051)
• fix(login): restore native Windows cmd launch (577bb9f)
• fix(login): keep PowerShell as Windows fallback (d59c16d)
• fix(login): retry alternate Windows launchers (8f1d10f)
• docs: remove fallback note (af3d3b1)
• test(windows): fix launcher fallback fixtures (f40257c)
• fix(login): preserve PowerShell access denied fallback error (0617390)
• fix(login): support Windows batch codex launchers (e3ade54)
• fix(login): bypass PowerShell script policy for ps1 fallback (b7995d3)
• Merge pull request #142 from Loongphy/issue-139 (23f3857)

Changelog

Full Changelog: v0.2.9...v0.2.10

• fix: create login temp root (#136) (7f98b20)
• chore: release v0.2.10 (0642f6f)

Changelog

Full Changelog: v0.3.0-alpha.8...v0.3.0-alpha.9

• Improve registry version error (a9f681e)
• docs(readme): update document instructions (4361fe3)
• feat: support JSON array imports (#118) (ffe25ee)
• fix: create scratch CODEX_HOME before login (#120) (4ad1dd7)

Changelog

Full Changelog: v0.3.0-alpha.7...v0.3.0-alpha.8

• ci: gate releases on latest full main ci (8b72cb7)
• feat: remove persistent api config toggle (#97) (2ac689d)
• Hide API child process window on Windows (#96) (107253e)
• fix: update fake node batch detection (e2b19f2)
• fix: stabilize ci test fakes (baff8c6)
• fix: avoid blocking fake node stdin (b8e98d1)
• feat: add active-only list refresh (566fbe5)
• docs: update list active usage [skip ci] (d625469)
• feat: keep codex-auth foreground-only (#99) (39d2ece)
• ci: use commit sha in preview release comments (4a3e73e)
• feat: Support phone login auth organization accounts (#100) (04afba3)
• ci: limit windows zig test concurrency (64788cf)
• feat: add account alias command (#105) (5beb34b)
• fix: enable list colors on windows terminals (#108) (7bccd64)
• docs(README): update codex-auth login requirements [skip ci] (fa37ba0)
• fix: sync active auth before login (#113) (7fed35e)
• feat: new app command to support codex app account switching (#103) (070e28a)
• fix: isolate codex login (#117) (1fe8641)

Changelog

Full Changelog: v0.2.8...v0.2.9

• fix: isolate codex login auth import (#112) (aa6d1e4)
• chore: release v0.2.9 (ba9cd82)

Changelog

Full Changelog: v0.3.0-alpha.6...v0.3.0-alpha.7

• feat: Add API key support (#93) (46894ed)
• fix: also bump version in src/version.zig for v0.3.0-alpha.7 (bbfba4a)