Free · Open source · Native

Your AI usage. One glance away.

Track your AI usage limits directly from your menu bar. Currently supports Claude and Codex.

Download for macOS — FreeView on GitHub

macOS available nowWindows plannedInstall notes

Illustration · sample data

01 The problem

Stop checking dashboards.

  • No dashboard hunting.
  • No browser tab.
  • No guessing.

Your limits stay in the menu bar while you work. TokenBar shows how much of each plan limit you have used, and when it resets, without opening a terminal or a website.

02 The popover

One click. Every limit.

  1. 01

    Glance

    Each provider’s logo sits in the menu bar with its current session: the number that matters while you work.

  2. 02

    Open

    Click it for every enabled provider in one line. Expand one to see each limit with a bar and its reset time.

  3. 03

    Switch

    One provider opens at a time, so the popover stays small. Session, weekly, and model-specific limits when your plan has them.

  4. 04

    Refresh

    Every 5 minutes by default (2–15, your choice), after your computer wakes, and when you open the popover. If a refresh fails, the last values stay, marked as outdated.

Current session42%
Resets at 5:10 PM (in 2h 18m)
Weekly18%
Resets in 3d 4h (Sun, Oct 26 at 7:00 PM)
Current session12%
Resets at 6:45 PM (in 3h 53m)
Weekly27%
Resets in 5d 2h (Tue, Oct 28 at 4:52 PM)
Updated 4m agoSample

Interactive replica · sample data · click a provider

Three ways to sit in the menu bar.

42%42/1812%12/27
Providers
One number per provider. The default.
Minimal
Only the provider whose session is most used.
Detailed
Session and week together, like 42/18.

The menu bar stays quiet until a limit gets close: values turn orange from 70% and red from 90%. On the menu bar, which macOS tints for light and dark, close limits get heavier and critical ones a dot. Too little room? The label falls back to a more compact mode.

03 Providers

Claude. Codex. One place.

Currently supported

TokenBar is built around AI usage, not one vendor. Claude and Codex are the providers it supports today, side by side in one menu bar item and one popover.

  • Claude

    Pro · Max
    Shows
    Current session (5 h) and weekly limits, plus Opus and Sonnet weekly limits when your plan has them.
    Needs
    Claude Code signed in on the same computer.

  • Codex

    ChatGPT plans
    Shows
    Codex 5-hour and weekly limits, plus model-specific limits when your plan has them. These are Codex limits, not ChatGPT chat message limits.
    Needs
    Codex (CLI or app) signed in with ChatGPT on the same computer.

  • The next provider

    Every provider implements one protocol and returns the same kind of usage snapshot, so adding one never touches the menu bar, the popover, or the refresh logic. A new provider ships only once its data source is documented and reliable.

    How to add a providerRequest a provider

Both integrations are experimental. Neither Anthropic nor OpenAI publishes an API for plan limits, so TokenBar uses the same undocumented endpoints that Claude Code and Codex use to show your usage. They may change or stop working at any time. Every provider starts disabled, and TokenBar explains what it reads before you turn it on. Read the data sources

04 Resets

Not just how much. When.

A percentage alone doesn’t tell you whether to slow down. TokenBar shows when each limit resets: the clock time when it’s today, the day when it’s later. Countdowns are computed on your computer, in your time zone. Updating them never makes a network request.

Current session42%
Resets at 5:10 PM (in 2h 18m)
Weekly18%
Resets in 3d 4h (Sun, Oct 26 at 7:00 PM)

Illustration · sample data · Thu, Oct 23

05 Native

Built for the menu bar. Not squeezed into it.

Today on macOS: a native menu bar app built with the system’s own frameworks.

  1. SwiftSwift 6, strict concurrency
  2. SwiftUI + AppKitThe system’s own UI frameworks
  3. macOSA menu bar app, no Dock icon, no window
  4. 42%42/1812%12/27TokenBar

What’s not inside

  • Electron
  • Web views
  • A browser wrapper
  • Third-party code
Requires
macOS 14 Sonoma or later · Apple silicon or Intel
Dependencies
None. Foundation, SwiftUI, AppKit, Security, ServiceManagement, OSLog.
Refresh
Every 5 minutes by default (2–15), after wake, and when you open the popover. Never polls aggressively.
Menu bar
Rendered as a template image, so macOS tints it for light and dark menu bars.
Login
Opens at login if you want it to, through the system’s Login Items.
Languages
English and Portuguese (Brazil).
Source
All logic lives in one Swift package, split into core, providers and UI. Architecture

06 Privacy

