JeongJaeSoon

DeskPulse — AI skill for Claude Code

AI community

Desk-side AI usage monitor for Claude and Codex, forked from Clawdmeter.

How to install DeskPulse

This entry records only its repository, not the path inside it, so there is no exact command to give. Open JeongJaeSoon/DeskPulse and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What DeskPulse does

Desk-side AI usage monitor for Claude and Codex, forked from Clawdmeter.

Alternatives in AI

  • Codeburn — Free, local tool to track AI coding token usage and cost across 37 tools and agents (Claude Code, Cursor, Code 9.7k ★
  • Token Monitor — Local-first desktop widget for tracking token usage, costs, and limits across 32+ AI coding tools—including Cl 1.8k ★
  • TokenTracker — Local-first AI token usage & cost tracker for 31 coding tools incl 1.4k ★

README

DeskPulse

ESP32 desk-side usage monitor for Claude Code and Codex.

DeskPulse is maintained as a separate multi-provider fork of [HermannBjorgvin/Clawdmeter](https://github.com/HermannBjorgvin/Clawdmeter). The GitHub fork relationship is intentionally retained. See [UPSTREAM.md](UPSTREAM.md) for origin history and [NOTICE.md](NOTICE.md) for license and third-party asset notes.

Some runtime names still use the original `Claude Controller` and `claude-usage-daemon` identifiers for compatibility with existing BLE pairing and service setup.

Supported Hardware

Board env names:

  • waveshare_amoled_216
  • waveshare_amoled_18

Requirements

  • PlatformIO CLI
  • macOS: python3
  • Linux: curl, bluetoothctl, busctl
  • Claude Code login for Claude usage
  • Codex / ChatGPT login for Codex usage

If `pio` is not on your PATH, try `~/.platformio/penv/bin/pio`.

macOS Setup

1. Flash firmware

./flash-mac.sh waveshare_amoled_216
./flash-mac.sh waveshare_amoled_18 /dev/cu.usbmodem1101

The first command auto-detects `/dev/cu.usbmodem*`. Pass the serial port explicitly if more than one device is connected.

2. Pair Bluetooth

After flashing, open **System Settings -> Bluetooth** and connect to `Claude Controller`.

The daemon discovers the device by that BLE name.

3. Install daemon

./install-mac.sh

The installer:

  • creates daemon/.venv/
  • installs bleak and httpx
  • creates daemon/config.toml if missing
  • installs ~/Library/LaunchAgents/com.user.claude-usage-daemon.plist
  • starts the LaunchAgent

On first run, allow the macOS Bluetooth permission prompt.

4. Choose provider

`