AI Monitor Widget — AI skill for Claude Code

ai-monitor-widget

A tiny [Übersicht](https://tracesof.net/uebersicht/) desktop widget for macOS that shows your Claude / Codex plan usage at a glance — one row per account, with session (5h) and weekly (7d) utilization meters.

It is a pure display layer. All data comes from [claude-monitor](https://github.com/rjwalters/claude-monitor), which must already be installed and running — this widget only reads the non-secret `~/.claude-monitor/ranking.json` file that claude-monitor maintains.

**Prerequisites:** [claude-monitor](https://github.com/rjwalters/claude-monitor) installed, signed in, and running (it writes the `~/.claude-monitor/ranking.json` file this widget reads), plus [Übersicht](https://tracesof.net/uebersicht/), the free desktop-widget host that runs it. The walkthrough below covers installing both from scratch.

Full setup, start to finish

Everything below, in order, gets you from a bare Mac to the widget live on your desktop. If you already have claude-monitor installed and signed in, skip to [Part 2](#part-2--install-this-widget).

Part 1 — Install claude-monitor

This part is [claude-monitor](https://github.com/rjwalters/claude-monitor)'s own install flow, summarized here so you don't have to leave this page; see its [README](https://github.com/rjwalters/claude-monitor#quick-install) for anything not covered below (multiple accounts, adding a Codex/OpenAI account, rolling a leaked token, etc.).

1. **Prerequisites for claude-monitor itself:**

   • macOS 13 (Ventura) or later.
   • Claude Code installed — you use its CLI to mint the token claude-monitor polls with.

2. **Download and install the app.** Grab `ClaudeMonitor.zip` from claude-monitor's [Releases page](https://github.com/rjwalters/claude-monitor/releases), unzip it, and drag `ClaudeMonitor.app` into `/Applications`.

3. **First launch.** The app isn't notarized, so a plain double-click gets blocked by Gatekeeper