explaingit

otoha1119/token-checker

Analysis updated 2026-05-18

41SwiftAudience · developerComplexity · 2/5Setup · moderate

TLDR

A macOS menu bar app that shows your Claude Code and Codex usage limits in real time, so you know how much you have left before hitting a rate limit.

Mindmap

mindmap
  root((Token Checker))
    What it does
      Shows usage in menu bar
      Two donut charts
      Popover with details
    Tech stack
      Swift
      macOS Keychain
      JSON-RPC
    Use cases
      Watch rate limits
      Avoid surprises
      Track reset times
    Audience
      Claude Code users
      Codex users
      Mac developers

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

Keep an eye on Claude Code and Codex usage without switching to the terminal.

USE CASE 2

Get an early warning before hitting the 5 hour or weekly rate limit.

USE CASE 3

See exactly how much time is left before your usage resets.

USE CASE 4

Set the auto refresh interval to match how often you want updates.

What is it built with?

SwiftmacOSKeychainJSON-RPC

How does it compare?

otoha1119/token-checkerpixdeo/editxrverback2308/ytlite
Stars414136
LanguageSwiftSwiftSwift
Setup difficultymoderateeasymoderate
Complexity2/52/52/5
Audiencedeveloperdevelopergeneral

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires building from source with Xcode command line tools and already being logged into Claude Code and Codex CLIs.

No formal open source license, personal use and modification is allowed but redistribution or public forks require contacting the author first.

In plain English

Token Checker is a macOS app that lives in your menu bar and shows how much of your Claude Code and Codex usage limits you have left, updated automatically so you do not have to check manually. Once you have logged into both Claude and Codex through their command line tools, the app reads the saved login tokens from your Mac's Keychain for Claude, and talks directly to the Codex command line tool for Codex. It then shows two small donut charts in the menu bar, one for each service, along with the percentage used. Clicking the menu bar icon opens a popover with more detail: separate numbers for the 5 hour usage window and the weekly usage window, how much time is left before each resets, and how often the app refreshes this data, which you can set anywhere from 30 seconds to 10 minutes, with 5 minutes as the default. There is also a toggle to have the app launch automatically when you log into your Mac. To use it, you need a Mac running macOS 14 Sonoma or newer, and Swift 5.9 or newer if you plan to build it yourself, which you can get through Xcode's command line tools. You need to already be logged into Claude Code and Codex through their own login commands before the app can show anything. If only one of the two is logged in, the app still works and just shows information for the one you have set up. There is no packaged download. You build the app yourself by cloning the repository and running a build script included in the project, which produces an installable app. If your Mac cannot find a proper Apple developer signing identity, the build falls back to a temporary local signature so the app can still run. The project does not use a standard open source license. The author allows personal use and modification, but asks that you contact them first before redistributing the app or publishing your own fork of it publicly.

Copy-paste prompts

Prompt 1
Help me build this Swift app from source on my Mac and get it into /Applications.
Prompt 2
Walk me through logging into Claude Code and Codex so this menu bar app can read my usage.
Prompt 3
Explain how this app reads my Claude OAuth token from the macOS Keychain.
Prompt 4
Help me troubleshoot why the app isn't showing usage data for Codex.
Prompt 5
Show me how to change the refresh interval and enable launch at login.

Frequently asked questions

What is token-checker?

A macOS menu bar app that shows your Claude Code and Codex usage limits in real time, so you know how much you have left before hitting a rate limit.

What language is token-checker written in?

Mainly Swift. The stack also includes Swift, macOS, Keychain.

What license does token-checker use?

No formal open source license, personal use and modification is allowed but redistribution or public forks require contacting the author first.

How hard is token-checker to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is token-checker for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.