v0.1.9

Release date: 2026-03-13
Channel: latest

Highlights

• Preserved distinct business accounts that share a workspace accountId so no-email login, refresh, and restore paths stop overwriting sibling seats.
• Aligned guarded identity matching across runtime login, CLI recovery, storage normalization, import preview/apply, and entitlement tracking.
• Hardened rollback and regression coverage for concurrent persistence, flagged-account recovery, malformed-token rows, and shared-workspace edge cases.

Install

npm i -g @openai/codex
npm i -g codex-multi-auth

Core Operations

codex auth login
codex auth list
codex auth status
codex auth check
codex auth forecast --live

Validation Snapshot

Release gate commands:

• npm run clean:repo:check
• npm run audit:ci
• npm run lint
• npm test -- test/documentation.test.ts
• npm test -- test/accounts.test.ts test/oc-chatgpt-import-adapter.test.ts test/index.test.ts test/storage.test.ts test/codex-manager-cli.test.ts test/entitlement-cache.test.ts

Broad validation result:

• repo-hygiene check passed
• npm run audit:ci passed at the configured high-severity threshold; the remaining hono advisory stayed below that gate
• npm run lint passed
• 19/19 documentation integrity tests passed after promoting the new stable release notes
• 6/6 targeted shared-account regression suites passed (405/405 tests)

Known baseline blockers observed during release validation:

• npm run typecheck fails on both origin/main and this release branch because the workspace cannot currently resolve @codex-ai/plugin/tool and already carries unrelated TypeScript errors outside #90
• npm run build remains blocked by the same pre-existing typecheck baseline

Merged PRs

• #90 fix: preserve business accounts that share a workspace accountId

Commits

• PR #90 carries the guarded account-identity matching fixes and regression coverage that preserve shared-workspace business accounts across login, import, flagged recovery, storage normalization, and entitlement tracking.
• The release bump in this branch promotes 0.1.9 in package metadata and refreshes the stable release-note links in the root docs surfaces.

Notes

• Bare accountId fallback now only applies when the no-email case is unambiguous.
• Entitlement cache identity now prefers the fresh email resolved from the latest token material and avoids refresh-token-derived keys.
• CLI and runtime persistence paths now share the same guarded account matching behavior for shared-workspace business accounts.

Related

• ../getting-started.md
• ../upgrade.md
• ../reference/commands.md

v0.1.8

Release date: 2026-03-11
Channel: latest

Highlights

• Folded the remaining stacked settings and sync work into the stable release, including experimental settings flows, backend primitive extraction, and wrapper non-TTY behavior docs.
• Hardened account and flagged-account reset recovery so intentional clears suppress stale revival paths even when primary files survive an initial delete failure.
• Kept Codex CLI sync mirror-only while adding preview-first oc-chatgpt sync, named backup export, and richer target detection on top of the same canonical storage model.

Install

npm i -g @openai/codex
npm i -g codex-multi-auth

Core Operations

codex auth login
codex auth list
codex auth status
codex auth check
codex auth forecast --live

Validation Snapshot

Release gate commands:

• npm ci
• npm run clean:repo:check
• npm run audit:ci
• npm run typecheck
• npm run lint
• npm test
• npm run build
• npm run coverage
• npm run test:model-matrix:smoke

Broad validation result:

• 105/105 test files passed
• 2456/2456 tests passed
• full coverage pass on the all-inclusive release branch
• model-matrix smoke completed with only skipped cases for the current runtime/account capability set after the entitlement-aware harness fix

Merged PRs

• #64 test(settings): split persistence regression coverage
• #65 test(settings): split cli settings harness coverage
• #61 feat(settings): add experimental settings flows
• #63 docs(cli): document wrapper non-TTY behavior
• #71 fix(storage): harden recovery and intentional reset flows
• #72 fix(sync): keep Codex CLI state mirror-only
• #74 feat(sync): extract backend primitives for the sync stack

