steipete/CodexBar
CodexBar
CodexBar is a macOS menu bar application that monitors AI provider usage limits, credit balances, and reset schedules. It retrieves coding plan usage data from Alibaba Cloud services using either API keys or browser session cookies as fallback authentication, and displays the information through visual credit gauges, CLI commands, and desktop status bar integrations.
The application distinguishes itself by supporting multiple authentication methods, including automatic cookie import from Safari, Chrome, or Firefox, as well as API key and access token authentication. It provides real-time tracking of credit usage, billing cycles, free allowances, and aggregated provider spending, all rendered through visual gauges with pace indicators and projected deficit estimates. CodexBar also offers menu bar icon merging for multiple providers, environment variable configuration for custom endpoints, and direct links to management consoles.
Beyond its core monitoring capabilities, the tool integrates with Waybar, GNOME Shell, KDE Plasma, and terminal status bars to display AI quota information. It supports command-line usage queries for scripting and CI pipeline integration, and can show customizable code snippets directly in the macOS menu bar. The application polls provider status endpoints and displays incident badges when services are degraded.
Features
- Alibaba Cloud Coding Plan Quotas - Retrieves Alibaba Cloud coding plan usage data via API keys or browser cookies for quota monitoring.
- Alibaba Coding Plan Quota Trackers - Fetches and displays coding plan usage data from Alibaba Cloud's Model Studio or Bailian console.
- API Key Authentication - Authenticates quota requests to the Alibaba Coding Plan endpoint using a configured API key or environment variable.
- Browser Session Authentication - Imports cookies from the Model Studio or Bailian console to authenticate quota requests without needing an API key.
- Usage Monitors - Monitors real-time usage limits, credit balances, and reset countdowns for multiple AI coding providers.
- Credit Usage Gauges - Renders visual credit gauges with pace indicators and projected deficit estimates for usage monitoring.
- Provider Status Icon Mergers - Combines multiple provider status items into a single menu bar icon with a switcher to cycle between them.
- Billing Cycle Projections - Displays the next billing date and calculates projected usage through the current billing period.
- Daily Free Usage Trackers - Shows how much daily free usage remains and when it will fully replenish.
- Workspace Credit Balances - Shows remaining individual and workspace credit balances reported by the service.
- Spend Tracking Tools - Aggregates cost and spend data from provider APIs and local logs to present billing summaries and usage charts.
- Usage Data CLI Commands - Executes local CLI commands to fetch usage data for scripting and CI pipeline integration.
- Provider Status Mergers - Combines multiple provider status indicators into a single menu bar icon with a click-to-cycle switcher.
- CLI Usage Queries - Fetches cost and usage data using a command-line tool for scripting and CI pipeline integration.
- Local CLI Usage Retrievals - Runs the local Amp CLI command to retrieve usage data when the CLI is installed and signed in.
- Browser Cookie Imports - Automatically imports session cookies from Safari, Chrome, or Firefox for authenticated API access.
- Multi-Provider Cookie Injections - Injects browser session cookies into API requests to authenticate for multiple providers.
- Menu Bar Utilities - Ships a menu bar utility that displays customizable code snippets and text for quick access.
- Menu Bar Credit Gauges - Shows a visual gauge of credits used versus plan total with a pace indicator and projected deficit estimate.
- AI Tools - Menu bar tool for monitoring AI service usage.
- Menu Bar Tools - Display usage statistics for AI models.
- Menu Bar Utilities - Listed in the “Menu Bar Utilities” section of the Awesome Mac awesome list.
