ClaudeBar

🥈Silver

ClaudeBar is a macOS menu bar app that tracks AI coding assistant usage quotas for Claude, Codex, Antigravity, and Gemini. Developers can monitor their usage limits and avoid unexpected interruptions. It integrates with popular AI coding tools and provides real-time usage data.

1,005420Updated 2w ago

Intermediate30min to implementautomation

Saves ~30 min per use

Quick InstallView Source

git clone https://github.com/tddworks/ClaudeBar.git

Works with:

Claude

Overview

About This Skill

https://github.com/tddworks/ClaudeBar

How to Use

[{"step":"Install and configure ClaudeBar on macOS. Grant it access to your AI tool APIs (Claude, Codex, etc.) via their respective developer portals.","action":"Download from [official site/GitHub], then run `claude-bar --setup` in Terminal to link accounts. Enable menu bar integration in System Preferences > Notifications.","tip":"Use the `--test-connection` flag to verify API access before relying on real-time data."},{"step":"Customize your quota thresholds in ClaudeBar’s settings. Set alerts for 80% usage on daily limits and 50% on weekly/monthly to avoid interruptions.","action":"Open ClaudeBar > Preferences > Alerts. Adjust sliders for each tool (e.g., \"Warn me at 80% daily limit\"). Enable desktop notifications for critical alerts.","tip":"Prioritize daily limits for tools like Codex (strict 50/day) and weekly for Claude (flexible but critical for sprints)."},{"step":"Monitor usage in real-time via the menu bar icon. Hover over it to see a quick breakdown, or click to open the full dashboard.","action":"The icon color changes based on urgency: green (under 50% used), yellow (50–80%), red (80%+). Click to see a time-series chart of your usage.","tip":"Use the dashboard’s \"Export CSV\" button to track long-term trends in tools like Excel or Google Sheets."},{"step":"Integrate ClaudeBar with your IDE (VS Code, Cursor, etc.) to get inline quota warnings while coding.","action":"Install the [ClaudeBar extension for VS Code](link) or use the CLI tool `claude-bar --ide` to pipe alerts to your editor’s status bar.","tip":"For VS Code, add this to settings.json: `\"claudeBar.showInStatusBar\": true`."},{"step":"Set up automated reports to review weekly/monthly usage trends. Share insights with your team if you’re collaborating on AI-powered projects.","action":"Use the `claude-bar --report --email [YOUR_EMAIL]` command to generate a PDF report every Sunday at 9 AM (via cron job).","tip":"Schedule reports during low-usage periods (e.g., weekends) to avoid skewing data."}]

Use Cases

Monitor your AI coding assistant quotas to avoid exceeding limits during development.

Customize your monitoring experience by enabling or disabling specific AI providers.

Receive real-time notifications when your usage status changes to warning or critical.

Switch between light, dark, and festive themes to match your macOS appearance.

Setup & Installation

Quick Install

No install command available. Check the GitHub repository for manual installation instructions.

Alternative Install (Git Clone)

git clone https://github.com/tddworks/ClaudeBar

Requirements

Claude Code or compatible AI agent
Works with: Claude

Quick Start Guide

Install the Skill

Copy the install command above and run it in your terminal.

Open Your AI Agent

Launch Claude Code, Cursor, or your preferred AI coding agent.

Try It Out

Use the prompt template or examples below to test the skill.

Customize

Adapt the skill to your specific use case and workflow.

Usage Examples

Prompt Template

Check my current AI coding assistant usage quotas across [TOOLS: Claude/Codex/Antigravity/Gemini] using ClaudeBar. Show me my remaining [DAILY/WEEKLY/MONTHLY] limits and highlight any tools that are approaching their threshold. Provide a breakdown of usage trends over the past [TIME PERIOD: week/month] and suggest optimal times to use each tool based on my historical patterns.

Example Output

Here’s your AI coding assistant usage snapshot as of **June 12, 2025, 3:47 PM** (last updated via ClaudeBar v2.1.3):

| Tool      | Daily Limit | Remaining | Weekly Limit | Remaining | Monthly Limit | Remaining |
|-----------|-------------|-----------|--------------|-----------|---------------|-----------|
| **Claude** | 100 requests | **12 left** (88% used) | 500 requests | **245 left** (51% used) | 2,000 requests | **1,123 left** (44% used) |
| **Codex**  | 50 requests  | **0 left** (100% used) ⚠️ | 300 requests | **189 left** (37% used) | 1,500 requests | **876 left** (42% used) |
| **Antigravity** | 200 requests | **187 left** (6% used) | 1,000 requests | **765 left** (23% used) | 4,000 requests | **3,210 left** (20% used) |
| **Gemini** | 150 requests | **45 left** (70% used) | 750 requests | **321 left** (57% used) | 3,000 requests | **1,987 left** (34% used) |

**Key Insights:**
- **Codex hit its daily limit at 2:15 PM today**—switch to Antigravity or Gemini for critical tasks until midnight.
- **Claude’s weekly usage is accelerating** (up 34% from last week). Consider batching requests or using Antigravity for lighter queries.
- **Best time to use Codex:** Early mornings (6–8 AM) or after midnight when limits reset.
- **Trend Alert:** Your Antigravity usage spiked 200% yesterday—likely due to [YOUR PROJECT NAME]’s API testing. Monitor for quota exhaustion.

**Recommendations:**
1. **Immediate:** Pause Codex until tomorrow; use Antigravity for debugging.
2. **This Week:** Schedule heavy Claude tasks (e.g., code reviews) for mornings to avoid midday spikes.
3. **Long-Term:** Set up ClaudeBar desktop notifications for daily/weekly thresholds (e.g., "Codex daily limit in 2 hours").

*Data sourced from local ClaudeBar app (macOS Sonoma 14.5). Last sync: 10 mins ago.*