geebos

geebos / agent-battery

Public

A macOS menu bar app that displays your AI agent usage quota as a battery indicator.

17
1
100% credibility
Found May 06, 2026 at 17 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Swift
AI Summary

A macOS menu bar app that monitors and displays remaining usage quotas for Claude Code and Codex tools as intuitive battery percentages by reading local usage files.

How It Works

1
🔍 Discover the app

You hear about Agent Battery, a simple Mac menu bar tool that shows your AI usage like a phone battery so you always know what's left.

2
💾 Download and install

Grab the ready-made app file from releases and drag it into your Applications folder, then allow it to run if your Mac asks.

3
🚀 Launch from menu bar

Find the battery icon in your top menu bar, click it, and see your first usage snapshot or a quick setup prompt.

4
🔧 One-click setup

In settings, tap to connect your main AI tool (like Claude), and it automatically starts tracking without any hassle.

5
📊 Check details anytime

Click the icon to pop open a view with battery percentages, reset times, colorful charts, and usage trends for your tools.

6
⚙️ Make it yours

Tweak colors, refresh speed, display style, or auto-start on login right from the friendly settings panel.

✅ Stay powered up

Your menu bar now always shows clear battery levels for your AI quotas, helping you plan and avoid running dry.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 17 to 17 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is agent-battery?

Agent Battery is a Swift macOS menu bar app that tracks your AI agent usage quotas—like Claude Code's 5-hour window and Codex's weekly limits—as a battery-style percentage indicator. It reads directly from local CLI files for privacy-focused, real-time updates without APIs or logins, showing color alerts for low quotas. Click the icon for a popover with side-by-side comparisons, reset timers, and history charts.

Why is it gaining traction?

In a sea of web dashboards, this github macos client delivers instant menu bar visibility into agent battery levels, with configurable refresh (30s to 5min), display modes (battery, percent, tool name), and thresholds. One-click setup injects hooks into Claude Code while preserving your workflow, plus bilingual English/Chinese support. No bloat—just quota awareness for heavy CLI users.

Who should use this?

Mac developers hammering Claude Code or Codex terminals, constantly checking rate limits mid-session. Ideal for those building AI agents on macOS who want a macos menu bar glance at remaining tokens, without browser tabs. Skip if you're not on these tools or prefer GitHub's macos github desktop integrations.

Verdict

Solid pick for niche quota tracking; try the DMG or build script for quick setup. With 17 stars and 1.0% credibility, it's immature but well-documented with tests—watch for notarization as it matures. (187 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.