Your usage stays yours.

TokenBar talks to the providers directly from your computer. There is no TokenBar backend in between, so there is nothing to collect your data.

Your computer connects directly to api.anthropic.com for Claude and to chatgpt.com for Codex. There is no TokenBar server in between. TokenBar serverdoes not existYour computerTokenBarReads sign-ins at refresh timeKeeps usage in memory onlyapi.anthropic.comClaudechatgpt.comCodex
  1. 01

    No TokenBar account

    There is nothing to sign up for and nothing to sign in to.

  2. 02

    No TokenBar server

    Requests go from your computer only to api.anthropic.com for Claude and chatgpt.com for Codex, and only for the providers you turned on.

  3. 03

    No analytics

    No telemetry, crash reporting, tracking, or update checks. No cloud sync.

  4. 04

    No history

    Usage is kept in memory and never written to disk. Responses are not cached and cookies are not stored.

  5. 05

    Sign-ins stay where they are

    TokenBar reads the sign-in Claude Code or Codex already keeps on your computer, at refresh time. It never stores, copies or renews it, and never logs tokens.

  6. 06

    Off until you say so

    Every provider starts disabled and shows exactly what it will read before you confirm.

What TokenBar promises, and how to report a problem privately, is in SECURITY.md. This website has no analytics and sets no cookies either.

07 Open source

Read it. Fork it. Make it better.

Every line of TokenBar is public under the MIT License, including how each provider integration works and why. It is free, and there is no subscription.

View source on GitHubContribute
git clone https://github.com/DerRafDev/tokenbar.git
cd tokenbar && open apps/macos/TokenBar.xcodeproj
tokenbar/
├── apps/
│   ├── macos/  the native macOS app
│   └── web/  this website
├── docs/  architecture, providers, roadmap
├── scripts/  test, lint, format, release
└── tools/  the README demo renderer
public protocol UsageProvider: Sendable {
    var descriptor: ProviderDescriptor { get }

    func fetchUsage() async throws -> UsageSnapshot
}
One protocol per provider · TokenBarCore/Provider/UsageProvider.swift

08 Roadmap

Where it’s going.

From the public roadmap. There are no dates: the order shows how settled each item is, not when it ships.

  1. Shippedv0.1.0macOS · Available now

    The beginning

    The first public release.

    • Native menu bar app for macOS
    • Claude and Codex, experimental
    • Session and weekly limits with reset countdowns
    • Three menu bar display modes
    • Automatic refresh and open at login
    • English and Portuguese (Brazil)

  2. Planned

    Windows

    A Windows version of TokenBar is being planned. There is no release date and no download yet.

  3. After 0.1.0

    Candidates, not commitments

    Each one needs evidence that it works reliably before it is built.

    • Developer ID signing and notarizationRemoves the first-launch Gatekeeper step and keeps Claude’s Keychain permission across updates. The release pipeline already supports it.
    • Codex Keychain sign-inFor Codex installations that keep their sign-in in the Keychain.
    • Clearer Codex errorsTelling an expired sign-in apart from a workspace without Codex.
    • Refresh when the network comes backToday data stays marked outdated until the next scheduled refresh.
    • Automatic updatesWould be the first request not made for a provider. Needs a privacy-preserving design.
    • More providersOnly with a reliable, documented-enough data source.
    • Menu bar customizationDriven by feedback from daily use.

The path continues. Suggest what’s next

09 Community

Built in public.

Contribute on GitHubSecurity issue? Report it privately.

TokenBar app icon

Keep your limits in sight.

Download TokenBar. Free and open source.

Download for macOS — FreeGitHub

macOS available nowWindows planned

macOS 14 Sonoma or later · Apple silicon or Intel

Opening it the first time

TokenBar is not signed and notarized by Apple yet, so macOS blocks the first launch. That is not a malware finding: the build simply hasn’t gone through Apple’s Developer ID process. Open it only if you downloaded it from the official releases. You approve TokenBar once; later launches open normally.

  1. 1

    Download the .dmg from the latest release, open it, and drag TokenBar to Applications.

  2. 2

    Open TokenBar. When macOS says it can’t verify the app, click Done.

  3. 3

    Go to System Settings › Privacy & Security, find the message about TokenBar, click Open Anyway, and confirm.

  4. 4

    Click TokenBar in the menu bar, choose Configure Providers…, and turn on the ones you use.

Don’t turn off Gatekeeper for your whole Mac; this approves TokenBar only. Each release lists SHA-256 checksums in SHA256SUMS.txt. Prefer to build it yourself? The README has the steps.