explaingit

methol/usage-bar

Analysis updated 2026-05-18

1SwiftAudience · developerComplexity · 2/5LicenseSetup · easy

TLDR

A macOS menu bar app that shows your Claude, Codex, and Gemini usage limits at a glance.

Mindmap

mindmap
  root((UsageBar))
    What it does
      Shows usage limits
      Menu bar icon
      Multi provider tabs
      History chart
    Tech stack
      Swift
      SwiftUI
      Swift Charts
    Use cases
      Avoid rate limits
      Track cost estimate
      Check usage fast
    Audience
      Claude users
      Codex users
      Gemini users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Check remaining Claude, Codex, or Gemini usage without opening a browser.

USE CASE 2

Get an early warning before hitting a five hour or seven day rate limit.

USE CASE 3

Track estimated dollar cost of extra usage over time with a history chart.

What is it built with?

SwiftSwiftUISwift Charts

How does it compare?

methol/usage-baraltuzar/sonicflowcollinkite/steamcontrollerkit
Stars111
LanguageSwiftSwiftSwift
Setup difficultyeasyeasymoderate
Complexity2/52/53/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires macOS 14 Sonoma or later, signing in to Codex or Gemini needs existing CLI credentials.

Use, modify, and redistribute freely, including commercially, under a permissive BSD-style license.

In plain English

UsageBar is a small macOS menu bar app that shows how much of your Claude, Codex, or Gemini usage allowance you have used, without needing to open a browser and check a usage page. A compact icon sits in the menu bar with a mini bar chart for both the short five hour window and the longer seven day window, and clicking it opens a detailed popover with per model breakdowns and reset timers. The popover lets you switch between tabs for Claude, Codex, and Gemini, so if you use more than one of these services you can track them all from the same app. It also shows extra usage cost estimated in US dollars using public pricing data, and a history chart so you can see how your usage has changed over recent hours, days, or weeks. Hovering over the chart reveals the exact values at any point in time. Signing in is meant to be simple: Claude uses OAuth through your browser so you never handle an API key directly, while Codex and Gemini read credentials that are already saved by their command line tools. The app checks your usage on a configurable schedule, such as every thirty minutes, and can check for its own updates automatically. To install it, you download a disk image from the project's releases page and drag the app into your Applications folder, or build it from source using Xcode if you prefer. It requires macOS fourteen or later, known as Sonoma, and runs natively on both Apple Silicon and Intel Macs as a single universal binary. The app is aimed at people who use Claude, Codex, or Gemini command line tools regularly and want an at a glance way to avoid hitting rate limits unexpectedly.

Copy-paste prompts

Prompt 1
Walk me through installing UsageBar and signing in with my Claude account.
Prompt 2
Explain what UsageBar's five hour and seven day usage bars mean.
Prompt 3
Help me build UsageBar from source using Xcode on my Mac.
Prompt 4
How do I switch UsageBar's polling interval so it checks usage less often?

Frequently asked questions

What is usage-bar?

A macOS menu bar app that shows your Claude, Codex, and Gemini usage limits at a glance.

What language is usage-bar written in?

Mainly Swift. The stack also includes Swift, SwiftUI, Swift Charts.

What license does usage-bar use?

Use, modify, and redistribute freely, including commercially, under a permissive BSD-style license.

How hard is usage-bar to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is usage-bar for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.