AILSA SubSwitch

Weekly usage at a glance. Switch accounts in a click.

A native macOS menu bar app for Codex, Antigravity, and Cursor.

Get started · User guide · Privacy · Contribute

Keep your coding accounts and their remaining usage in one place. See which account is ready, switch to it, and understand where your recorded usage went— without leaving the menu bar.

AILSA SubSwitch is designed to be one of the most user-focused and visually considered products in its category. The project treats interaction details, readability and visual polish as product features, so usage information stays clear without making the menu bar feel like an operations console.

The open-source project includes at least two free progress-bar skins. Future releases may add paid skins and other advanced user-experience improvements, while the core features remain free throughout the 1.x series.

AILSA SubSwitch is an independent, community-maintained project. It is not affiliated with OpenAI, Google, Anysphere, or the providers whose usage it displays. The application includes code derived from Copool, with attribution and notices preserved in this repository.

What you can do

• Switch accounts. Save local sign-ins for Codex / ChatGPT, Antigravity and

• Read the actual limits. View provider-reported usage windows and reset

• Follow usage over time. Explore Today, 7-day and 30-day views, model

• Understand reference costs. Read token records from local Codex sessions

• Make it yours. Choose M/B token units, visible usage windows, restart

Provider support

| Capability | Codex / ChatGPT | Antigravity | Cursor | | --- | --- | --- | --- | | Local account import and switching | Yes | Yes | Yes | | Usage and reset times | Provider-reported | Native usage families | Provider-reported | | Token / USD details | Local sessions or OpenCodex records | Not exposed by the supported usage source | Usage events reported by Cursor | | History | Recorded usage | Locally captured usage snapshots | Reported usage events | | Smart switching | Supported | Available when native credential access permits | Manual switching |

Unknown usage or pricing remains unknown. **API reference cost is not your subscription bill, credit balance, or a promise of what a provider will charge.** Antigravity usage percentages are not converted into invented token totals.

We expect to add Grok and Kimi usage monitoring in 1.0.1, followed by Alibaba and DeepSeek usage monitoring in 1.0.2.

1.0.0(j) speeds up native Codex history scanning and corrects Antigravity paid-plan labels, adapting the relevant changes from CodexBar 0.77.0. Measured quotas keep their reset times without inventing a subscription tier. See the release notes and upstream review.

1.0.0(i) adds cached-input reuse and sample coverage in usage details, reads native Codex history with bounded memory, and improves menu-bar anchoring and macOS SDK packaging. Account refresh and the existing dashboard layouts are preserved. See the integration notes.

1.0.0(g) adds GPT-6.1 Sol Token and equivalent API usage accounting, including its 5% cache-hit price, the full-request long-context rule and vendor-confirmed Fast pricing. Existing records are recalculated when loaded. See the update notes.

1.0.0(f) adds DeepSeek V4.1 Flash reference accounting using official Flash rates, request timestamps and reported cache hits. Peak/off-peak rules now account for Chinese public holidays. Token records stay unchanged. See the update notes.

1.0.0(l) adds official USD reference rates for **DeepSeek V4.1 Flash, Hy3 and Step 5 Preview**, including WorkBuddy model IDs, cache discounts and DeepSeek request-time peak/off-peak pricing. Historical views and usage images are recalculated without changing Token counts. See the pricing details.

1.0.0(k) adds **Settings → Quota display → Usage sharing images → Hide models without a USD amount**. Exported images can omit unpriced model rows while keeping complete Token totals and trends. Explicit $0.00 amounts remain visible.

1.0.0(e) adds shareable Daily, Weekly and Monthly usage PNGs with a native save dialog, and official GPT-6 Sol / Luna reference pricing. Open Codex or Cursor usage and choose Export usage image in the toolbar. See the update notes.

1.0.0(d) recognizes Grok Build Fast usage as part of Grok 4.7, including its equivalent API reference amount in existing history. A Fast route name alone does not apply Priority pricing. See the update notes.

1.0.0(c) added Settings → Usage Display → Usage chart display. Choose Token usage or Equivalent API consumption (USD) for Today, 7-day and 30-day charts. The choice is saved and applies immediately, independently of model-list sorting. Antigravity continues to show quota percentages. See the update notes.

