Claude Usage Widget

Claude Code Buddy

Adopt a terminal pet companion that lives alongside your Claude Code sessions. 18 species, 5 rarity tiers, and a 1% shiny chance.

 /\_/\
( o.o )
 > ^ <

Cat

 /\  /\
{  `  }
(  __  )
 `--'

Dragon

  __
<(o )___
 ( ._> /
  `---'

Duck

 .-.
(o o)
| O |
 \_/

Ghost

 ,___,
(o,o )
/)_  )
 " "

Owl

🎲 Species & Stats

18 unique species with 5 stats each (Energy, Mood, Intellect, Charm, Luck). Every buddy is different -- discover yours!

Common Uncommon Rare Epic Legendary

💻 Commands

/buddy Summon a new buddy

/buddy pet Pet your buddy

/buddy off Dismiss buddy

✨ Shiny Buddies

Every buddy has a 1% chance of being shiny -- a special variant with unique ASCII art and bonus stats. Can you find one?

Download

Choose your platform

macOS

Native Swift app · Universal · Notarized

macOS 13.0+ · Apple Silicon & Intel
Signed & notarized .dmg
In-app auto-update via Sparkle

Download for Mac (v1.4.1) or build from source: bash build.sh

Windows

Cross-platform web widget

Windows 10/11
Requires Node.js 18+
Runs in your default browser

Download for Windows or run directly: node src/server.js

Features

📋

Real-time Usage

Monitor your 5-hour session and 7-day weekly limits at a glance — with a spring-animated session ring.

⚡

Burn-rate ETA

Predicts when you'll hit the session limit at your current pace, so you can pause before running out.

📈

7-day Sparkline

A weekly trend strip on the Weekly Limits card. History is saved locally and exportable.

🔔

Custom Usage Alerts

Two sliders let you set the warning thresholds yourself. The menu-bar icon pulses when you cross the lower one.

🔎

Rich Menu Tooltip

Hover the menu-bar icon to see your %, ETA, weekly usage, and last sync — without opening the popover.

📥

CSV / JSON Export

Export your 7-day usage history (Settings → Data) for analysis in spreadsheets or notebooks.

👤

Multi-account

Point the widget at a non-default ~/.claude/.credentials.json to monitor a second account.

🔃

Auto-Update

Sparkle-powered, EdDSA-signed updates delivered straight inside the app.

💻

Universal Binary

Runs natively on both Apple Silicon and Intel Macs. macOS 13+.

🌙

Light & Dark

Solid off-white surface in light mode, dark surface in dark mode — both wrapped in 에이투지체 (A2Z) typography.

🔒

Zero Token Cost

Uses OAuth usage API only. No Claude messages sent, no tokens consumed.

🔄

Auto Sync

Configurable auto-refresh: 1m, 5m, 10m, 30m, 1h, or manual. Plus ±10% jitter + exponential backoff.

🌐

Cross Platform

Native Swift on macOS, Node.js web widget on Windows & Linux.

🌐

4 Languages

English · 한국어 · 日本語 · 中文 — switch instantly inside Settings.

⚇️

Accessibility

VoiceOver labels on every control, ⌘R / ⌘Q / ⌘, shortcuts, and full Reduce Motion support.

🐶

Claude Code Buddy

Adopt a terminal pet with ASCII art. 18 species, 5 rarity tiers, and a 1% shiny chance.