claude usage bot.

A DESKTOP COMPANION FOR CLAUDE CODE

Big coding days.
Little desktop friend.

A tiny pixel pet that keeps your usage in view.
It wanders. It naps. It opens your dashboard with a click.

Download for Windows Using WSL?

Free & open source. No separate account.
Native Windows app · WSL collector supported

your little corner of the desktop
psst. click me.
less checking. more making.

Interactive preview · example data, no account connection

01 A little personality02 Your usage at a glance03 An open-source companion

SMALL BOT. USEFUL COMPANY.

It fits right into
your flow.

01 /

A dashboard, one click away.

Check your session and weekly usage, reset times, and local activity. Then fold it away and get back to your next good idea.

02 /

A mood for every coding day.

Warm orange when there’s room to work. Red as usage climbs. Sleepy after a quiet spell. Hover for a hop, or let it wander.

03 /

Clear about where numbers come from.

Live sync reads your account usage. Saved readings get an asterisk; local estimates get a tilde. The source code is yours to inspect.

MAKE A LITTLE ROOM ON YOUR DESKTOP

Bring your bot home.

Choose where you run Claude Code.

SIMPLEST SETUP

Claude Code on Windows

Download the standalone app and open it. Python and WSL aren’t required. Claude Code should already be signed in on Windows.

Download the app Windows 10 / 11. The app is unsigned, so Windows may show a SmartScreen warning.
WSL SETUP

Claude Code inside WSL

Run the collector where your Claude data lives. The bot stays on your Windows desktop. 

git clone https://github.com/Tuvshuku/claude-usage-bot.git
cd claude-usage-bot
./install.sh --service --autostart
Full setup instructions

Use the setup that matches your Claude data. Run one collector at a time.
On macOS or Linux? The headless collector works there too; the desktop pet is Windows-only.

A FEW THINGS TO KNOW

Small print.
Plain answers.

Does it need access to my account?

Optional live sync reads the OAuth credential that Claude Code already stores and sends it directly to Anthropic’s usage endpoint. It reads usage metadata; it does not make model requests. Set "live_sync": false to use local estimates only.

Does it show my actual bill?

The dollar figure is an API-equivalent estimate based on local tokens, not your subscription bill. Live percentages include account activity; local activity and cost statistics cover this machine.

Can I make the bot stay still?

Yes. Right-click and turn off “Let it wander.” You can also drag it to a favourite spot. Its position and movement preference are remembered.

Is this an official Anthropic app?

No. This is an independent, MIT-licensed open-source project. Claude and Claude Code are names used to describe the service it works with.

Good company.
For your next good idea.

Meet the project on GitHub