1.0.0(b) added historical hover context for Codex usage charts. On 7-day views, hovering a date updates the range title, Token and equivalent API amount, and the model list to that day's records. On 30-day views, choose daily or four weekly periods; hover labels and summaries follow that choice.

1.0.0(a) added Grok 4.7 model grouping and official API reference pricing for recorded usage, including cached input, long context and confirmed Priority processing. This is separate from the planned Grok subscription monitor. It also fixes Antigravity 2.15.1 OAuth configuration detection, with structural validation for newer Google-signed builds. See the update notes.

Preview

Actual SwiftUI components, rendered with synthetic demo accounts and usage. The sample numbers are illustrative, not provider prices or a real account's bill.

!Account cards with remaining usage and reset-credit details

!Usage dashboard with model breakdown and an intraday chart

Compact cards keep usage-family names visible and show Codex reset-credit details:

!Compact cards with labeled usage rings and reset-credit expiry

Regenerate these previews with bash scripts/render_docs.sh; the renderer does not load your live account library.

Get started

Requirements: macOS 14 or later, an Apple Silicon Mac, and an existing sign-in for each provider you want to use. Provider subscriptions are separate from AILSA SubSwitch.

1. Download the macOS ZIP from the 1.0.0(i) release.

1. Move AILSA SubSwitch.app to Applications and open it.
2. Click its menu bar icon. In Accounts, select a provider and import the

1. Open Usage Management for recorded usage. Use Settings to choose

1.0.0 distribution: manual downloads, no OTA updater and no App Store submission. The package is ad-hoc signed and is not Apple-notarized. macOS may require an explicit first-open approval in **System Settings → Privacy & Security**. See the installation guide. Do not disable system-wide security protections to run it.

When updating, quit AILSA SubSwitch and replace the application bundle. Account data is stored separately. This version does not install updates in the background.

Usage sources and privacy

AILSA SubSwitch does not operate an account-sync service or collect analytics. It reads local account/usage files and contacts the relevant providers for sign-in and usage information. Some saved profiles contain credentials; they are not public project files and should never be attached to an issue.

| Source | Used for | | --- | --- | | Codex local authentication and session metadata | Switching, usage, recorded token usage | | OpenCodex local usage ledger, when present | Model/provider usage and separately identified reference estimates | | Antigravity native session and usage source | Google account switching and usage snapshots | | Cursor local profile and usage API | Cursor switching and usage events |

Read Privacy & data for storage locations, network behavior and what to redact in bug reports. AILSA SubSwitch does not provide an API relay or bundle a model backend.

Build from source

The supported packaging path uses Xcode Command Line Tools and Python 3; no package-manager dependencies or previously installed AILSA SubSwitch binary are required.

# On an Apple Silicon Mac:
git clone https://github.com/KZCFG/AILSA-SubSwitch.git
cd AILSA-SubSwitch
bash scripts/build_app.sh

Output: build/1.0.0(i)-2026101301/AILSA SubSwitch.app, an arm64 ZIP, SHA-256 checksum, and source manifest. Check build and release notes for custom output locations and signing details.

The project page and app use the same AILSA SubSwitch artwork. After replacing docs/assets/app-icon.png, run bash scripts/build_icon.sh to regenerate the macOS icon, then build the app.

bash scripts/sync_version.sh --check
bash scripts/run_tests.sh --isolate

The portable test runner uses an asserting XCTest-compatible shim on Command Line Tools-only machines; it is not Apple's XCTest runtime and reports only the tests it actually executes. See Contributing.

Status and limitations

• 1.0.0(i) is distributed through GitHub Releases; validation and coverage are tracked in

• Small updates advance the suffix: (a), (b), (c), ...; larger feature releases

• Apple Silicon is the validated packaging target. Intel builds and widgets

• Provider endpoints and local sign-in formats can change. Expired sign-ins

• Stable Developer ID signing and OTA updates are deferred. Repeated Keychain

• Eleven localization catalogs are included; some newer controls still need

Contributing

Bug reports, reproducible fixtures, UI feedback, translations and code reviews are welcome. Start with Contributing, the user guide and the roadmap. For credential or account-safety issues, use the security policy instead of posting secrets publicly.

Credits and license

Released under the MIT License, with the upstream copyright notices preserved.

• Copool: the Swift application foundation

• codex-tools: Copool's upstream

• CodexBar: adapted progress-bar structure

• OpenCodex: an optional external usage-data source; its runtime is not bundled.