It actually lives on your screen
It wanders screen edges and your taskbar, chases food, idles, and sleeps when you do.
Tokengochi is a desktop pet that lives on your screen and stays happy on the tokens you burn in Claude Code. Every 20,000 tokens = 1 snack. No accounts, no server. Just a hungry pixel buddy.
Free & open source · MIT · macOS / Windows / Linux
Tokengochi turns normal coding activity into a gentle desktop-pet routine: code, earn snacks, keep the little buddy growing.
Use Claude Code like you already do. Tokengochi tails your local session logs. Nothing leaves your machine.
Every 20,000 weighted tokens fills the food meter and drops a snack on your screen.
It runs over, eats, gains XP, and evolves over days and weeks. Miss a day? It gets hungry, not dead.
Tokengochi is a tiny pet with serious boundaries: local by default, earned progression, and a core loop that stays out of your way.
It wanders screen edges and your taskbar, chases food, idles, and sleeps when you do.
Streaks, evolution stages, cosmetics, and collection albums are earned in-app. No real-money purchases.
The core loop tails local Claude Code logs and keeps state on your machine.
Built for macOS, Windows, and Ubuntu, with X11 first and Wayland best-effort.
Designed for negligible idle CPU, so the pet can stay ambient all day.
Claude Code is first, with provider plugins planned for other LLM CLIs and tools.
Run a tiny agent session, watch tokens climb, and see one snack drop at the 20,000-token mark.
Agent is idle. Start a prompt to feed the token meter.
This is the actual pet. In the real app, local Claude Code usage fills the meter instead of this simulation.
20,000 weighted tokens became one snack. Daily caps keep progress healthy.
Latest release
Download Tokengochi from GitHub Releases. The installer link works without JavaScript; your browser can make it OS-specific when it can identify your platform.
Choose the DMG that matches your Mac chip.
Use the x64 setup file from the latest release.
Ubuntu and Debian users want the .deb; other distros can use AppImage.
MVP builds are unsigned, so first launch has one extra trust step. After that, Tokengochi opens normally.
Gatekeeper blocks the app: "cannot be opened because the developer cannot be verified". Right-click the app, choose Open, then choose Open again in the dialog. If that does not work, run the command below in Terminal.
xattr -dr com.apple.quarantine /Applications/Tokengochi.appSmartScreen shows "Windows protected your PC". Click More info, then Run anyway.
There is no OS-level warning. Mark the AppImage executable before running it.
chmod +x Tokengochi_x.y.z_amd64.AppImageFree & open source. If it made your terminal less lonelysupport Tokengochi on Ko-fi.