opencode-bar

Automatically monitor all your AI provider usage from OpenCode in real-time from the macOS menu bar.

Installation

Homebrew (Easy)

brew install --cask opgginc/tap/opencode-bar

Download

Download the latest .dmg file from the Releases page.

Overview

OpenCode Bar automatically detects and monitors all AI providers registered in your OpenCode configuration. No manual setup required - just install and see your usage across all providers in one unified dashboard.

Supported Providers (Auto-detected from OpenCode)

OpenCode Plugins

• Antigravity/Gemini
  • NoeFabris/opencode-antigravity-auth (writes ~/.config/opencode/antigravity-accounts.json)
  • jenslys/opencode-gemini-auth (writes google.oauth in OpenCode auth.json)
  • Gemini CLI OAuth creds (writes ~/.gemini/oauth_creds.json for email/account ID metadata; overlaps are merged with Antigravity accounts)
• Claude: anomalyco/opencode-anthropic-auth

Standalone tools

• Codex: Soju06/codex-lb (writes ~/.codex-lb/)

Other AI agents beyond OpenCode that supports auto-detection

• GitHub Copilot (multi-source discovery)
  • OpenCode auth - Auto-detected from OpenCode auth.json (copilot provider entry)
  • Copilot CLI - Auto-detected through macOS Keychain (github.com entries)
  • VS Code / Cursor - Auto-detected from ~/.config/github-copilot/hosts.json and ~/.config/github-copilot/apps.json
  • Browser Cookies - Chrome, Brave, Arc, Edge session cookies
  • Multiple accounts from different sources are automatically deduplicated and merged
• Codex
  • Codex for Mac - Auto-detected through ~/.codex/auth.json
  • Codex CLI - Auto-detected through ~/.codex/auth.json
• Claude Code CLI - Keychain-based authentication detection

Features

Automatic Provider Detection

• Zero Configuration: Reads your OpenCode auth.json automatically
• Multi-path Support: Searches $XDG_DATA_HOME/opencode, ~/.local/share/opencode, and ~/Library/Application Support/opencode
• Dynamic Updates: New providers appear as you add them to OpenCode
• Smart Categorization: Pay-as-you-go vs Quota-based providers displayed separately

Real-time Monitoring

• Menu Bar Dashboard: View all provider usage at a glance
• Visual Indicators: Color-coded progress (green → yellow → orange → red)
• Detailed Submenus: Click any provider for in-depth metrics
• Auth Source Labels: See where each account token was detected (OpenCode, VS Code, Keychain, etc.)
• Gemini Account Labels: Shows Gemini CLI (email) when email is available, with fallback to Gemini CLI #N

Usage History & Predictions

• Daily Tracking: View request counts and overage costs
• EOM Prediction: Estimates end-of-month totals using weighted averages
• Add-on Cost Tracking: Shows additional costs when exceeding limits

Subscription Settings (Quota-based Providers Only)

• Per-Provider Plans: Configure your subscription tier for quota-based providers
• Cost Tracking: Accurate monthly cost calculation based on your plan
• Orphaned Plan Cleanup: Detect and reset stale subscription entries that no longer match accounts

Convenience

• Launch at Login: Start automatically with macOS
• Parallel Fetching: All providers update simultaneously for speed
• Auto Updates: Seamless background updates via Sparkle framework

Development

Build from Source

# Clone the repository
git clone https://github.com/opgginc/opencode-bar.git
cd opencode-bar

# Build
xcodebuild -project CopilotMonitor/CopilotMonitor.xcodeproj \
  -scheme CopilotMonitor -configuration Debug build

# Open the app (auto-detect path)
open "$(xcodebuild -project CopilotMonitor/CopilotMonitor.xcodeproj -scheme CopilotMonitor -configuration Debug -showBuildSettings 2>/dev/null | sed -n 's/^[[:space:]]*BUILT_PRODUCTS_DIR = //p' | head -n 1)/OpenCode Bar.app"

Requirements:

• macOS 13.0+
• Xcode 15.0+ (for building from source)
• OpenCode installed with authenticated providers

Usage

Menu Bar App

1. Install OpenCode: Make sure you have OpenCode installed and authenticated with your providers
2. Launch the app: Run OpenCode Bar
3. View usage: Click the menu bar icon to see all your provider usage
4. GitHub Copilot (optional): Automatically detected from multiple sources — OpenCode auth, Copilot CLI Keychain, VS Code/Cursor config files, and browser cookies (Chrome, Brave, Arc, Edge). Multiple accounts are deduplicated automatically.

Command Line Interface (CLI)

OpenCode Bar includes a powerful CLI for querying provider usage programmatically.

