macOS menu bar · Claude Code + Codex

Your AI coding tokens, hatched into Pokémon.

PokeTokenBar shows how many tokens you've burned today — right in your menu bar — and turns that usage into a growing Pokémon companion. Spend tokens, hatch an egg, evolve it, graduate it into your Pokédex, and start again.

Download from Releases
Latest release macOS 14+ Swift 6 MIT license
Menu bar showing an animated companion and today's total tokens
PokeTokenBar popover: Charmeleon companion with evolution progress, today's Claude Code + Codex tokens, and official 5h/weekly limit bars
Works with Claude Code Codex ccusage PokéAPI

Everything you need, in the menu bar

A glanceable usage tracker for AI coding — no dashboard, no browser tab — with a reason to actually open it.

📊

Live token usage

Today's Claude Code + Codex tokens (compact, e.g. 253.4M), with optional cost ($) and limit % right in the menu bar.

🛑

Official limits

Claude & Codex 5-hour / weekly utilization with live reset countdowns, color-coded as you approach the cap.

📈

Burn-rate forecast

Projects when your current 5-hour window will hit 100% at the current spend rate — so a wall never surprises you.

🥚

Growth companion + Pokédex

Your usage raises a Pokémon that hatches, evolves through its real line, graduates, and fills a Pokédex. The part you look forward to.

🌐

Localized

Full Korean / English / Japanese UI — and Pokémon names in your language, straight from PokéAPI.

🔔

Notifications

Alerts when a limit crosses your warning / critical thresholds — and when your companion hatches, evolves, or graduates.

The companion

Code more, raise a Pokémon

Tokens spent since install grow a Pokémon through its real evolution tree — fetched live from PokéAPI, animated with Gen-V sprites.

🥚

Hatch

Spend ~5M tokens and your egg hatches into a rarity-weighted Pokémon.

Evolve

Keep coding to evolve it through its 1 / 2 / 3-stage line, branches included.

🎓

Graduate

Reach the final form + threshold and it graduates — a fresh egg arrives.

📖

Collect

Graduates fill your Pokédex, sorted by rarity with full lines & capture dates.

Collection / Pokédex view: graduated Pokémon sorted by rarity with full evolution lines
Pokédex — graduated Pokémon, sorted by rarity, with full evolution lines.
Empty Pokédex with an animated mascot encouraging you to start
An animated mascot nudges you to hatch your first one.
Common · hatches often Uncommon Rare Legendary · rarely

Rarer Pokémon take more tokens to graduate — roughly 3 days (common) to 24 days (legendary) at heavy use.

Install in a minute

macOS 14+ (Apple Silicon or Intel). The Homebrew cask handles everything.

1. Install ccusage

Token accounting is powered by ccusage. Make sure it's on your PATH.

npm install -g ccusage

2. Install PokeTokenBar

One Homebrew command — ad-hoc/self-signed; the cask strips the quarantine attribute on install.

brew install --cask chattymin/tap/poke-token-bar

Prefer building yourself? swift build · swift test · ./scripts/build-app.sh/Applications. See the README.

Requirements

  • macOS14+ (Apple Silicon or Intel)
  • ccusageon your PATH (Homebrew / mise / nvm / asdf …)
  • Claude / Codexat least one, for usage to show
  • Keychainoptional — only for official limit %

On-device. The app only reads usage via ccusage — it never runs claude/codex model turns. Pokémon data & sprites are fetched at runtime from PokéAPI and cached locally; nothing copyrighted is bundled.