Tamaclaude

TamaClaude

  Tamagotchi + Claude — a virtual pet whose moods are your coding sessions.

  🌐 English · ไทย

  What the screen says ·
  What you need ·
  Getting started ·
  Troubleshooting
Before you start
- macOS only. The app that talks to Claude Code is a Swift menu bar app for macOS 14
  or newer. There is no Linux or Windows build, and the firmware alone does nothing
  without it.
- Unofficial. A personal hobby project, not affiliated with or endorsed by Anthropic.
  "Claude" and "Claude Code" belong to them.
- As-is. Flashing firmware overwrites whatever is on the board, and you do it at your
  own risk. No warranty — see LICENSE.
- Reading your quota from claude.ai is optional and needs an account credential. Read
  step 5 before you turn it on.

A desk device that shows what Claude Code is doing right now. A blocky orange mascot
lives on a small screen next to your keyboard: it types when Claude types, waves when a
session needs your answer, and celebrates when a build finishes. The bars at the bottom
are your Claude usage quota.

*The board, and the menu bar app that feeds it.*

Nothing leaves your network. A menu bar app on your Mac reads Claude Code's hooks and
pushes a small snapshot to the board over Bluetooth LE — and, if you set up Wi-Fi, over
your own LAN as a sealed fallback when Bluetooth goes quiet. The board never talks to
claude.ai.

What the screen says

While a session runs

When nothing is happening

Quota

The same bar, top and bottom

Every page wears the same top bar — the page you are on, the current quota, the clock, and
whether the snapshot is arriving over Bluetooth or Wi-Fi — and never repeats what the page
below it already shows bigger. The foot carries the page pips: they say which page you are
on, and the lit one drains as the…