Clawdmeter

Clawdmeter

Clawdmeter shows your Claude Code usage limits on an ESP32 development board on your desk. Clawd lives on the device. He reacts to prompts, cheers you on, and alerts you when a session needs your attention.

Supported boards

Flagship

The reference board: everything is developed and tested on it first.

Stable

Supported on every release.

Experimental

Ports contributed by the community. Expect rough edges: bugs, or a layout
that isn't optimal for the panel. If something is off, fix it and open a PR.
If everything works, tell us in the
Board support reports
discussion (env name, firmware version, a photo) and we'll move the board to
Stable.

Install

Download the app from the latest release.

The macOS and Windows packages aren't signed with a publisher certificate.
See the user guide for Linux requirements,
portable archives, and Nix setup.

Quick start

1. Launch Clawdmeter and follow setup. Connect the board with a USB data
   cable, check the selected board, and install firmware.
2. Pair Clawdmeter in your computer's Bluetooth settings. It appears as
   a keyboard because its buttons send key presses.
3. Open Hooks to let Clawd react to Claude Code activity and alert when
   a session needs an answer. Review the changes before saving.
   Usage meters work without hooks.
4. Enable Settings → Start at login if you want the app to launch when
   you sign in.

Docs

- User guide: setup, device controls, settings, and connection help.
- Development: builds, simulator, and releases.
- Add a board: hardware ports and app integration.
- BLE protocol: payload fields and notifications.
- Clawd's director: behavior and character rules.
- Legacy daemon parity: upgrade steps and implementation differences.

Licensing gray area warning

The software in this…