Commits

• Replacement RC assembled from main plus the original release branch and the previously open stacked branches for #65, #74, #61, and #63.
• Stack prerequisite work from split/pr58-sync-orchestrator is included because #61 depends on it.
• Release-only follow-up commit 961c3db formalizes the flagged reset edge-case fix, the entitlement-aware smoke harness update, and the fresh-worktree documentation-test fix needed to keep the validation gate reproducible.
• Release-only follow-up commit c946d08 adds broad merged-feature regression coverage.
• Release-only follow-up commit 8ee10e3 restores backup metadata, restore assessment, and transaction-safe named backup export behavior after the all-open merge.

Notes

• Flagged-account clears now remain suppressed when the reset marker exists, even if the primary flagged file survives an initial delete failure.
• Smoke-matrix results now distinguish unsupported account/runtime capabilities from true release-blocking failures.
• The current smoke run was environment-inconclusive rather than failing: no supported live model completed in this account/runtime, but no hard harness or transformer failures remained.
• Broad release regressions now verify that Codex CLI mirror files cannot mutate canonical storage or unified settings, that flagged reset suppression still holds when mirror files exist, and that the experimental sync/backup stack continues to validate as part of the full merged branch.

Related

• ../getting-started.md
• ../upgrade.md
• ../reference/commands.md

v0.1.7

Release v0.1.7

Release date: 2026-03-03
Channel: latest

Highlights

• Hardened Windows global command routing so multi-auth survives Codex npm shim takeovers across codex.bat, codex.cmd, and codex.ps1.
• Added stock-shim signature replacement and invocation-path-first shim resolution to avoid false PATH matches and stale launcher routing.
• Added PowerShell profile guard installation so new PowerShell sessions keep resolving codex to the multi-auth wrapper.
• Strengthened account recovery by auto-promoting discovered real backups when primary storage is synthetic fixture data (including missing accountId fixture rows).
• Hardened Codex auth sync writes by enriching active account payloads with complete token shape (access_token, refresh_token, id_token) to prevent malformed auth fallbacks.
• Added visible dashboard version label in TUI header (Accounts Dashboard (vX.Y.Z)).

Install

npm i -g @openai/codex
npm i -g codex-multi-auth

Core Operations

codex auth login
codex auth list
codex auth switch 2
codex auth status
codex auth check
codex auth forecast --live

Validation Snapshot

Release gate commands:

• npm run lint
• npm run typecheck
• npm run build
• npm test

Broad validation result:

• 100/100 test files passed
• 2328/2328 tests passed

Merged PRs

• Release hardening rollup for Windows shim resilience, storage recovery promotion, and TUI version visibility.

Commits

• Included in release tag v0.1.7.

Notes

• Existing account storage is auto-recovered from real backup artifacts when synthetic fixture resets are detected.
• Windows command shims now self-heal from known stock Codex shim replacements during normal command execution.
• TUI now shows the active package version directly in the dashboard title for fast runtime verification.

Related

• ../getting-started.md
• ../upgrade.md
• ../reference/commands.md

What's Changed

• feat: final consolidated codex multi-auth overhaul (runtime + tui + docs) by @ndycode in #4
• CodeRabbit Generated Unit Tests: Add unit tests for PR changes by @coderabbitai[bot] in #5
• Refactor: complete codex-only migration and repair build/test by @ndycode in #6
• feat: unified overhaul — consolidate PRs #7, #8, #10, #11, #12, #13 by @ndycode in #14
• Fix account storage identity across worktree branch changes by @ndycode in #28
• Add rotating account backup fallback recovery by @ndycode in #29
• supersede: unify PRs #15 #16 #17 #18 #19 #20 #24 #25 into one branch by @ndycode in #27

New Contributors

• @coderabbitai[bot] made their first contribution in #5

Full Changelog: https://github.com/ndycode/codex-multi-auth/commits/v0.1.7