https://github.com/wassimk/claudegotchi
Claude tamagotchi-style bot running on a M5Stack Core2 IoT device
https://github.com/wassimk/claudegotchi
claude claude-code notifier tamagotchi
Last synced: 3 months ago
JSON representation
Claude tamagotchi-style bot running on a M5Stack Core2 IoT device
- Host: GitHub
- URL: https://github.com/wassimk/claudegotchi
- Owner: wassimk
- License: mit
- Created: 2026-01-31T02:18:18.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2026-02-14T16:11:40.000Z (4 months ago)
- Last Synced: 2026-02-15T00:44:26.546Z (4 months ago)
- Topics: claude, claude-code, notifier, tamagotchi
- Language: C++
- Homepage:
- Size: 32.2 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Claudegotchi
> [!NOTE]
> **Work in progress** — This is a fun side project under active development. Claude currently looks like a blocky coral rectangle with stick arms, and that's part of the charm. Expect rough edges.
A cute Claude mascot that lives on your desk and notifies you when [Claude Code](https://docs.anthropic.com/en/docs/claude-code) needs attention.
Built for and tested on **M5Stack Core2** only.
## Features
- **Idle Mode**: Claude slowly wanders around with gentle breathing animation and occasional blinking
- **Attention Mode**: Bounces excitedly with wiggling arms and > < eyes
- **Matrix Rain**: Animated code rain background
- **Sound Effects**: Cute chirp sounds (toggleable via bottom-left touch area)
- **Clean UI**: Minimal interface with just a small sound indicator dot
## Hardware
- [M5Stack Core2](https://shop.m5stack.com/products/m5stack-core2-esp32-iot-development-kit)
## Setup
Follow the M5Stack Arduino setup guide: https://docs.m5stack.com/en/arduino/m5core2/program
Install **M5Unified** library (includes M5GFX dependency) via Arduino Library Manager.
Then open `claudegotchi/claudegotchi.ino` and upload.
## Usage
| Touch Area | Action |
|------------|--------|
| Bottom Left | Toggle sound on/off |
| Bottom Center | Trigger attention mode (test) |
| Bottom Right | Dismiss / return to idle |
### Serial Commands
Connect via Serial Monitor at 115200 baud:
- `ATTENTION` - Trigger attention mode
- `IDLE` - Return to idle mode
## Roadmap
- **Make Claude look cuter** — the current character is... charmingly primitive
- **Claude Code hooks integration** — hook into [Claude Code notifications](https://docs.anthropic.com/en/docs/claude-code/hooks) so the device chirps and lights up whenever Claude needs your input, no serial monitor required
- **Better sound design** — more expressive chirps and alerts
## Inspiration
Inspired by [@taku_sid's Stack-chan demo](https://x.com/taku_sid/status/2014540202803658973) — a much cuter version of this idea using a [Stack-chan](https://github.com/stack-chan/stack-chan) robot. That project isn't public yet, so this is my scrappy take on it in the meantime.