hugosantanna

Clu Widget — Development skill for Claude Code

Development community

A tiny terminal widget showing live Claude Code usage stats with an animated creature.

How to install Clu Widget

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

What Clu Widget does

A tiny terminal widget showing live Claude Code usage stats with an animated creature.

Alternatives in Development

Codexbar — Show usage stats for OpenAI Codex and Claude Code, without having to login 8.8k ★
Sniffly — Claude Code dashboard with usage stats, error analysis, and sharable feature 1.2k ★
Zoetrope — Watch a Claude Code session as a live flow graph, in your terminal or your browser 584 ★

README

clu - Claude Usage Monitor

A terminal tool that monitors your Claude Code usage — from a cute animated widget to a full per-project dashboard.

[![PyPI version](https://img.shields.io/pypi/v/clu-widget?color=orange)](https://pypi.org/project/clu-widget/) ![Python 3.9+](https://img.shields.io/badge/python-3.9+-8b5cf6) [![VS Code Marketplace](https://img.shields.io/visual-studio-marketplace/v/hsantanna.clu?color=007acc&label=vscode&cacheSeconds=3600)](https://marketplace.visualstudio.com/items?itemName=hsantanna.clu)

![clu dashboard](screenshot.png)

VS Code Extension

Install from the [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=hsantanna.clu) — usage in your status bar, click for the full dashboard.

![clu VS Code dashboard](screenshot-vscode.png)

![clu status bar](screenshot-statusbar.png)

What it does

**Widget mode** (default) — the original cute clu:

5-hour and 7-day sliding window usage with progress bars
Reset countdowns for each window
Token counts for the current period
A little animated creature to keep you company

**Dashboard mode** (`--dash`) — full terminal dashboard:

Everything from widget mode, plus:
Per-project token breakdown with smart project names (parsed from local Claude Code data)
Real-time utilization chart (live 5h usage over time)
Session history with duration, message count, and model used
Cache hit rate and efficiency metrics
Daily token sparkline (14-day trend)
Model usage breakdown
External/untracked usage estimation (percentage of rate limit)
Multi-source support (local + HPC + any synced .claude directory)

Installation

# Install from PyPI
pip install clu-widget

# Or install from source
git clone https://github.com/hugosantanna/clu-widget.git
cd clu-widget
pip install .

Usage

# Widget mode — cute animated companion
clu

# Dashboard mode — full terminal dashboard
clu --dash

# Include data from a remote machine (e.g. HPC)
clu --dash --dat