Installation

# Option 1: Install via menu bar app
# Click "Install CLI" from the Settings menu

# Option 2: Manual installation
bash scripts/install-cli.sh

# Verify installation
opencodebar --help

Commands

# Show all providers and their usage (default command)
opencodebar status

# List all available providers
opencodebar list

# Get detailed info for a specific provider
opencodebar provider claude
opencodebar provider gemini_cli
opencodebar provider minimax_coding_plan

# Output as JSON (for scripting)
opencodebar status --json
opencodebar provider claude --json
opencodebar provider minimax_coding_plan --json
opencodebar list --json

Table Output Example

$ opencodebar status
Provider              Type             Usage       Key Metrics
─────────────────────────────────────────────────────────────────────────────────
Claude                Quota-based      77%         23/100 remaining
Codex                 Quota-based      0%          100/100 remaining
Copilot (user1)       Quota-based      45%         550/1000 remaining
Copilot (user2)       Quota-based      12%         880/1000 remaining
Gemini CLI ([email protected]) Quota-based      0%          100% remaining
Gemini CLI ([email protected]) Quota-based    15%         85% remaining
Kimi for Coding       Quota-based      26%         74/100 remaining
MiniMax Coding Plan   Quota-based      0%,0%      100/100 remaining
OpenCode Zen          Pay-as-you-go    -           $12.50 spent
OpenRouter            Pay-as-you-go    -           $37.42 spent

MiniMax Notes

• MiniMax Coding Plan is resolved from the OpenCode auth entry minimax-coding-plan in auth.json.
• OpenCode Bar uses the Coding Plan remains endpoint and converts it into used percentages for the menu bar app and CLI.
• MiniMax response fields current_interval_usage_count and current_weekly_usage_count behave as remaining counts despite their names, so OpenCode Bar calculates used percent as total - remaining.

JSON Output Example

$ opencodebar status --json
{
  "claude": {
    "type": "quota-based",
    "remaining": 23,
    "entitlement": 100,
    "usagePercentage": 77,
    "overagePermitted": false
  },
  "copilot": {
    "type": "quota-based",
    "remaining": 1430,
    "entitlement": 2000,
    "usagePercentage": 28,
    "overagePermitted": true,
    "accounts": [
      {
        "index": 0,
        "login": "user1",
        "authSource": "opencode",
        "remaining": 550,
        "entitlement": 1000,
        "usagePercentage": 45,
        "overagePermitted": true
      },
      {
        "index": 1,
        "login": "user2",
        "authSource": "copilot_cli_keychain",
        "remaining": 880,
        "entitlement": 1000,
        "usagePercentage": 12,
        "overagePermitted": true
      }
    ]
  },
  "gemini_cli": {
    "type": "quota-based",
    "remaining": 85,
    "entitlement": 100,
    "usagePercentage": 15,
    "overagePermitted": false,
    "accounts": [
      {
        "index": 0,
        "email": "[email protected]",
        "accountId": "100663739661147150906",
        "remainingPercentage": 100,
        "modelBreakdown": {
          "gemini-2.5-pro": 100,
          "gemini-2.5-flash": 100
        }
      },
      {
        "index": 1,
        "email": "[email protected]",
        "accountId": "109876543210987654321",
        "remainingPercentage": 85,
        "modelBreakdown": {
          "gemini-2.5-pro": 85,
          "gemini-2.5-flash": 90
        }
      }
    ]
  },
  "openrouter": {
    "type": "pay-as-you-go",
    "cost": 37.42
  }
}

Use Cases

• Monitoring: Integrate with monitoring systems to track API usage
• Automation: Build scripts that respond to quota thresholds
• CI/CD: Check provider quotas before running expensive operations
• Reporting: Generate usage reports for billing and analysis

Exit Codes

Menu Structure

─────────────────────────────
Pay-as-you-go: $37.61
  OpenRouter       $37.42    ▸
  OpenCode Zen     $0.19     ▸
─────────────────────────────
Quota Status: $219/m
  Copilot          0%        ▸
  Claude: 60%, 100%          ▸
  Codex            100%      ▸
  MiniMax Coding Plan 0%, 0% ▸
  Z.AI Coding Plan 99%       ▸
  Gemini CLI ([email protected]) 100% ▸
─────────────────────────────
Predicted EOM: $451
─────────────────────────────
Refresh (⌘R)
Auto Refresh              ▸
Settings                  ▸
─────────────────────────────
Version 2.1.0
Quit (⌘Q)

Menu Group Titles

Status Bar Options

