Clawy

Clawy

Clawy is built as a cute pixel companion for Claude Code sessions, a little guy that fits in your pocket that tells you what's going on, lets you approve or deny without touching your keyboard, and turns your whole session into a cozy co-op game.
This started as a prototype I built for myself. It's rough around the edges but it works, and I'm actively improving it. Feedback welcome.

Features

◆ 8 animated states to see what Claude is doing at a glance

◆ Approve or deny straight from the device, no need to be at your computer

★ Powered by Claude Code hooks native integration

♥ Runs on an off-the-shelf M5StickC Plus 2

◆ Works from any project, Clawy follows your sessions

★ JRPG aesthetic portrait frames, dialog boxes, scrolling quest text, particle effects and boot sequence

♥ Zero config after WiFi setup, mDNS discovery, no IPs to manage

◆ Session stats — prompts, tool calls, errors, and average response time

★ Clawy curls up to sleep after 30 seconds of inactivity

♥ No cloud, no server, just plain TCP on your local network, nothing leaves your machine

What You Need

- M5StickC Plus 2 (~$20) — M5Stack store
- Claude Code installed and working
- USB cable (USB-C, data-capable)

Quick Start

Path A: Flash from Browser (Recommended)

1. Plug in the M5StickC Plus 2 via USB
2. Visit the web flasher in Chrome or Edge
3. Click Install Clawy and select the serial port
4. Enter your WiFi credentials on the flash page (sent directly to the device over USB, never leaves your computer)
5. Reboot the device after flashing (press and hold the power button, then turn it back on)
6. Install the hooks:

7. Start a session:

Path B: Build from Source

1. Clone the repo:

2. (Optional) Set compile-time WiFi credentials:

3. Compile and upload:

4. Install hooks:

5. Start…