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

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

Common Uncommon Rare Epic Legendary

/buddy Summon a new buddy

/buddy pet Pet your buddy

/buddy off Dismiss buddy

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

Choose your platform

Native Swift app + Web widget

macOS 13.0+
Native .app bundle (menu bar)
+ Standalone .app (desktop widget)

Download for Mac or build from source: bash build.sh

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

📋

Monitor your 5-hour session and 7-day weekly limits at a glance.

🎨

Beautiful frosted glass design with smooth animations and hover effects.

🔒

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

🔄

Configurable auto-refresh: 5m, 10m, 30m, 1h, or manual.

🌐

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

🇬🇧

English and Korean language support built-in.

🐶

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