• Menu Bar Display: Choose one of Total Cost, Icon Only, or Only Show.
• Critical Badge: Toggle on/off to show or hide the critical-usage badge.
• Show Provider Icon: Toggle on/off to append the selected provider icon in the status bar.

Status Bar Icon Behavior:
The primary OpenCode Bar status icon always stays visible. Provider icons are rendered as an additional icon next to the primary icon (not a replacement).

Gemini Icon Sizing:
Gemini uses a slightly larger icon size than other providers in both menu rows and the status bar to match the official visual balance.

Note: Subscription settings are only available for quota-based providers. Pay-as-you-go providers do not have subscription options since they charge based on actual usage.

Terminology:
Status Bar Percent means the single representative percentage shown in the macOS top status bar text.
Dropdown Detail Percents means the multi-window percentages shown in provider rows inside the opened dropdown menu.

Status Bar Percent Rule: Status Bar Percent uses one fixed priority:
Weekly → Monthly → Daily → Hourly → fallback aggregate.
If multiple values exist in the same priority window, the highest value is shown (for example, Claude weekly picks max of 7d/Sonnet/Opus).
In Recent Quota Change Only, provider selection is based on change, but the shown percentage is the provider's current priority-based usage.

Dropdown Detail Percents Rule: top-level menu rows keep multi-window percentages when available.

How It Works

1. Token Discovery: Reads authentication tokens from OpenCode's auth.json (with multi-path fallback)
2. Multi-Source Account Discovery: For providers like GitHub Copilot, discovers accounts from multiple sources (OpenCode auth, CLI Keychain, VS Code config, browser cookies) and deduplicates by login/email
3. Parallel Fetching: Queries all provider APIs simultaneously using TaskGroup
4. Smart Caching: Falls back to cached data on network errors
5. Graceful Degradation: Shows available providers even if some fail

MiniMax Coding Plan uses https://api.minimax.io/v1/api/openplatform/coding_plan/remains and is displayed with explicit 5h used and weekly used windows in the provider submenu.

Privacy & Security

• Local Only: All data stays on your machine
• No Third-party Servers: Direct communication with provider APIs
• Read-only Access: Uses existing OpenCode tokens (no additional permissions)
• Browser Cookie Access: GitHub Copilot reads session cookies from your default browser (read-only, no passwords stored)

Troubleshooting

"No providers found" or auth.json not detected

The app searches for auth.json in these locations (in order):

1. $XDG_DATA_HOME/opencode/auth.json (if XDG_DATA_HOME is set)
2. ~/.local/share/opencode/auth.json (default)
3. ~/Library/Application Support/opencode/auth.json (macOS fallback)

GitHub Copilot not showing

GitHub Copilot accounts are discovered from multiple sources (in priority order):

1. OpenCode auth — copilot entry in OpenCode auth.json
2. Copilot CLI Keychain — macOS Keychain entries for github.com
3. VS Code / Cursor — ~/.config/github-copilot/hosts.json and apps.json
4. Browser Cookies — Chrome, Brave, Arc, Edge session cookies

If Copilot still doesn't appear:

• Verify at least one source has valid credentials (opencodebar provider copilot for details)
• For browser cookies: make sure you're signed into GitHub in a supported browser
• Accounts from different sources with the same login are automatically merged

OpenCode CLI commands failing

The app dynamically searches for the opencode binary in:

• Current PATH (which opencode)
• Login shell PATH
• Common install locations: ~/.opencode/bin/opencode, /usr/local/bin/opencode, etc.

Contributing

Contributions are welcome! Please submit a Pull Request.

Development Setup

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Setup Git Hooks (run once after clone):

   make setup
   

   This configures pre-commit hooks for:
   • SwiftLint: Checks Swift code style on staged .swift files
   • action-validator: Validates GitHub Actions workflow files
4. Make your Changes
5. Commit your Changes (git commit -m 'Add some AmazingFeature')
   • Pre-commit hooks will automatically check your code
   • Fix any violations or use git commit --no-verify to bypass (not recommended)
6. Push to the Branch (git push origin feature/AmazingFeature)
7. Open a Pull Request

Code Quality

This project uses SwiftLint and action-validator to maintain code quality:

• Pre-commit Hook: Runs on git commit (setup via make setup)
  • SwiftLint for .swift files
  • action-validator for .github/workflows/*.yml files
• GitHub Actions: Runs on all pushes and pull requests
• Manual Check: make lint (or make lint-swift, make lint-actions)

License

MIT License - See LICENSE file for details.

Related

• OpenCode - The AI coding assistant that powers this monitor
• GitHub Copilot

Credits

• OP.GG
• Sangrak Choi

Made with tiredness for AI power users