steipete/CodexBar
41.7
Weak · 27 September 2026
289.8k
lines of production code
Swift
primary language
3
measurements over time
What this system is
CodexBar is a cross-platform desktop application that aggregates and monitors usage quotas, spending, and credit balances across dozens of AI service providers. It operates primarily as a menu bar utility on macOS and a desktop client on Linux, providing real-time visibility into API costs and subscription limits through a unified interface. The system supports a wide variety of authentication methods, including API keys, OAuth, and browser cookie imports, while offering extensibility via a plugin architecture and external event hooks.
Features
Add AWS Bedrock provider with flexible authentication options
Users can now connect to AWS Bedrock through a new provider integration. The settings allow choosing between static access keys or an AWS profile (supporting SSO and assume-role). The configuration includes fields for the AWS region, profile name, and access credentials, along with a warning about potential AWS monitoring charges.
Sources/CodexBar/Providers/Bedrock · high confidence
Add AWS Bedrock provider with usage tracking and cost reporting
Users can now connect their AWS Bedrock account to track usage and costs. The provider supports authentication via static AWS access keys or AWS CLI profiles (including SSO and assume-role). It fetches monthly spend from AWS Cost Explorer and, optionally, token usage and request counts from CloudWatch metrics. Configuration is managed through environment variables or provider settings, and usage data is presented in the dashboard with budget tracking.
Sources/CodexBarCore/Providers/Bedrock · high confidence
Add Abacus AI provider with manual cookie configuration
The application now supports the Abacus AI provider, allowing users to authenticate via browser cookies. Users can configure the cookie source to automatically import cookies or manually paste a Cookie header or cURL capture from the Abacus AI dashboard. When manual mode is selected, a secure input field appears for pasting credentials, along with a link to the Abacus AI dashboard.
Sources/CodexBar/Providers/Abacus · high confidence
Add Aixy provider support for key-scoped usage and budget tracking
Users can now connect their Aixy account to track API usage and budgets. This new provider reads key-scoped usage data and applicable budgets, displaying primary and secondary balance information in the dashboard and menu bar. Configuration requires setting the AIXY\_API\_KEY environment variable, with an optional AIXY\_BASE\_URL for self-hosted or dedicated installations.
Sources/CodexBarCore/Providers/Aixy · high confidence
Add Alibaba Coding Plan and Token Plan providers
Users can now track usage for Alibaba's Coding Plan and Token Plan services. The Coding Plan provider supports both International and China mainland regions, fetching usage via API keys or web session cookies, and displays 5-hour, weekly, and monthly quota windows. The Token Plan provider adds support for Personal/Solo variants alongside Team plans, with region-specific endpoints and CLI-based usage fetching for the Bailian CLI. Both providers include cookie import from major browsers on macOS, environment variable configuration for API keys and endpoint overrides, and distinct branding and dashboard links.
Sources/CodexBarCore/Providers/Alibaba · high confidence
Add Alibaba Coding Plan and Token Plan usage providers
Users can now track usage for Alibaba's Coding Plan and Token Plan services. The new Coding Plan provider allows configuration of an API key and cookie source (automatic from Model Studio/Bailian or manual paste), with support for selecting the gateway region (international or China mainland). The Token Plan provider adds a usage source selector (Auto, Bailian CLI, or Browser cookies) alongside cookie management and region settings, enabling automatic detection of usage via the CLI or manual cookie import, with specific handling for personal token plan APIs.
Sources/CodexBar/Providers/Alibaba · high confidence
Add Azure OpenAI provider support
Users can now connect to Azure OpenAI deployments. This change introduces the Azure OpenAI provider descriptor, settings reader, and usage fetcher, allowing configuration via environment variables (AZURE\_OPENAI\_API\_KEY, AZURE\_OPENAI\_ENDPOINT, AZURE\_OPENAI\_DEPLOYMENT\_NAME, AZURE\_OPENAI\_API\_VERSION) or in-app settings. The provider validates endpoint overrides for security, supports API versioning (defaulting to 2024-10-21), and fetches usage status from the Azure OpenAI API.
Sources/CodexBar/Providers/AzureOpenAI, Sources/CodexBarCore/Providers/AzureOpenAI · high confidence
Add Bifrost provider support for gateway quotas
Users can now connect to a Bifrost gateway to read governance budgets and rate limits. This change introduces the Bifrost provider descriptor and settings reader, which require the BIFROST\_BASE\_URL and BIFROST\_API\_KEY environment variables to authenticate via virtual keys and display quota usage in the dashboard.
Sources/CodexBarCore/Providers/Bifrost · high confidence
Add Brazilian Portuguese (pt-BR) localization
CodexBar now supports Brazilian Portuguese, providing translated strings for the menu bar, settings, and usage displays. This includes full localization of quota warning labels, iCloud sync options, provider configuration, and pluralized usage metrics (e.g., weekly quota windows).
Sources/CodexBar/Resources/pt-BR.lproj · high confidence
Add CSQLite3 module map and shim header
The CSQLite3 package now includes a module map (module.modulemap) and a C header shim (shim.h) that wraps the system sqlite3 library. This enables the Swift package to properly expose the underlying C sqlite3 bindings to Swift code via the module system.
Sources/CSQLite3 · high confidence
Add Chutes provider for usage and quota tracking
Users can now connect their Chutes account to track subscription usage and monthly quotas within CodexBar. This change introduces the Chutes provider, which reads the API key from the configuration file or the CHUTES\_API\_KEY environment variable, supports custom HTTPS endpoint overrides, and displays quota details (such as 4-hour and monthly limits) in the menu and dashboard.
Sources/CodexBarCore/Providers/Chutes · high confidence
Add ClinePass provider support with browser sign-in capability
Users can now use the ClinePass usage provider, which supports both API key entry and browser-based sign-in via the Cline auth session. The provider reads credentials from the environment (CLINE\_API\_KEY or CLINEPASS\_API\_KEY) or from the local Cline settings file (providers.json), automatically detecting whether the stored credential is an OAuth token or an API key. This enables seamless integration with existing Cline sessions without requiring manual key copying.
Sources/CodexBarCore/Providers/ClinePass · high confidence
Add CodeRabbit CLI usage provider
Users can now view CodeRabbit usage data (review counts, billing period, and reset dates) directly in the menu bar. This feature works by running the local \coderabbit\ CLI tool to fetch usage information, parsing the output, and displaying the results. The provider is disabled by default and requires the user to be authenticated with the CodeRabbit CLI.
Sources/CodexBar/Providers/CodeRabbit, Sources/CodexBarCore/Providers/CodeRabbit · high confidence
Add CodexBar Widget Extension for macOS
The application now includes a macOS Widget Extension (CodexBarWidgetExtension) that displays usage and burn-down statistics directly on the desktop. This new component integrates with WidgetKit and SwiftUI to provide at-a-glance metrics, including account usage pins and combined burn-down views, requiring macOS 14.0 or later.
WidgetExtension · high confidence
Add CodexBar widget for Omarchy shell integration
Introduces a new Omarchy bar widget that displays AI provider usage quotas, reset times, and spending insights. The widget polls a local Linux desktop backend via IPC every five seconds to show provider logos (tinted to the bar's foreground) and remaining percentages, with a popup for detailed usage, settings, and notifications. An installer script handles migration from older widget settings, configures autostart, and manages plugin installation for the Omarchy shell.
Integrations/Omarchy · high confidence
Add Command Code provider with cookie-based authentication settings
A new Command Code provider has been added, allowing users to authenticate via cookies. The provider supports two modes: automatic browser cookie import and manual entry of a Cookie header or cURL capture. Users can configure these options in the provider settings, with a secure input field appearing when manual mode is selected, and a link to open the Command Code Studio settings.
Sources/CodexBar/Providers/CommandCode · high confidence
Add DeepSeek provider with credit balance tracking and usage summaries
Users can now track their DeepSeek platform usage and credit balances directly within the app. This change introduces a new provider that supports fetching usage data via API keys or by importing tokens from the Chrome browser's local storage. It displays current balances (including paid and granted amounts), daily and monthly usage summaries, and per-model cost history, with specific handling for platform sessions and profile selection.
Sources/CodexBarCore/Providers/DeepSeek · high confidence
Add Deepgram provider support with usage tracking and settings validation
Users can now connect their Deepgram account to track API usage and costs. The provider requires a Deepgram API key (via the DEEPGRAM\_API\_KEY environment variable or settings) and optionally a Project ID to aggregate costs across projects. The implementation includes validation for custom API endpoint overrides, ensuring they use HTTPS or a bare host, and displays usage summaries labeled as 'Requests' and 'Usage' in the provider dashboard.
Sources/CodexBarCore/Providers/Deepgram · high confidence
Add Devin provider usage tracking
Users can now track usage and limits for the Devin AI provider. This change introduces a new provider descriptor, settings, and fetcher that support automatic authentication via Chromium browser sessions on macOS, manual Bearer token authentication, and organization context selection. The provider displays daily and weekly quota percentages, plan details, and any extra usage balance, with specific error handling for missing sessions, unreadable browser storage, or invalid credentials.
Sources/CodexBarCore/Providers/Devin · high confidence
Add Devin usage provider with extra balance tracking
Users can now connect their Devin account to view usage statistics, including an 'Extra usage balance' displayed in the provider menu when enabled. The provider supports automatic authentication by importing the session from Chromium browsers or manual entry of a Bearer token and optional organization ID, with settings managed via the centralized provider configuration.
Sources/CodexBar/Providers/Devin · high confidence
Add Doubao provider configuration
The Doubao provider is now available for configuration, allowing users to set up API credentials (API key and optional secret access key) and specify the Volcengine Ark region (defaulting to cn-beijing) directly within the application settings.
Sources/CodexBar/Providers/Doubao, Sources/CodexBarCore/Providers/DevPass · high confidence
Add Doubao provider support with usage tracking and CLI/API integration
Users can now track usage for the Doubao provider, including request limits and coding plan quotas. The provider supports authentication via API keys or Volcengine AK/SK credentials, and fetches usage data through either the arkcli tool or direct API calls, with automatic fallback between sources.
Sources/CodexBarCore/Providers/Doubao · high confidence
Add Droid (Factory) provider with API key and browser cookie authentication
Users can now connect to the Factory (branded as Droid) provider using either an API key or browser session cookies. The provider descriptor defines the integration, supporting API-key authentication via the \FACTORY\_API\_KEY\ environment variable or \\~/.factory/.env\ file, and automatic session import from macOS browsers (Chrome, Arc, Safari, etc.) by reading local storage and cookies. On non-macOS platforms, only API-key authentication is available. The implementation includes a dedicated session store for persisting cookies and tokens securely, manual credential parsing for custom headers, and usage fetching strategies that fall back from API to web-based cookie auth in auto mode.
Sources/CodexBarCore/Providers/Factory · high confidence
Add ElevenLabs usage provider
Users can now track usage and costs for the ElevenLabs voice synthesis service. The system reads the API key from the ELEVENLABS\_API\_KEY (or XI\_API\_KEY) environment variable or \~/.codexbar/config.json, connects to the default https://api.elevenlabs.io endpoint, and displays usage metrics such as credits and voices. It also supports custom API endpoints via the ELEVENLABS\_API\_URL environment variable, provided they use HTTPS or a bare host.
(repo-wide) · high confidence
Add English localization strings for CodexBar
The application now includes a base English localization file (Localizable.strings) and a pluralization rules file (Localizable.stringsdict) for the menu bar interface. This adds user-facing text for provider account management, quota and usage tracking (including weekly window counts and reset times), keychain access prompts, and various settings labels, ensuring the UI is fully translatable and supports proper pluralization for English.
Sources/CodexBar/Resources/en.lproj · high confidence
Add Fireworks provider for 30-day billing spend
Users can now connect their Fireworks account to view 30-day billing spend data. This change introduces the Fireworks provider implementation and settings store, allowing users to configure their API key and account slug. The provider automatically discovers the account slug if the API key has access to a single account, or allows manual entry for multi-account setups, with a direct link to the Fireworks home page for account management.
Sources/CodexBar/Providers/Fireworks · high confidence
Add Fireworks provider integration for usage spend tracking
Users can now enable the Fireworks provider to track 30-day billing spend. This new integration allows configuration via API key and optional account slug environment variables, automatically discovering the account slug if not explicitly set, and displays usage data through the application's standard spend widgets and CLI commands.
Sources/CodexBarCore/Providers/Fireworks · high confidence
Add GitHub Copilot provider with multi-account support, budget extras, and enterprise host configuration
This change introduces the GitHub Copilot provider integration, enabling users to authenticate via a device login flow that supports multiple accounts and GitHub Enterprise hosts. Users can now enable 'Budget extras' to display usage bars for seat credits and budget limits, with options to auto-import or manually paste GitHub cookies. The provider also allows configuring per-account credit allowances and selecting a secondary metric for the menu bar icon.
Sources/CodexBar/Providers/Copilot · high confidence
Add GitKraken AI usage provider
Users can now track and view usage statistics for the GitKraken AI service. This change introduces a new provider descriptor that configures the application to recognize GitKraken, allowing users to authenticate via an access token (set in Settings or the GITKRAKEN\_API\_TOKEN environment variable) and view their personal and shared pool usage data on the GitKraken dashboard.
Sources/CodexBarCore/Providers/GitKraken, Sources/CodexBarCore/Providers/Sakana · high confidence
Add Grok provider support with flexible authentication and usage tracking
Users can now connect to the Grok AI provider through multiple authentication methods: automatic detection of Grok CLI, SuperGrok OAuth, browser cookies (with manual paste option), or bearer gRPC. The provider includes a settings UI to select the usage source, manage cookie credentials, and open usage pages. Local session data is scanned off the main thread to maintain UI responsiveness, and usage history is aggregated into cost and token snapshots for display in the app.
Sources/CodexBar/Providers/Grok · high confidence
Add Groq provider support for usage and spend tracking
Users can now connect their Groq accounts to view usage, spend, and token metrics. The provider supports two data sources: the Groq Console web session (using Stytch cookies or environment overrides) for historical daily spend and token breakdowns, and the Groq API key with Prometheus metrics for real-time request and token rates. Configuration is handled via the standard provider descriptor, with API keys read from the GROQ\_API\_KEY environment variable and console sessions resolved from browser cookies or manual entry.
Sources/CodexBarCore/Providers/Groq · high confidence
Add Helmcode provider with Cloud and NaN Builders dashboard support
Users can now track usage and costs for Helmcode, a new supported provider. The integration supports both Helmcode Cloud and NaN Builders accounts, automatically directing users to the correct dashboard (cloud.helmcode.com or cloud.nan.builders) based on their account organization. Authentication is handled via Chrome browser cookies or by manually pasting a Cookie header, with validation that prevents the use of raw cURL captures.
Sources/CodexBarCore/Providers/Helmcode · high confidence
Add Hugging Face provider integration with API token support
Users can now connect to Hugging Face through a new provider plugin that supports API token authentication. The integration reads access tokens from the CodexBar settings, environment variables (HF\_TOKEN, HUGGING\_FACE\_HUB\_TOKEN), or the local CLI token file, enabling usage tracking via the Hugging Face billing API. The provider is disabled by default and can be enabled in settings to show usage metrics in the menu bar.
Sources/CodexBarCore/Providers/HuggingFace · high confidence
Add IBM Bob usage provider
Users can now track usage for the IBM Bob service. This change introduces the provider descriptor, settings reader, and usage fetcher for IBM Bob, allowing the application to retrieve and display Bobcoin consumption data via the IBM Bob API using an API key.
Sources/CodexBarCore/Providers/IBMBob · high confidence
Add Japanese (ja) localization
Japanese language support is now available for the CodexBar menu bar interface. This update includes translations for settings, provider configurations, usage dashboards, and quota alerts, allowing Japanese-speaking users to interact with the app in their native language.
Sources/CodexBar/Resources/ja.lproj · high confidence
Add JetBrains AI provider integration
Users can now connect CodexBar to JetBrains AI. This change introduces a new provider implementation that detects installed JetBrains IDEs, allows users to select a specific IDE or provide a custom path in settings, and guides users through a login flow to enable AI Assistant integration.
Sources/CodexBar/Providers/JetBrains · high confidence
Add JetBrains AI provider support
Users can now monitor JetBrains AI Assistant usage directly within the app. This change introduces a new provider that detects installed JetBrains IDEs (such as IntelliJ IDEA, PyCharm, and WebStorm) by scanning standard configuration directories, parses the local AI quota XML file to display monthly credit usage and refill dates, and supports custom IDE base paths via settings.
Sources/CodexBarCore/Providers/Abacus, Sources/CodexBarCore/Providers/JetBrains · high confidence
Add Kilo provider with API and CLI usage tracking
This change introduces the Kilo provider, enabling users to track usage credits and pass balances. It supports fetching data via the Kilo API (using the KILO\_API\_KEY environment variable) or via the local CLI (reading from \~/.local/share/kilo/auth.json), with an 'auto' mode that tries the API first and falls back to the CLI. The provider displays usage snapshots including credits used/remaining, pass details, and plan information, and handles authentication errors gracefully.
Sources/CodexBarCore/Providers/Kilo · high confidence
Add Kimi Code provider with multi-source authentication and usage tracking
Introduces a new Kimi Code provider that supports authentication via API keys, manual cookie headers, and automatic browser cookie import (macOS). It fetches and displays usage data from the Kimi Code API and web billing endpoints, handling regional configurations (China vs. International) and subscription plan details.
Sources/CodexBarCore/Providers/Kimi · high confidence
Add Kimi provider with configurable usage sources and regions
Users can now connect to the Kimi service through a new provider implementation. This adds settings to select the Kimi region (defaulting to China) and choose a usage source mode (Auto, API key, or Browser cookies). The Auto mode attempts to use a configured API key, then falls back to Kimi Code CLI credentials, and finally to web cookies. Users can also manually configure API keys or cookie headers, with links provided to open the relevant API documentation and user console.
Sources/CodexBar/Providers/Kimi · high confidence
Add Kiro provider for AWS kiro-cli usage tracking
Users can now track Kiro usage directly within the app via the new Kiro provider. This feature integrates with the local kiro-cli tool to fetch credit usage, plan details, and bonus credits, while also querying the AWS usage limits API to display overage status and costs. The provider is disabled by default and can be enabled in settings to show usage metrics in the menu and dashboard.
Sources/CodexBarCore/Providers/Kiro · high confidence
Add Korean (한국어) localization support
Users can now see the app interface in Korean. This change adds the Korean language catalog (Localizable.strings and Localizable.stringsdict) to the CodexBar resources, enabling translation of UI elements, settings, and usage metrics for Korean-speaking users.
Sources/CodexBar/Resources/ko.lproj · high confidence
Add LongCat usage provider with web-based cookie authentication
Introduces a new LongCat provider that fetches usage data (total quota, used tokens, and fuel-pack balances) from the LongCat web console. Authentication is handled via browser cookie import on macOS or manual cookie headers, with support for environment variables and strict session validation to surface invalid/expired states.
Sources/CodexBarCore/Providers/LongCat · high confidence
Add Mistral AI as a new provider
Users can now select Mistral AI as a provider. This adds a new provider implementation that supports automatic browser cookie imports from admin.mistral.ai or manual cookie pasting, with specific settings for the Mistral cookie source and header stored in the settings store.
Sources/CodexBar/Providers/Mistral · high confidence
Add Mistral AI provider with usage tracking and cookie-based authentication
Users can now connect their Mistral AI account to track API usage, costs, and subscription budgets. The provider supports automatic session import from macOS browsers (Chrome, Firefox, Safari) or manual cookie entry (including on Linux), and displays monthly plan limits, Vibe usage, and detailed token breakdowns in the usage dashboard and menu bar.
Sources/CodexBarCore/Providers/Mistral · high confidence
Add Moonshot / Kimi API provider support
Users can now connect their Moonshot / Kimi Open Platform account to view balance information. The integration supports both International (api.moonshot.ai) and China (api.moonshot.cn) regions, allowing users to configure their API key and region via environment variables or settings. The provider displays the account balance in the UI and uses the Kimi branding for its icon and color scheme.
Sources/CodexBar/Providers/Moonshot, Sources/CodexBarCore/Providers/Moonshot · high confidence
Add Notion AI usage tracking
Users can now monitor their Notion AI consumption directly in the menu bar. This change introduces a new provider that fetches usage data via web cookies (imported from Chrome or entered manually), displays rolling session and monthly billing-period limits, and supports workspace selection for Business and Enterprise plans.
Sources/CodexBarCore/Providers/Notion · high confidence
Add Nous Portal usage tracking via Hermes Agent integration
Users can now track their Nous Portal subscription usage (monthly credits/weekly) within CodexBar. This feature integrates with the Hermes Agent to automatically read OAuth access tokens from the local auth file (\~/.hermes/auth.json) or environment variables, enabling read-only billing lookups without requiring manual API key entry. The provider displays usage metrics and provides a direct link to the Nous Portal for subscription management.
Sources/CodexBar/Providers/Nous, Sources/CodexBarCore/Providers/Nous · high confidence
Add Ollama provider support with API key and cookie authentication
Users can now connect to Ollama Cloud via a new provider integration. The feature supports two authentication modes: API key (stored securely) and browser cookies (auto-imported or manually pasted). Settings allow switching between Auto, Browser cookies, and API key sources, with UI guidance for Keychain access errors and cookie decryption issues.
Sources/CodexBar/Providers/Ollama · high confidence
Add OpenAI API balance provider
Users can now view their OpenAI API usage and balance directly within the application. This change introduces a new provider implementation that reads the Admin API key and optional Project ID from settings, allowing the app to fetch and display billing information. The settings UI includes fields for the API key and Project ID, along with direct links to OpenAI's billing and projects pages.
Sources/CodexBar/Providers/OpenAI · high confidence
Add OpenCode Go provider support
Users can now track usage and costs for the OpenCode Go provider. The integration reads local usage history from the OpenCode Go SQLite database (\~/.local/share/opencode/opencode.db) and fetches authoritative usage and Zen balance from the OpenCode web API and Console. Usage is displayed in the menu bar with session, weekly, and monthly windows, and daily cost history is available for review.
Sources/CodexBar/Providers/OpenCodeGo, Sources/CodexBarCore/Providers/OpenCodeGo · high confidence
Add OpenCode provider with cookie import and pay-as-you-go usage support
Users can now track usage for the OpenCode provider. The provider automatically imports session cookies from Chrome (and Dia on macOS) or accepts manual cookie headers, and it correctly handles both subscription-based and pay-as-you-go workspaces by falling back to billing data when subscription info is unavailable. Usage is displayed with monthly spend and remaining balance for pay-as-you-go accounts, and renewal dates are shown where applicable.
Sources/CodexBarCore/Providers/OpenCode · high confidence
Add OpenCode usage provider with manual cookie support
Introduces a new OpenCode usage provider that allows users to authenticate via manual cookie headers or automatic browser imports. The provider includes settings for specifying a workspace ID override and supports re-importing cookies, with visibility of token accounts gated by whether manual cookie source is required.
Sources/CodexBar/Providers/OpenCode · high confidence
Add OpenRouter provider implementation with API key and endpoint configuration
Users can now configure the OpenRouter usage provider by entering an API key (required) and an optional custom API endpoint URL. The implementation also supports an optional Management API key for accessing account activity data, allowing users to track credit usage and view activity summaries directly within the application.
Sources/CodexBar/Providers/OpenRouter · high confidence
Add Perplexity provider with browser cookie import and manual configuration
Users can now connect their Perplexity account to track usage and credits. The provider supports automatic authentication by importing session cookies from installed browsers on macOS, or manual authentication by pasting a session token or full cookie header. It includes specific error handling for missing or invalid tokens and integrates with the existing provider descriptor system for usage presentation and settings management.
Sources/CodexBarCore/Providers/Perplexity · high confidence
Add Pi provider with local token usage history
The application now supports the 'Pi' provider, allowing users to view their token usage history. This feature is implemented via a local fetch strategy that tracks usage data without requiring external API calls, presenting the information under a 'Session' label with weekly aggregation options. Users can enable this provider in settings to see their local token consumption, which is displayed with a dedicated purple branding theme and includes an estimate hint for token costs.
Sources/CodexBar/Providers/Pi, Sources/CodexBarCore/Providers/Pi · high confidence
Add Poe provider support for tracking usage points
Users can now connect their Poe account to track usage points within the app. This change introduces the Poe provider, which reads the API key from the environment and displays the current balance in the menu card and plan row, using a custom purple color scheme and confetti palette.
Sources/CodexBarCore/Providers/Poe · high confidence
Add Qoder provider with regional cookie routing
Users can now connect their Qoder account to track usage and credits. The provider supports both automatic browser cookie imports (Chrome only) and manual entry of cookie headers or cURL captures. It intelligently routes requests to the correct regional dashboard (international qoder.com or China qoder.com.cn) based on the cookie content, ensuring accurate usage data retrieval.
Sources/CodexBarCore/Providers/Qoder · high confidence
Add Qwen Cloud token-plan usage provider
Users can now track usage for the Qwen Cloud individual token plan. The provider imports session cookies from Chrome and Brave, resolves the OneConsole security token, and fetches usage data from the Qwen Cloud API. It displays monthly, weekly, and five-hour usage windows and supports manual cookie headers and environment-based host overrides.
Sources/CodexBarCore/Providers/QwenCloud · high confidence
Add Raycast provider with cookie-based credit tracking
Users can now track Raycast AI credits by importing session cookies. The new provider automatically imports cookies from Chrome to authenticate, or allows manual entry of the Cookie header from the Raycast account settings page. It displays the monthly credit allowance and plan status, with a direct link to the Raycast settings page for managing credentials.
Sources/CodexBarCore/Providers/Raycast · high confidence
Add Replicate billing provider with cookie-based authentication
Users can now track spending on Replicate via a new provider that supports both manual entry of Cookie headers and automatic import of session cookies from Chrome on macOS. The provider reads billing data from replicate.com, displays usage in the menu bar, and links to the Replicate billing dashboard, while explicitly excluding cost history tracking and other browser support to minimize permission prompts.
Sources/CodexBarCore/Providers/Replicate · high confidence
Add Simplified Chinese (zh-Hans) localization for CodexBar
Users can now see the app interface in Simplified Chinese. This change adds the zh-Hans localization catalog, including 1,646 translated strings and pluralization rules for usage metrics, covering settings, provider details, quota warnings, and menu bar displays.
Sources/CodexBar/Resources/zh-Hans.lproj · high confidence
Add StepFun provider with auto/manual authentication modes
Users can now connect to the StepFun platform through a new provider integration. The provider supports two authentication modes: 'auto', which uses a username and password to obtain a session token, and 'manual', which allows pasting an Oasis-Token from a browser session. Settings for credentials and the chosen authentication source are managed via the provider's specific configuration screen.
Sources/CodexBar/Providers/StepFun · high confidence
Add Swedish localization support
The app now includes Swedish translations for the menu bar, settings, and usage dashboards, allowing Swedish-speaking users to see interface elements like iCloud sync options, provider quotas, and cost history labels in their native language.
Sources/CodexBar/Resources/sv.lproj · high confidence
Add Synthetic provider with usage quota and API key configuration
A new Synthetic provider is introduced, allowing users to configure an API key via environment variable or config file. The provider defines specific usage presentation policies, including a five-hour session quota, weekly token regeneration, and hourly search limits, along with custom branding colors and confetti palettes.
Sources/CodexBarCore/Providers/Synthetic · high confidence
Add T3 Chat provider support
Users can now connect their T3 Chat account to the application. This change introduces the T3 Chat provider descriptor and settings configuration, enabling authentication via browser cookie import or manual cookie header entry. The provider is configured with specific branding colors, dashboard URLs for customization and subscription management, and defines the necessary headers and timeouts for API communication.
Sources/CodexBarCore/Providers/T3Chat · high confidence
Add Turkish localization for CodexBar
Added Turkish language support for the CodexBar menu bar interface, including 1,633 localized strings and pluralization rules for usage metrics, settings, and provider status messages.
Sources/CodexBar/Resources/tr.lproj · high confidence
Add TypeSafe billing provider with Chrome-only cookie import
Users can now track TypeSafe usage via a new provider that supports both manual cookie headers and automatic import from Chrome on macOS. The provider reads session cookies from console.typesafe.ai and typesafe.ai, specifically filtering for the /settings/billing path, and uses them to fetch spend data. It is disabled by default and requires manual configuration or Chrome authentication to function.
Sources/CodexBarCore/Providers/TypeSafe · high confidence
Add Venice provider with usage source and cookie settings
Users can now configure the Venice usage provider, selecting between API key, web session, or auto-detection modes, and managing cookie sources (automatic Chrome import or manual paste) for web-based usage tracking.
Sources/CodexBar/Providers/Venice · high confidence
Add Vertex AI provider with OAuth-based usage tracking
A new Vertex AI provider is introduced, allowing users to enable usage tracking via OAuth authentication. The provider registers a descriptor that enables token cost support and integrates with Cloud Monitoring to fetch quota usage, while also supporting fallback to local log-based cost data if monitoring data is unavailable. This adds a new selectable provider option in the UI with specific branding and configuration for Vertex AI.
Sources/CodexBarCore/Providers/VertexAI · high confidence
Add Vertex AI provider with gcloud-based login flow
Users can now connect to Vertex AI through a new provider implementation. The login flow presents an alert instructing users to authenticate via the gcloud CLI (specifically running 'gcloud auth application-default login' with required scopes) and opens the terminal to facilitate this. After the user attempts authentication, the app refreshes its store to detect the new credentials.
Sources/CodexBar/Providers/VertexAI · high confidence
Add Warp provider integration
Users can now configure and use the Warp provider within CodexBar. This change introduces the Warp provider implementation, which manages settings for the Warp API key and provides a direct link to the Warp API Key Guide for user assistance.
Sources/CodexBar/Providers/Warp · high confidence
Add Wayfinder provider core (descriptor, fetcher, settings reader)
Introduces the Wayfinder provider, enabling users to track usage and savings from their local Wayfinder gateway (defaulting to http://127.0.0.1:8088). The provider is opt-in (disabled by default) and fetches data via unauthenticated read-only API endpoints. Users can view gateway status, routed model breakdowns, cost savings, and average decision latency through the new provider details.
Sources/CodexBarCore/Providers/Wayfinder · high confidence
Add Xiaomi MiMo provider with cookie-based authentication
A new provider for Xiaomi MiMo has been added, allowing users to authenticate via browser cookies. The implementation supports both automatic cookie imports from the Xiaomi MiMo browser and manual entry of a Cookie header. Users can configure the cookie source through settings pickers and, when manual mode is selected, enter their credentials directly. The provider also includes a login flow that opens the MiMo balance console in the default browser.
Sources/CodexBar/Providers/MiMo · high confidence
Add Zed editor support with manual cookie configuration
Users can now use the Zed editor as a usage provider. This change introduces a new provider implementation that allows users to configure authentication by manually pasting a browser session cookie from zed.dev, enabling token spend and edit predictions. The settings UI provides a secure field for entering the cookie header and explains that the Zed editor login itself requires browser cookies for token usage.
Sources/CodexBar/Providers/Zed · high confidence
Add ZenMux provider configuration and descriptor
The ZenMux provider is now registered with a dedicated descriptor that defines its branding (purple color scheme), quota labels (5-hour and weekly), and usage presentation (pay-as-you-go balance). Users must provide a Management API key via the ZENMUX\_MANAGEMENT\_API\_KEY environment variable or config file to enable the provider, which links to the ZenMux Management dashboard for cost history.
Sources/CodexBarCore/Providers/ZenMux · high confidence
Add bounded local token history readers for Antigravity
Introduces a new local usage reader for the Antigravity provider that scans local SQLite databases and JSONL cache files to reconstruct token usage history. The implementation includes a custom JSON lexer to preserve numeric precision, budgeted scanning logic to prevent resource exhaustion, and robust handling of SQLite WAL files and schema variations. This allows the application to display accurate quota and cost information for Antigravity even when the desktop app is closed or the cloud API is unreachable.
Sources/CodexBarCore/Providers/Antigravity · high confidence
Add manual team quota selection for Muse Code
Users can now explicitly select a web team quota for Muse Code when the login response omits quota information. This change introduces a new 'Browser team' settings picker that lists available teams, allowing users to choose a specific team's quota to display. The feature also adds support for manually pasting a cookie header from dev.meta.ai as an alternative to automatic browser cookie import, with the team selection only visible when cookie import is not disabled.
Sources/CodexBar/Providers/Muse · high confidence
Add native Italian localization support
CodexBar now includes native Italian translations for its interface, menu bar, and settings. This update ensures that users with their system language set to Italian see localized strings for features such as iCloud sync, provider management, usage tracking, and quota alerts, improving accessibility and clarity for Italian-speaking users.
Sources/CodexBar/Resources/it.lproj · high confidence
Add native Polish and Galician localization support
Users can now see the app interface in Polish and Galician. This change adds the \pl.lproj\ and \gl.lproj\ resource directories containing \Localizable.strings\ and \Localizable.stringsdict\ files, which provide translated UI text and handle complex pluralization rules specific to these languages (such as Polish's multiple plural forms).
Sources/CodexBar/Resources/pl.lproj · high confidence
Add native Vietnamese localization support
Users can now see the app interface in Vietnamese. This change adds the \vi.lproj\ localization catalog, including \Localizable.strings\ and \Localizable.stringsdict\, which provide translations for menu bar items, settings, provider connections, usage metrics, and pluralized quota warnings.
Sources/CodexBar/Resources/vi.lproj · high confidence
Add provider icons for new integrations
The application now displays visual identifiers for a wide range of newly supported AI providers, including Abacus AI, Alibaba, AWS Bedrock, ClinePass, DeepSeek, Devin, Doubao, ElevenLabs, Fireworks, GitKraken, Grok, HelmCode, JetBrains AI, Kimi, LiteLLM, Manus, Mistral AI, Notion AI, OpenCode, Perplexity, Poe, Qwen, Raycast, Sakana AI, StepFun, Venice API, Vercel AI Gateway, Warp, Windsurf, and Zed. These SVG assets ensure that usage tracking and balance displays in the menu bar are clearly associated with the correct service.
Sources/CodexBar/Resources · high confidence
Add sub2api provider support
Users can now connect to the sub2api service to monitor usage quotas, subscription limits, and wallet balances. This change introduces the provider descriptor and settings reader, allowing configuration via the SUB2API\_API\_KEY and SUB2API\_BASE\_URL environment variables or through the application's group API key settings. The provider validates that the base URL uses HTTPS (allowing loopback HTTP for local development) and displays usage metrics such as daily, weekly, and monthly quotas in the UI.
(repo-wide) · high confidence
Add support for Atlas Cloud and Vercel AI Gateway balance tracking
Users can now track spending balances for Atlas Cloud and Vercel AI Gateway. New provider descriptors have been added to enable balance-only monitoring for these services, allowing users to display usage data via dedicated toggle options in the settings and view their respective dashboard URLs.
Sources/CodexBarCore/Providers/AtlasCloud, Sources/CodexBarCore/Providers/Vercel · high confidence
Add support for Charm Hyper provider
Users can now connect their Charm Hyper account to track balance and cost history. The provider supports automatic session detection from Chrome on macOS, manual cookie pasting, and API key configuration as a fallback, with settings accessible via the provider's dedicated configuration section.
Sources/CodexBarCore/Providers/Hyper · high confidence
Add support for Warp usage tracking with add-on credits
Users can now enable Warp as a usage provider to monitor their API request limits and add-on bonus credits. The integration fetches data from the Warp GraphQL API, displaying the primary monthly credit usage alongside a secondary view for combined user and workspace bonus credits, including expiration details. Configuration is handled via the WARP\_API\_KEY or WARP\_TOKEN environment variables, and the provider is disabled by default.
Sources/CodexBarCore/Providers/Warp · high confidence
Add support for Zed editor billing and usage tracking
Users can now track usage and billing for the Zed editor. On macOS, the provider automatically retrieves credentials from the system Keychain to authenticate with Zed's cloud API. On other platforms, users must manually provide browser cookies or use the Zed web interface to enable tracking. The feature includes specific branding, usage labels, and error handling for scenarios like missing Keychain access or unsupported operating systems.
Sources/CodexBarCore/Providers/Zed · high confidence
Add support for ai& spend tracking
Users can now track spending for the ai& provider. This change introduces the provider descriptor and settings reader, configuring the app to read the API key from the AIAND\_API\_KEY environment variable or settings, and displays spend data summed from the request logs API with a custom orange theme.
Sources/CodexBarCore/Providers/AiAnd · high confidence
Add support for local llmman daemon integration
Users can now connect the application to a local llmman daemon (defaulting to http://127.0.0.1:17434) via a new bundled plugin. This change introduces a provider descriptor and settings reader that allow configuring the daemon's base URL and API key through environment variables (LLMMAN\_HOST, LLMMAN\_API\_KEY) or the application's config file. The integration includes validation to ensure the endpoint is secure (HTTPS or local HTTP) and provides a direct link to open the llmman web UI.
Sources/CodexBarCore/Providers/LLMMan · high confidence
Add support for z.ai and BigModel API integration
Users can now connect to the z.ai platform and the BigModel (GLM) API service. The new provider implementation allows configuring an API key and selecting the operational region (Global or China mainland), with specific instructions and links provided for obtaining keys for each region. The feature also supports multi-account usage scopes, enabling selection between personal and team-based API usage contexts.
Sources/CodexBar/Providers/Zai · high confidence
Add v0 platform billing and rate-limit provider
Users can now connect their v0 Platform API account to view billing and rate-limit data within the application. This change introduces a new provider plugin that reads credentials from the V0\_API\_KEY environment variable (or config file) and an optional V0\_SCOPE for project scoping, displaying cost history and usage limits via the v0 dashboard.
Sources/CodexBarCore/Providers/V0 · high confidence
Add xAI platform billing provider
Users can now connect their xAI account to track usage and spend. This change introduces the xAI provider integration, requiring an xAI Management API key and Team ID for authentication. It enables the display of daily spend data from the xAI Management API in the Usage & Spend section, mapping the API's daily-spend chart to the application's shared spend catalog.
Sources/CodexBarCore/Providers/XAI · high confidence
Add xKiro provider descriptor with daily free-token tracking
A new provider descriptor for xKiro has been added to the application, enabling integration with the xKiro service. This descriptor configures the provider to track daily free-token usage, displays a specific session label for this metric, and defines the necessary UI elements such as the API key field, dashboard URL, and color scheme. Users can now configure xKiro via the settings or the XKIRO\_API\_KEY environment variable to view their free-token usage history.
Sources/CodexBarCore/Providers/XKiro · high confidence
Add z.ai / GLM provider with multi-region and team support
Users can now connect to the z.ai (GLM) API service, which supports both the Global and BigModel CN regions. The provider allows switching between personal and team usage scopes, with team mode requiring Organization and Project IDs. It includes built-in support for BigModel CN account balance tracking and enforces secure endpoint overrides via HTTPS validation.
Sources/CodexBarCore/Providers/Zai · high confidence
Added Arabic, Persian, and Thai localization for CodexBar
Users can now see the CodexBar interface in Arabic, Persian, and Thai. This update adds the corresponding language resource bundles (Localizable.strings and Localizable.stringsdict) for the menu bar component, covering UI strings for settings, provider connections, usage tracking, and quota management, including proper pluralization rules for each language.
Sources/CodexBar/Resources/ar.lproj, Sources/CodexBar/Resources/fa.lproj, Sources/CodexBar/Resources/th.lproj · high confidence
Added Catalan (ca) localization
Users can now see the CodexBar interface in Catalan, including settings, menu bar displays, and usage dashboards. This update completes the Catalan translation coverage for the application.
Sources/CodexBar/Resources/ca.lproj · high confidence
Added CodexBarClaudeWatchdog utility
A new standalone executable, CodexBarClaudeWatchdog, has been added to monitor and manage the lifecycle of Claude-related processes. This tool spawns a specified child binary, waits for it to exit, and ensures proper cleanup by terminating the child's process tree if the watchdog itself receives termination signals (SIGTERM, SIGINT, SIGHUP) or if its parent process disappears.
Sources/CodexBarClaudeWatchdog · high confidence
Added German and Russian localization catalogs for CodexBar
Users can now see the app interface in German and Russian. This change adds the \de.lproj\ and \ru.lproj\ resource directories containing \Localizable.strings\ and \Localizable.stringsdict\ files, which provide translations for menu bar items, settings, provider login flows, and usage metrics, including proper pluralization rules for each language.
Sources/CodexBar/Resources/de.lproj · high confidence
Added Traditional Chinese (zh-Hant) localization
Users can now see the app interface in Traditional Chinese. This change adds the complete set of localized strings and pluralization rules for the zh-Hant locale, covering settings, provider configurations, usage metrics, and system messages.
Sources/CodexBar/Resources/zh-Hant.lproj · high confidence
Added Xcode workspace configuration for Swift Package Manager
A new Xcode workspace file (contents.xcworkspacedata) has been added to the .swiftpm directory. This file configures the Swift Package Manager to generate an Xcode workspace that references the local package, facilitating easier integration and debugging within the Xcode IDE.
.swiftpm · high confidence
Antigravity provider now supports Google OAuth login and account switching
The Antigravity provider in the menu bar now includes a dedicated Google OAuth login flow, allowing users to sign in with their Google account and switch between multiple accounts. This change introduces a new settings option to choose the usage source (Auto, OAuth, or CLI) and adds a toggle to prioritize exhausted quotas in automatic mode. The provider implementation now handles credential storage and retrieval via OAuth, enabling seamless account management directly from the settings UI.
Sources/CodexBar/Providers/Antigravity · high confidence
Augment provider gains CLI usage, automatic session keepalive, and expanded browser support
The Augment provider now supports fetching usage data via the local \auggie\ CLI (with automatic fallback to web-based cookie import) and includes a new automatic session keepalive mechanism that proactively refreshes cookies before they expire to prevent interruptions. Browser cookie import has been expanded to include Chrome Beta, Chrome Canary, and Dia, and the provider now supports manual cookie header input for users who prefer not to use browser integration.
Sources/CodexBarCore/Providers/Augment · high confidence
Claude Swap multi-account support with usage retention and switching
The application now integrates with the external \claude-swap\ tool to manage multiple Claude accounts. This change introduces a new adapter layer that parses the \cswap --list --json\ output to display per-account usage windows (5-hour, 7-day, scoped, and spend limits) and status indicators (such as relogin required or at-limit). Users can now switch between accounts via the UI, with the system preserving historical usage data across restarts to ensure accurate quota tracking even when the external tool's cache is stale. The implementation strictly validates the \cswap\ schema version, handles duplicate emails by appending account numbers, and respects disabled account states.
Sources/CodexBarCore/Providers/Claude/ClaudeSwap · high confidence
Claude provider gains Admin API usage source and profile-scoped CLI session isolation
Users with Anthropic Admin API keys (via \ANTHROPIC\_ADMIN\_KEY\ or \ANTHROPIC\_ADMIN\_WORKSPACE\_SPEND\) can now have their usage and costs tracked through a new Admin API source, providing detailed daily cost and token breakdowns. Additionally, the Claude CLI integration now isolates sessions and caches by specific account profile using a stable identity derived from local configuration, ensuring that usage data and background refreshes are correctly scoped to the active user profile rather than being shared or ambiguous.
Sources/CodexBarCore/Providers/Claude · high confidence
Claude provider now supports account switching via claude-swap
The Claude provider implementation introduces a new \claude-swap\ integration, allowing users to manage and switch between multiple Claude accounts using the external \cswap\ tool. This change adds settings to enable the feature, specify the executable path, and control single-account display, while the runtime and UI components handle account listing, switching, and status updates without exposing credentials to the app.
Sources/CodexBar/Providers/Claude · high confidence
Codex OAuth authentication and usage tracking
This change introduces the core infrastructure for Codex OAuth authentication and usage monitoring within the CodexBarCore provider. It adds credential management (CodexOAuthCredentials) that handles token loading, persistence, and refresh logic based on source type and expiration. It also implements a usage fetcher (CodexOAuthUsageFetcher) to retrieve and parse account-specific data including plan types, rate limits, and credit balances from the spend-controls endpoint, and a token refresher (CodexTokenRefresher) to handle OAuth token renewal via the OpenAI auth endpoint.
Sources/CodexBarCore/Providers/Codex/CodexOAuth · high confidence
CodexBar menu bar icon now consolidates into a single unified status item
The application has replaced the previous multi-icon status bar layout with a single, unified menu bar icon that aggregates usage metrics from all enabled providers. This change simplifies the menu bar appearance by removing duplicate or split status items and introduces a merged switcher interface within the menu to navigate between different provider accounts and usage views. Users will see a cleaner, single-icon presence in the menu bar while retaining access to detailed per-provider usage, cost, and quota information through the consolidated menu structure.
Sources/CodexBar · high confidence
Compact multi-account menu layout for providers with many accounts
When a provider surfaces four or more accounts, the menu now switches to a compact layout: the active account retains its full usage card, while inactive accounts collapse into condensed rows sorted by constraint level, with a healthy tail folding behind a single summary row. This reduces menu height and improves readability for users managing multiple accounts across providers like Codex, Claude, and Pi.
Sources/CodexBarCore · high confidence
Cursor provider support added with app auth, browser cookie import, and local CSV usage reading
The Cursor provider is now fully supported, introducing a new authentication flow that prefers first-party Cursor.app sessions (with a browser cookie fallback) and adds Linux CLI support. Users can now import session cookies from supported browsers (Safari, Chrome, Firefox, etc.) via SweetCookieKit, and the system respects a specific browser import order (Safari first on macOS). Usage data is gathered via a new web-based fetch strategy and can also be read from local \tokscale\-compatible CSV files for offline or local history analysis. The provider descriptor configures menu bar metrics, plan labels, and token cost reporting, while session resolution logic ensures account identity is preserved and stale tokens are rejected.
Sources/CodexBarCore/Providers/Cursor · high confidence
DeepSeek provider now supports Chrome profile selection for detailed usage
The DeepSeek provider implementation now includes a settings picker that allows users to select a specific Chrome profile session. This selection determines which signed-in DeepSeek Platform session supplies detailed usage data, enabling more accurate tracking of usage metrics tied to specific browser profiles.
Sources/CodexBar/Providers/DeepSeek · high confidence
Introduce Amp provider with CLI, API, and web cookie usage fetching
Users can now track usage for the Amp provider. This change adds the Amp provider implementation, including a new CLI probe to fetch usage via the local 'amp' binary, an API strategy using an access token (AMP\_API\_KEY), and a web strategy that imports session cookies from browsers. The provider descriptor configures the fetch pipeline, branding, and usage presentation, while the parser handles free tier, subscription, and credit data from both CLI output and web/API responses.
Sources/CodexBarCore/Providers/Amp · high confidence
Introduce CodexBar desktop application for Linux
Adds a new Qt 6 desktop client for Linux that provides usage monitoring, local spending tracking, and settings management via dedicated windows and an optional system tray icon. The application polls the CodexBar CLI for provider data, supports configurable provider ordering and account selection, and includes display preferences for quota views, reset countdowns, and pace visibility. It also features an installer script for portable archives and integrates with the Omarchy shell theme.
Integrations/Linux · high confidence
Introduce Command Code provider support
Adds a new Command Code provider that allows users to authenticate via browser session cookies (imported from Chrome on macOS or manually pasted) and view their billing usage. The provider fetches live credit balances, rolling usage limits (5-hour and weekly windows), and subscription status from the Command Code API, mapping known subscription plans (Go, GOAT, Pro, Max, Ultra) to monthly credit allowances. It includes a plan cache to handle subscription enrichment timeouts gracefully and persists session cookies to avoid repeated imports.
Sources/CodexBarCore/Providers/CommandCode · high confidence
Introduce Grok provider support with usage tracking and billing integration
Adds a new Grok provider to CodexBar, enabling users to authenticate via SuperGrok OAuth tokens, CLI settings, or browser cookies. The provider fetches and displays weekly credit usage, on-demand spend, and subscription tier details (SuperGrok vs. SuperGrok Heavy) from the Grok CLI proxy and web billing endpoints. It also scans local session logs for token usage statistics and tracks remaining usage-limit reset credits, presenting this data in the Usage & Spend view with configurable reset windows and labels.
Sources/CodexBarCore/Providers/Grok · high confidence
Introduce Groq provider implementation with API key support
A new Groq provider implementation has been added to the application, enabling users to integrate Groq as a usage provider. The implementation registers the provider with the ID \.groq\ and exposes a settings field for an optional API key (prefixed with \gsk\_\). According to the included documentation, the API key is not required for basic usage tracking, which relies on the console.groq.com browser session; the key is specifically intended to enable Enterprise Prometheus metrics as a fallback. The provider also defines a presentation context that displays "metrics" and observes the relevant settings store.
Sources/CodexBar/Providers/Groq · high confidence
Introduce Kiro provider with explicit login flow and settings
The Kiro provider is now implemented with a dedicated login flow that runs the kiro-cli binary with a 120-second timeout, presenting user-facing alerts for success, cancellation, timeouts, or failures (including missing binary or launch errors). A new Re-authenticate action is added to the provider settings, allowing users to re-run the login flow. Additionally, a menu bar display setting lets users choose whether to show Kiro credits, usage percentage, or both next to the menu bar icon.
Sources/CodexBar/Providers/Kiro · high confidence
Introduce MiniMax provider with region selection and billing history
Adds the MiniMax provider to the application, enabling users to select between Global and China mainland API regions. This change introduces support for fetching and displaying MiniMax billing history, including token usage and cash consumption summaries, and adds a new provider descriptor to manage MiniMax-specific settings and authentication modes.
Sources/CodexBarCore/Providers/MiniMax · high confidence
Introduce Personal Access Token (PAT) usage tracking and credential handling
This change adds the core infrastructure for fetching and displaying usage data via a Codex Personal Access Token (PAT). It introduces new source files to manage PAT credentials, construct a specific CLI user-agent string, and fetch usage/whoami data from the OpenAI API. The implementation includes logic to reconcile credit balances and handle permission errors, ensuring that scoped workspace credit balances are shown and that authentication issues are preserved across requests.
Sources/CodexBarCore/Providers/Codex/CodexPAT · high confidence
Introduce declarative OpenRouter provider with credit tracking and usage dashboard integration
The OpenRouter provider is now defined via a declarative descriptor that enables credit-based usage tracking, displaying pay-as-you-go spend and balance in the menu bar and widgets. Users can configure API keys via environment variables or settings, with validation ensuring secure HTTPS endpoints. The provider integrates with the Usage Dashboard to show scoped spending and links to the OpenRouter activity page for detailed usage history.
Sources/CodexBarCore/Providers/OpenRouter · high confidence
Introduce dedicated Copilot provider with multi-account, budget, and credit tracking
This change adds a new, fully-featured Copilot provider implementation to the application. Users can now sign in using multiple GitHub accounts via OAuth device flow, with support for GitHub Enterprise hosts. The provider fetches usage data from the GitHub API and, when enabled, imports budget limits from browser cookies to display spending limits alongside usage. It also supports displaying per-seat AI credit allowances (if configured) and correctly handles token-billed seats and unlimited quota plans, ensuring accurate usage bars and reset dates are shown in the menu bar.
Sources/CodexBarCore/Providers/Copilot · high confidence
Introduce dedicated OpenCodex usage tracking and cost aggregation
Adds a new, independent subsystem for parsing, caching, and aggregating OpenCodex usage logs (usage.jsonl). This includes a read-only JSONL parser with incremental file updates, a dedicated SQLite cache, and a routing dispatcher that maps providers and models to specific subscription tiers (e.g., Codex, Nous, Kimi) or token-only spend. The system aggregates usage into daily, session, and hourly snapshots, pricing entries once per batch to improve performance, and exposes these metrics separately from the main Codex cost ledger.
Sources/CodexBarCore/Vendored/OpenCodexUsage · high confidence
Introduce external event hooks for quota and provider state changes
Users can now configure external commands to run automatically in response to quota and provider state changes. The system supports events including quota thresholds being crossed (quota\_low, quota\_reached, quota\_reset), successful usage updates (usage\_updated), and provider availability shifts (provider\_unavailable, provider\_recovered, refresh\_failed). Hook rules allow scoping by provider and setting specific usage thresholds for low-quota warnings. To prevent command storms, rate limiting is applied to repeating events like usage updates and provider outages, while quota transition events are exempted to ensure all threshold crossings are captured. Commands are executed directly without a shell, with a minimal, safe environment and redacted logs to protect sensitive data.
Sources/CodexBarCore/Hooks · high confidence
Introduce opt-in iCloud sync for settings, providers, and usage snapshots
Users can now opt into syncing their provider configurations, portable preferences, and usage snapshots to iCloud. This change introduces a new CloudSyncCoordinator and CloudSyncEngine that manage the synchronization lifecycle, including handling account changes, local configuration updates, and snapshot queuing. It also includes a ConfigFileWatcher to detect local config file changes and ensure file watching survives atomic replacements, while persistence logic handles migrating legacy email-keyed snapshots to slot keys and cleaning up stale device records.
Sources/CodexBar/Sync · high confidence
Introduces a canonical, versioned sync schema for iCloud settings and provider data
This change establishes the foundational data structures and serialization logic for opt-in iCloud synchronization. It adds a new \CanonicalSyncJSON\ utility to ensure deterministic, hashable JSON encoding (using ISO 8601 dates and sorted keys) and defines a versioned sync schema (\CodexBarSyncSchema\) with a current version of 1. The diff introduces specific sync payloads, including \ProviderIntentPayload\ for non-secret provider configurations (supporting new fields like \accentColor\ and \hiddenUsageItemIDs\), \DeviceSyncPayload\ for device identification, and \AccountSnapshotSyncPayload\ for usage data. These models enable the app to safely sync settings, provider states, and usage snapshots across devices while maintaining backward compatibility through schema versioning.
Sources/CodexBarCore/Sync · high confidence
Muse Code provider adds local token history and prompt-free credential detection
The Muse provider now reads token usage directly from the local CLI session logs (stored in \~/.local/share/muse/sessions) to build a bounded local token history, meaning users see token counts without requiring a network call or exposing dollar costs. To support this, the provider introduces a new credential system that detects the Muse Code login via a local auth file or a prompt-free Keychain check (avoiding blocking UI prompts), and it supports an optional browser cookie import for team quota resolution.
Sources/CodexBarCore/Providers/Muse · high confidence
New Burn Down and Account Usage widgets added to CodexBar
The CodexBar macOS widget extension now includes two new widget types: Burn Down (and a Combined variant) which visualizes remaining budget against an ideal steady burn rate, and Account Usage which displays usage limits and reset countdowns for a specific saved account. These widgets are registered in the new CodexBarWidgetBundle and utilize the existing provider selection infrastructure, allowing users to track detailed quota consumption directly from their desktop.
Sources/CodexBarWidget · high confidence
New CLI commands for cache clearing, usage cards, and configuration management
The CLI now includes several new commands to manage usage data and settings. The \cache clear\ command allows users to selectively clear browser cookie caches or cost usage caches, either for all providers or scoped to a specific one. A new \cards\ command displays provider usage and limits in a card-based layout, with a \--brief\ flag for a compact table view, and includes special handling for Claude multi-account (claude-swap) setups. Additionally, \config\ subcommands have been added to validate configuration, dump settings (with optional secret redaction), list provider statuses, and enable/disable providers or set API keys. A \codex-host-costs\ command is also introduced to fetch and display Codex API-equivalent cost estimates from local or remote hosts.
Sources/CodexBarCLI · high confidence
New CLI installer and documentation list utilities
The repository now includes two new executable scripts in the bin directory. The install-codexbar-cli.sh script provides a hardened installation mechanism for the CodexBar CLI, using a clean environment and administrator privileges to symlink the helper binary to standard paths (/usr/local/bin and /opt/homebrew/bin). Additionally, the docs-list script serves as a helper to invoke the Node.js-based documentation listing logic.
bin · high confidence
New Claude Web usage source with automatic browser cookie authentication
A new usage data source for Claude Web has been added, allowing the app to fetch usage statistics directly from the claude.ai API. This feature automatically extracts session cookies from macOS browsers (using SweetCookieKit) to authenticate, eliminating the need for manual API key setup. It displays session, weekly, and model-scoped usage limits, including specific support for 'Daily Routines' and prepaid credit balances, while handling edge cases like Cloudflare challenges and enterprise account structures.
Sources/CodexBarCore/Providers/Claude/ClaudeWeb · high confidence
New CodexBar agent skills for usage monitoring, live QA, and release management
The .agents directory now includes three new skill definitions: a read-only CodexBar usage skill that safely queries provider limits and credits via a dedicated Python bridge with strict secret redaction; a live QA skill that automates provider usage matrix checks, config validation, and menu verification using CLI and browser tools; and a release skill that guides the signing, notarization, appcast generation, and Homebrew cask updates for macOS app releases.
.agents · high confidence
New OpenAI API usage tracking via Admin API
This change introduces a new provider descriptor and data structures for tracking OpenAI usage via the Admin API. Users can now enable usage tracking by providing an Admin API key (via OPENAI\_ADMIN\_KEY) or a standard API key (via OPENAI\_API\_KEY) along with an optional project ID (via OPENAI\_PROJECT\_ID). The system fetches daily usage buckets including costs, requests, and token breakdowns, presenting them in a dashboard with summaries for the last 7 and 30 days, as well as model-specific usage statistics.
Sources/CodexBarCore/Providers/OpenAI · high confidence
New offline adaptive-refresh replay tooling and agent-aware policy support
Developers can now evaluate adaptive-refresh timing policies against historical JSONL traces using the new \AdaptiveReplayKit\ library and \AdaptiveReplayCLI\ command-line tool. The core decision logic is centralized in \AdaptiveRefreshPolicyCore\, which is shared between the app and the replay engine. The replay tooling introduces an \AgentAwareAdaptiveReplayPolicy\ that incorporates coding activity signals (from Codex and Claude transcripts) to adjust refresh cadence, alongside the standard \AdaptiveReplayPolicy\ and fixed-intensity baselines. The CLI supports replaying traces against multiple policies simultaneously, auditing recorded schedule advances, and outputting detailed metrics in table or JSON format.
Sources/AdaptiveRefreshCore, Sources/AdaptiveReplayCLI, Sources/AdaptiveReplayKit · high confidence
New portable preferences system and XDG config path support
The application now supports XDG Base Directory specification for configuration storage, allowing users to place config files in standard locations via the XDG\_CONFIG\_HOME environment variable or a legacy fallback. A new portable preferences system has been introduced, enabling users to export, import, and sync their settings (such as quota warnings, display options, and switcher shortcuts) across installations or devices. This includes a new \PreferencesDocument\ format for explicit transfer and validation of portable settings, alongside updated configuration storage logic in \CodexBarConfigStore\ to handle these new paths and formats.
Sources/CodexBarCore/Config · high confidence
New provider integrations and shared plugin infrastructure
The app now supports usage tracking for GitKraken, Helmcode, Hugging Face, IBM Bob, and Replicate, with settings for API keys, cookie-based billing, and organization selection. A new shared plugin infrastructure (PluginAPIKeyProviderImplementation and PluginCookieProviderImplementation) centralizes settings UI and cookie handling for many providers, while the ProviderCatalog and ProviderImplementationManifest automatically register all bundled providers.
Sources/CodexBar/Providers/Shared · high confidence
New provider plugins for Abacus AI, ai&, Aixy, Atlas Cloud, Bifrost, and Chutes
This update adds bundled JavaScript/TypeScript provider plugins for Abacus AI, ai&, Aixy, Atlas Cloud, Bifrost, and Chutes, enabling the app to fetch and display usage, billing, and quota data from these services. Abacus AI and ai& plugins track compute credits and API costs respectively, while Aixy and Atlas Cloud plugins surface key usage, budgets, and account balances. Bifrost and Chutes plugins parse gateway quotas and rate limits, with Bifrost supporting custom base URLs and Chutes handling complex quota structures.
Sources/CodexBarCore/Resources · high confidence
New structured logging system with file, stderr, and OSLog support
The application now uses a centralized logging infrastructure (CodexBarLog) that supports multiple output destinations: standard error (plain or JSON), system logs (OSLog on macOS), and a local log file. Users benefit from more robust, concurrency-safe logging with automatic redaction of sensitive data like emails, cookies, and API tokens. The system also introduces configurable log levels and categories, improving diagnostic capabilities for troubleshooting provider and session issues.
Sources/CodexBarCore/Logging · high confidence
Settings redesigned as a System Settings-style split view
The application settings interface has been completely redesigned to match the macOS System Settings aesthetic, utilizing a split-view layout with a sidebar for navigation and a main content area for configuration. This change affects the overall look and feel of the preferences pane, providing a more modern and consistent user experience aligned with native macOS design patterns.
(repo-wide) · high confidence
Sharded Swift test execution in CI
A new Python script, Scripts/ci\_swift\_test\_by\_suite.py, has been added to run Swift Package Manager tests in parallel shards. This change prevents CI hangs by isolating test suites, allowing for better resource utilization and faster feedback loops on macOS and Linux platforms.
python · high confidence
Venice provider now supports web session authentication via browser cookies
The Venice provider has been updated to allow users to authenticate using their existing browser sessions from Venice.ai, in addition to the existing API key method. This change introduces a new 'Web' source mode that imports session cookies (such as \_\session and \\_venice-auth.session-token) from supported browsers on macOS, or accepts manually pasted cookie headers. The provider now distinguishes between API-based and web-based authentication, ensuring that web sessions are used for quota fetching when explicitly selected, while maintaining separate handling for API tokens to avoid credential conflicts.
Sources/CodexBarCore/Providers/Venice · high confidence
Vertex AI OAuth authentication and quota usage reporting
This change introduces the core infrastructure for Vertex AI authentication and usage tracking within the application. Users can now authenticate via Google Cloud Application Default Credentials (ADC), supporting both user credentials and service accounts, with automatic token refresh handling to maintain session validity. Additionally, the system now fetches and reports Vertex AI quota usage (requests and tokens) by querying the Cloud Monitoring API, providing visibility into resource consumption against configured limits.
Sources/CodexBarCore/Providers/VertexAI/VertexAIOAuth · high confidence
Xiaomi MiMo provider now supports local usage fallback and detailed token plan tracking
The Xiaomi MiMo provider now includes an opt-in local usage fallback that reads token usage from a JSON cache generated by the \Scripts/mimo-usage.py\ script, ensuring users see usage data even when browser cookies are unavailable or expired. Additionally, the provider now fetches and displays detailed token plan information, including balance breakdowns (paid vs. granted) and token usage limits, with stale cache data clearly labeled to prevent misinterpretation of local accounting as live platform quota.
Sources/CodexBarCore/Providers/MiMo · high confidence
Architecture
Introduces declarative provider configuration and branding system
The provider registration model has shifted to a descriptor-driven architecture, introducing \ProviderDescriptor\ to define capabilities (such as token cost handling, menu bar metrics, and rate-limit windows) and \ProviderBranding\ to manage visual identity. This change adds support for per-provider accent color overrides, allowing users to customize provider colors via configuration, and introduces \ProviderCredentialAdapter\ to centralize how API keys, cookies, and environment variables are resolved for each provider. Additionally, new utilities like \APITokenFetchStrategy\ and \ProviderCandidateRetryRunner\ standardize how usage data is fetched and retried across different provider types.
Sources/CodexBarCore/Providers · high confidence
Behavioural changes
Add centralized settings storage for T3Chat provider
The T3Chat provider now uses a centralized settings store to manage its configuration, specifically adding support for storing and retrieving the cookie header and cookie source settings. This change consolidates provider-specific settings management, ensuring that T3Chat's authentication and session data are handled consistently with the new centralized provider settings architecture.
Sources/CodexBar/Providers/T3Chat · high confidence
Amp provider now supports explicit configuration for usage source, API token, and cookies
The Amp provider implementation has been refactored to centralize its settings and metadata ownership, introducing explicit user-configurable options for how usage data is retrieved. Users can now select a usage source (Auto, Amp CLI, Access token, or Browser cookies) via a settings picker, with 'Auto' attempting CLI, then token, then cookies in order. When using the Access token or Browser cookies source, users can configure the corresponding API token or manual cookie header, with UI visibility dynamically adjusting based on the selected source. This change replaces previous provider registration macros with explicit settings storage and field descriptors, ensuring that token and cookie settings are managed directly within the provider's configuration scope.
Sources/CodexBar/Providers/Amp · high confidence
Augment provider now requires manual cookie input and includes session management tools
The Augment provider implementation has been refactored to enforce manual cookie sourcing by default, disabling automatic browser cookie imports and requiring users to paste a Cookie header or cURL capture from the Augment dashboard. This change is accompanied by a new settings picker to configure the cookie source, a 'Refresh Session' action in the provider menu, and a runtime that manages session keepalive and force-refresh capabilities to handle expired sessions.
Sources/CodexBar/Providers/Augment · high confidence
Centralized WebKit resource teardown with platform-specific cleanup delays
A new WebKitTeardown utility has been introduced to centralize the cleanup of WKWebView and NSWindow resources, preventing memory leaks and ensuring proper state release. The implementation schedules a delayed cleanup (0.25 seconds) to allow WebKit delegate callbacks to unwind, followed by a polling release phase that waits for the window to become invisible and the web view to stop loading. Notably, on Intel (x86\_64) architectures, the system retains resources longer (up to 8 seconds maximum) and keeps the window visible after cleanup to handle platform-specific quirks, whereas on other architectures it closes the window immediately and releases resources after a shorter 2-second window.
Sources/CodexBarCore/WebKit · high confidence
Claude OAuth credentials are now scoped by profile and history is isolated per credential
Claude OAuth credentials are now stored and retrieved using a profile-scoped keychain cache, preventing one Claude profile from evading or overwriting another's tokens. Additionally, conversation history is now bucketed by a one-way hash of the credential (refresh token or access token), ensuring that token rotations or account switches do not merge distinct user histories. The credential model also now tracks rate-limit tiers and subscription types, and the system supports reading credentials via the macOS Security CLI as an experimental fallback strategy.
Sources/CodexBarCore/Providers/Claude/ClaudeOAuth · high confidence
Codex account reconciliation and usage visibility overhaul
This change introduces a robust account reconciliation system that resolves the active Codex source by matching stored managed accounts against the live system account using identity and fingerprint matching, ensuring correct attribution for multi-account and workspace scenarios. It adds support for displaying Codex Spark usage with dedicated 5-hour and weekly rate-limit windows, and implements a dashboard authority policy to strictly validate ownership before attaching usage, credits, or subscription metadata to the active account. Additionally, it adds a launch gate to throttle background CLI refreshes on repeated failures and improves rate-limit error classification for non-OpenAI backends like Amazon Bedrock.
Sources/CodexBarCore/Providers/Codex · high confidence
Codex provider logic restructured with new settings and refresh guards
The Codex provider implementation has been refactored to introduce a new \CodexConsumerProjection\ for mapping UI errors and projecting usage data, alongside dedicated files for managing login flows (\CodexLoginFlow\), runtime actions, and settings storage. The provider now exposes granular settings toggles for 'OpenAI web extras' (enabling code review and usage breakdown via chatgpt.com), 'OpenAI web battery saver' (to limit background refreshes), 'Local session cost estimates', and 'Historical tracking'. Additionally, the refresh lifecycle is hardened with new \CodexAccountScopedRefreshGuard\ and \CodexWeeklyResetConfirmation\ logic to better handle account transitions, stale results, and weekly credit reset validations.
Sources/CodexBar/Providers/Codex · high confidence
Cursor provider now supports manual cookie input and explicit session management
The Cursor provider implementation has been refactored to allow users to explicitly choose between automatic browser cookie imports and manual cookie pasting. A new settings picker lets users select the cookie source, with manual mode requiring the user to paste a Cookie header from a cursor.com request. The login flow has been hardened to manage cache ownership and session replacement more safely, ensuring that interactive login replaces the session without interference from background refreshes. Additionally, the provider now supports displaying on-demand usage costs and limits in the menu when optional credits are enabled.
Sources/CodexBar/Providers/Cursor · high confidence
Factory provider now supports API key and manual cookie authentication
The Factory usage provider has been updated to allow users to authenticate via an explicit API key or by manually pasting browser cookies, in addition to the previous automatic detection. Users can now select their preferred source (Auto, API key, or Browser cookies) in the provider settings, with the API key stored securely in the config file and cookies handled via a dedicated manual entry field. This change also introduces a login flow that opens the Factory web interface in the default browser for initial authentication.
Sources/CodexBar/Providers/Factory · high confidence
Gemini provider now detects consumer-tier shutdown and guides users to Antigravity
The Gemini provider now detects Google's consumer-tier OAuth shutdown (affecting AI Pro/Ultra accounts) and displays a clear error message directing users to enable the Antigravity provider instead. It also supports switching to Workspace, education, or Code Assist accounts, and improves reliability with a curl fallback for API timeouts.
Sources/CodexBar/Providers/Gemini, Sources/CodexBarCore/Providers/Gemini · high confidence
Improved PTY process lifecycle management and output handling
The PTY host layer now includes a new StreamScanBuffer to correctly handle terminal markers split across read boundaries, ensuring reliable output parsing. Additionally, TTYCommandRunner has been enhanced with a robust process registry that tracks active PIDs and their groups, allowing the system to properly drain and clean up lingering child processes during shutdown or after process exit. This prevents resource leaks and hangs by ensuring all spawned CLI processes are terminated and their resources released when the parent application closes or when a command finishes.
Sources/CodexBarCore/Host/PTY · high confidence
Kilo provider now supports multi-organization usage selection and API/CLI source modes
The Kilo usage provider has been refactored to allow users to select which organizations display in the usage bar, with a new settings UI to toggle individual organizations on or off while always showing the personal account. Additionally, users can now choose the data source for Kilo usage via a new 'Usage source' setting with three modes: Auto (API first, falling back to CLI on auth failures), API only, and CLI only. The provider implementation centralizes settings ownership, handles credential resolution from environment variables or config files, and refreshes organization lists with stale-data protection.
Sources/CodexBar/Providers/Kilo · high confidence
LLM Proxy provider now validates base URLs and supports private network HTTP
The LLM Proxy provider now validates the base URL before sending the API key, ensuring that public hosts use HTTPS while allowing plain HTTP for loopback, private-network proxies, and .local hosts. This change prevents credential exposure over insecure connections and fixes issues with private-network proxy endpoints.
Sources/CodexBarCore/Providers/LLMProxy · high confidence
MiniMax provider now supports API token authentication and region selection
The MiniMax provider implementation has been updated to allow users to authenticate via an API token in addition to the existing cookie-based method, with the token stored securely in the configuration. A new settings picker lets users select the API region (global .io or China mainland .com), ensuring requests are routed to the correct endpoint. The provider also exposes settings for manual cookie pasting and automatic browser cookie imports, with visibility controlled by the selected authentication mode.
Sources/CodexBar/Providers/MiniMax · high confidence
New declarative plugin provider specification and runtime architecture
The plugin system has been refactored to use a new declarative Swift registration model (PluginProviderSpec) that defines provider metadata, credential handling, and fetch strategies, replacing the previous implicit configuration. This change introduces a unified plugin runtime supporting both JavaScriptCore and QuickJS engines, enabling portable JavaScript-based provider plugins across all platforms. A new cookie broker (ProviderPluginCookieBroker) manages browser session cookies with domain isolation and caching, while a strict manifest parser (ProviderPluginManifest) enforces security policies for endpoints, authentication, and capabilities. Users benefit from more reliable provider connections, consistent cookie-based authentication, and the ability for providers to be defined via JavaScript plugins with standardized settings and credential flows.
Sources/CodexBarCore/Plugins · high confidence
Refactored cost usage scanning and pricing logic
The cost usage scanning and pricing engine has been refactored to improve accuracy and performance. This includes a new subagent rollout shape classifier to correctly handle copied prefixes and independent counters, a custom pricing overlay system allowing users to define their own USD rates per model, and a memoized pricing resolver to reduce redundant catalog lookups. Additionally, the JSONL scanner now features a robust tail-state parser to handle truncated files, and the cache models have been updated to support priority turns and project cost rollups.
Sources/CodexBarCore/Vendored/CostUsage · high confidence
Shared parsing and settings infrastructure for provider authentication
This change introduces a set of shared utilities in the provider core to standardize how authentication data is handled across different providers. It adds a \CurlCaptureParser\ to reliably extract URLs and headers from DevTools 'Copy as cURL' text, which allows providers like ZoomMate to reuse consistent shell-unescaping logic. It also introduces \OpenCodeWebParsing\ to normalize quota metrics (usage percentages, reset times) and extract workspace IDs from various JSON and text formats, ensuring consistent quota display. Additionally, a \CreditUsage\ struct is added to reconcile credit counters without altering provider-specific display policies, and a \ProviderCookieSettings\ protocol is defined to standardize how cookie sources and manual headers are managed. These changes reduce duplication and improve the reliability of authentication and quota parsing for users configuring custom providers.
Sources/CodexBarCore/Providers/Shared · high confidence
Stabilized OpenAI dashboard fetching with bounded timeouts and cookie import deadlines
The OpenAI web integration now enforces strict deadlines on browser cookie imports and dashboard data fetches to prevent indefinite hangs and reduce battery drain. A new deadline mechanism ensures that cookie loading and WebView operations time out gracefully, while the dashboard fetcher uses a readiness-probe loop to wait for specific UI signals (like the credits header) before scraping, avoiding early returns on incomplete pages. Additionally, navigation errors are now handled more robustly to ignore cancelled or transient WebKit errors, and cookie imports are serialized to prevent race conditions when accessing browser profiles.
Sources/CodexBarCore/OpenAIWeb · high confidence
Unified Aliyun OneConsole authentication and usage tracking
This change consolidates the Aliyun OneConsole provider logic into a shared core module, introducing a unified cookie import system that supports Chromium browser fallbacks on macOS, a dedicated resolver for the \sec\_token\ (checking dashboard HTML, cookies, and user-info endpoints), and a shared JSON traversal helper for parsing nested subscription data. It also adds a cookie-header builder and routing policy to handle distinct API and dashboard scopes, and implements a standardized usage snapshot parser that extracts per-user and per-team quota details (5-hour, weekly, and monthly windows) from the provider's response.
Sources/CodexBarCore/Providers/Shared/AliyunOneConsole · high confidence
Unified configuration migration and provider identity handling
The application now automatically migrates legacy provider credentials, usage visibility settings, and provider ordering from older storage locations (UserDefaults and Keychain) into the new unified config system. This ensures that existing users retain their custom provider arrangements and hidden usage metrics without manual intervention. Additionally, a new identity mechanism ensures that display preferences (like accent colors and hidden items) do not interfere with fetching or caching usage data, separating presentation from data retrieval logic.
Sources/CodexBar/Config · high confidence
Fixes
Hardened subprocess management with bounded output and robust Linux cleanup
The process execution layer now prevents resource exhaustion and hangs when interacting with external CLIs. Output from child processes is strictly bounded to a 1 MB memory budget, rejecting data that exceeds the limit to avoid uncontrolled memory growth. On Linux, pipe capture is hardened to prevent EMFILE errors and handle Musl compatibility, while process teardown reliably escalates from SIGTERM to SIGKILL with bounded waits to ensure stubborn child processes are fully terminated. Additionally, file descriptor cleanup is improved via portable close-from logic, ensuring no leaked descriptors remain after a process exits.
Sources/CodexBarCore/Host/Process · high confidence
Updated Codex parser hash
The generated parser hash has been refreshed to 98de5f52231e524e, ensuring the system uses the latest parser logic for processing Codex data.
Sources/CodexBarCore/Generated · high confidence
Test coverage
Added crash-safety probe tool for cost store validation; Added test coverage for bundled provider plugins; Expanded Linux platform test coverage for CLI and provider features; Migrate test suite to Swift Testing; New StoreStress harness and CI gate scripts for SQLite usage store and build pipelines.
Dependencies
Initial dependency pinning for CodexBar
This change introduces the initial Swift Package Manager dependency configuration for the CodexBar project, establishing the baseline versions for core libraries including Sparkle (2.9.6), Commander (0.2.4), Swift Crypto (4.5.2), Swift Log (1.15.1), KeyboardShortcuts (3.1.0), and SweetCookieKit (0.5.2).
(dependencies) · high confidence
Updated bundled QuickJS-NG engine to v0.17.0
The embedded QuickJS-NG JavaScript engine in the CQuickJS module has been updated to version 0.17.0. This vendor update includes the latest engine source files, updated headers, and new pre-compiled builtins for modern JavaScript features such as \Array.fromAsync\ and iterator helpers like \zip\ and \zipKeyed\.
Sources/CQuickJS · high confidence
Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
Score
- CAI 31 → 42 (+10.3)
- Rubric changed (rubric-2026.08.15 → rubric-2026.09.15) — scores are not directly comparable.
Lenses
- Code Health 28 → 31 (+3.2)
- Architecture 69 → 93 (+24.5)
- Maturity 82 → 86 (+4.7)
- Readiness 11 → 28 (+16.7)
- Security 68 → 60 (-8.1)
- Domain Modelling 85 (new)
Resolved (16)
- Boundary-crossing change coupling: check-site-locales.mjs ↔ site-locales.mjs (Scripts/check-site-locales.mjs)
- Dimension evaluation failed
- FileTooLong: docs/site-locales.mjs (docs/site-locales.mjs)
- Hotspot: Sources/CodexBarCore/Resources/Plugins/venice.js (Sources/CodexBarCore/Resources/Plugins/venice.js)
- LLM evaluation failed
- No artifact signing
- No automated tests
- No exposed public API
- No tests found
- Secret: generic-api-key (Sources/CodexBarCore/Providers/Windsurf/WindsurfWebFetcher.swift)
- Test reliability not included
- pages (cognitive 26) (Sources/CodexBarCore/Resources/Plugins/openai.js)
- parseLimit (cognitive 23) (Sources/CodexBarCore/Resources/Plugins/zai.js)
- parseLimit (cyclomatic 21) (Sources/CodexBarCore/Resources/Plugins/zai.js)
- parseQuota (cognitive 34) (Sources/CodexBarCore/Resources/Plugins/synthetic.js)
- parseQuota (cyclomatic 26) (Sources/CodexBarCore/Resources/Plugins/synthetic.js)
New (2149)
- AgentSessionNameFormatter.agentPath (cognitive 19) (Sources/CodexBarCore/AgentSession.swift)
- AgentSessionNameFormatter.agentPath (cyclomatic 16) (Sources/CodexBarCore/AgentSession.swift)
- AgentSessionsStore.reconcilePeriodicTasks (cognitive 24) (Sources/CodexBar/AgentSessionsStore.swift)
- AlibabaCodingPlanUsageFetcher.parseUsageSnapshot (cognitive 40) (Sources/CodexBarCore/Providers/Alibaba/AlibabaCodingPlanUsageFetcher.swift)
- AlibabaCodingPlanUsageFetcher.parseUsageSnapshot (cyclomatic 30) (Sources/CodexBarCore/Providers/Alibaba/AlibabaCodingPlanUsageFetcher.swift)
- AlibabaTokenPlanUsageFetcher.fetchUsage (cognitive 18) (Sources/CodexBarCore/Providers/Alibaba/AlibabaTokenPlanUsageFetcher.swift)
- AlibabaTokenPlanUsageFetcher.fetchUsage (cyclomatic 17) (Sources/CodexBarCore/Providers/Alibaba/AlibabaTokenPlanUsageFetcher.swift)
- AlibabaTokenPlanUsageFetcher.throwIfErrorPayload (cognitive 22) (Sources/CodexBarCore/Providers/Alibaba/AlibabaTokenPlanUsageFetcher.swift)
- AlibabaTokenPlanUsageFetcher.throwIfErrorPayload (cyclomatic 17) (Sources/CodexBarCore/Providers/Alibaba/AlibabaTokenPlanUsageFetcher.swift)
- AlibabaTokenPlanWebFetchStrategy.resolveCookieHeaders (cognitive 20) (Sources/CodexBarCore/Providers/Alibaba/AlibabaTokenPlanProviderDescriptor.swift)
- AliyunOneConsoleChromiumCookieFallbackImporter.readCookies (cognitive 18) (Sources/CodexBarCore/Providers/Shared/AliyunOneConsole/AliyunOneConsoleChromiumCookieFallbackImporter.swift)
- AliyunOneConsoleCookieImporter.importSession (cognitive 26) (Sources/CodexBarCore/Providers/Shared/AliyunOneConsole/AliyunOneConsoleCookieImporter.swift)
- AmpUsageParser.extractObject (cognitive 20) (Sources/CodexBarCore/Providers/Amp/AmpUsageParser.swift)
- AmpUsageParser.parse (cognitive 38) (Sources/CodexBarCore/Providers/Amp/AmpUsageParser.swift)
- AmpUsageParser.parse (cyclomatic 34) (Sources/CodexBarCore/Providers/Amp/AmpUsageParser.swift)
- AmpUsageSnapshot.toUsageSnapshot (cognitive 32) (Sources/CodexBarCore/Providers/Amp/AmpUsageSnapshot.swift)
- AmpUsageSnapshot.toUsageSnapshot (cyclomatic 24) (Sources/CodexBarCore/Providers/Amp/AmpUsageSnapshot.swift)
- AntigravityCLIHTTPSFetchStrategy.tryWarmAgyFetch (cognitive 29) (Sources/CodexBarCore/Providers/Antigravity/AntigravityProviderDescriptor.swift)
- AntigravityCLIHTTPSFetchStrategy.tryWarmAgyFetch (cyclomatic 19) (Sources/CodexBarCore/Providers/Antigravity/AntigravityProviderDescriptor.swift)
- AntigravityCLIHTTPSFetchStrategy.waitForSnapshot (cognitive 30) (Sources/CodexBarCore/Providers/Antigravity/AntigravityProviderDescriptor.swift)
- …and 2129 more
Changes since last survey
- 300 commits — 188 feature/other, 112 fixes
By area
- Sources/CodexBarCore — 71 commits
- Tests/CodexBarTests — 62 commits
- (repo) — 59 commits
- (root) — 48 commits
- Sources/CodexBar — 41 commits
- Sources/CodexBarCLI — 3 commits
- .github/pr-proof — 2 commits
- Integrations/Linux — 2 commits
- Sources/CodexBarWidget — 2 commits
- docs/plugin-conversion-matrix.md — 2 commits
- Scripts/check-release-assets.sh — 1 commit
- Scripts/check-site-locales.mjs — 1 commit
- Scripts/check_repository_size.sh — 1 commit
- Scripts/regenerate-provider-manifests.sh — 1 commit
- Sources/CQuickJS — 1 commit
- TestsLinux/ResetCountdownDayRolloverLinuxTests.swift — 1 commit
- docs/logos — 1 commit
- docs/opencode.md — 1 commit
Notable commits
- fix: Fix Cursor all-history cost refresh dates
- fix: Fix status item teardown on quit
- fix: Merge pull request #4005 from RowboTony/fix/codex-usage-dashboard-url
- fix: Merge pull request #4010 from harjothkhara/codex/fix-4009-status-dot-tooltip
- fix: Merge pull request #4018 from massdo/fix/codex-daemon-socket-symlink
- fix: Merge pull request #4022 from mymatejackson/fix/status-item-shutdown-ghosts
- fix: Merge pull request #4026 from shirishpothi/fix/clinepass-browser-signin
- fix: Merge pull request #4028 from Yuxin-Qiao/fix/spend-refresh-failure
- fix: chore(codex): sync daemon socket fix with main
- fix: chore: reconcile Codex dashboard fix with current main
- fix: chore: reconcile dashboard fix with current changelog
- fix: chore: reconcile sidebar fix with current changelog
- fix: chore: retain post-release plugin fixes for 0.64.1
- fix: fix(alibaba): parse monthly Token Plan usage
- fix: fix(antigravity): explain offline fallback and source status (#3865)
- fix: fix(antigravity): honor explicit CLI overrides (#3847)
- fix: fix(antigravity): retain cadence-less quota history (#3856)
- fix: fix(bifrost): prefer component rate limits over aggregate (#3858)
- fix: fix(claude): bound account switch reconciliation (#3812)
- fix: fix(claude): dismiss panels before reusing CLI sessions (#3854)
- …and 280 more
Architecture
- Containers 0 added · 0 removed · contexts 1 added · 0 removed · edges 0 added · 0 removed
Added bounded contexts (1)
- python
Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
steipete/CodexBar was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 27 September 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit e2846df2a4fd4afc56272314e9052c448f5db03f — the exact code this score is about.
- Scored under rubric-2026.09.15 — the same rubric and the same method as every other entry in this index.
- Measured by watchdog.canine.dev using codehealth-analyzer preprod-d00c643c3f66.