Codex SwitchBridge for VS Code

Switch between saved Codex accounts and Responses-compatible API providers with one click, keep local conversation history available in both modes, and track local token usage by selection.

Codex SwitchBridge manages the active credentials, provider route, and saved selection as one guarded transition. Shared conversation history is enabled by default for new local threads.

Install

Download codex-switchbridge-0.3.0.vsix from GitHub Releases, then run Extensions: Install from VSIX... or:

code --install-extension codex-switchbridge-0.3.0.vsix

Disable or uninstall Codex Account Switch before enabling Codex SwitchBridge. Both extensions write the same local Codex files.

Account and API-provider switching

Open Codex SwitchBridge from the Activity Bar. The Overview shows the active mode, shared-history state, and local token usage. The Accounts and API Providers views use the same guarded switching workflow.

When you select	SwitchBridge applies
A Codex account	Saved account credentials, account routing, and the original OpenAI base URL
An API provider	Saved API authentication, provider configuration, and the shared-history route

Before applying the next selection, SwitchBridge writes the latest active credentials back to the outgoing saved entry. It uses atomic authentication writes, a cross-window switch lock, and rollback snapshots.

After a successful switch, the Codex extension may still hold its old authentication in memory. The default Reload recommended status-bar action lets you reload when needed without repeated notification popups.

Local token usage

The Overview indexes cumulative token_count events from local Codex rollout files under the active CODEX_HOME. It displays the recorded total, input, output, cached input, reasoning output, attributed and unattributed usage, plus a breakdown for every tracked account and API provider.

SwitchBridge assigns each new token increment to the selection active when Codex recorded it, even if one conversation continues across an account/API switch. Per-selection tracking begins locally after this version is activated. Older shared openai sessions cannot be assigned safely and appear as Earlier or unattributed; uniquely identifiable older provider sessions can still be mapped to their saved profile.

The dashboard is an activity view, not a bill or cost estimate. Cached input is included in input, and reasoning output is included in output. Index data remains on this device and contains counters, timestamps, fingerprints, and opaque IDs, not conversation text, file paths, labels, provider names, or credentials. Run Refresh Local Token Usage for an immediate rescan.

Shared conversation history

With codex-switchbridge.shareHistoryAcrossProviders enabled, account mode and Responses-compatible API-provider mode use the same local Codex history bucket under one CODEX_HOME. New threads remain visible when you move between the two modes.

This is local history continuity. It does not merge ChatGPT web history, Codex Cloud tasks, connectors, quotas, or history between devices.

Shared routing requires an API provider with:

wire_api = "responses"
base_url = "https://your-provider.example/v1"

Repair older threads

Older threads may carry a provider-specific history ID. Stop active Codex output, then run Codex SwitchBridge: Repair Shared Conversation History.

The repair process creates backups, updates only provider identity fields, validates rollout JSONL and SQLite records, and stops if a rollout changes while it is being checked. Activation never rewrites history. Python 3 is required only for this maintenance command.

See Conversation history across modes for details.

Features

One-click switching between saved Codex accounts and API providers
Shared local conversation history across both modes, enabled by default for new threads
Local or VS Code Settings Sync storage for accounts and provider profiles
Account quota display in the tree and status bar
Overview dashboard with total and per-account/API local token usage
Manual token refresh and rotating background token maintenance
Shared local quota cache across VS Code windows
Optional encryption for saved authentication data
Account import and export
Explicit, backup-first repair for older provider-tagged threads

Commands

Codex SwitchBridge: Add Account
Codex SwitchBridge: Add API Provider
Codex SwitchBridge: Switch Account
Codex SwitchBridge: Switch API Provider
Codex SwitchBridge: Switch Mode
Codex SwitchBridge: Refresh Token
Codex SwitchBridge: Refresh Quota
Codex SwitchBridge: Refresh Local Token Usage
Codex SwitchBridge: Import Accounts
Codex SwitchBridge: Export Accounts
Codex SwitchBridge: Repair Shared Conversation History
Codex SwitchBridge: Reload Window

Settings

Setting	Default	Description
`codex-switchbridge.shareHistoryAcrossProviders`	`true`	Keep new local conversation history available across account and Responses-compatible API-provider modes
`codex-switchbridge.reloadWindowAfterSwitch`	`statusBar`	Show a non-blocking reload action, never notify, or reload automatically after a switch
`codex-switchbridge.quotaRefreshInterval`	`30`	Check one saved account per interval for token maintenance and quota refresh
`codex-switchbridge.tokenAutoUpdate`	`true`	Refresh saved account tokens when they are expired or near expiry
`codex-switchbridge.showStatusBar`	`true`	Show current selection, quota, token usage, and reload recommendations in the status bar
`codex-switchbridge.authDirectory`	`""`	Store local saved entries in this directory; empty uses the default Codex directory
`codex-switchbridge.defaultSaveTarget`	`local`	Save new accounts and API providers locally or in synced extension storage

Requirements and scope

Codex CLI must be installed and available to the VS Code extension host.
Each Codex account must complete a successful codex login flow before it can be saved.
Shared history applies only to local threads under the same CODEX_HOME.
Only Responses-compatible API providers can use the shared-history route.
Existing Codex output must stop before history repair runs.

Project

Codex SwitchBridge is an independent open-source project derived from jqknono/codex-account-switch, with substantial modifications by baoshichao001-dev.

Released under the MIT License.