Codex Acc Switcher Personal

Personal VS Code extension for switching Codex accounts.

Commands

• Codex Personal: Switch Account
• Codex Personal: Save Current Account
• Codex Personal: Add New Account
• Codex Personal: Delete Account
• Codex Personal: Refresh Status
• Codex Personal: Open Accounts Dashboard
• Codex Personal: Open Limits Data

The extension adds a Codex Accounts icon to the VS Code Activity Bar. Open it from the left sidebar to see the dashboard. The status bar item focuses the same dashboard. The original quick-switch flow is still available from the Command Palette.

Limits dashboard

The dashboard reads saved accounts from the archive directory. For the active account, it automatically imports the latest Codex rate-limit data from local Codex session events in ~/.codex/sessions/**/*.jsonl.

Imported values are cached per account in:

~/.codex-switch/limits.json

The extension creates this file automatically. You normally do not need to edit it, but the shape looks like this:

{
  "accounts": {
    "main": {
      "day": {
        "remaining": 42,
        "limit": 50,
        "resetAt": "2026-06-02T12:00:00+04:00"
      },
      "week": {
        "remaining": 180,
        "limit": 250,
        "resetAt": "2026-06-09T00:00:00+04:00"
      },
      "updatedAt": "2026-06-02T01:30:00+04:00",
      "note": "Optional local note"
    }
  }
}

resetAt can be any ISO date string. The dashboard calculates the countdown locally.

Defaults

By default, the extension keeps compatibility with the original account archive layout:

• active Codex directory: ~/.codex
• archive directory: ~/codex-data
• state directory: ~/.codex-switch
• managed files: auth.json, cap_sid

You can change these in VS Code settings under codexPersonalAccounts.*.

Development

npm install
npm run compile
npm run package

Install the generated .vsix from VS Code with:

code --install-extension .\codex-acc-switcher-personal-0.1.0.vsix

Marketplace publishing

The extension is prepared for publishing to the VS Code Marketplace. Before publishing, make sure the package does not include personal Codex data:

• do not commit or package ~/.codex
• do not commit or package ~/codex-data
• do not commit or package ~/.codex-switch
• do not commit or package generated .vsix files

To publish a new Marketplace version:

1. Increase version in package.json.
2. Run npm test.
3. Run npm run package.
4. Run npx vsce publish.