lycfyi

Token Wallpaper — AI skill for Claude Code

AI community

Your AI coding token usage (Claude Code, Codex, OpenCode… via ccusage) as a macOS wallpaper that updates itself.

How to install Token Wallpaper

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

What Token Wallpaper does

Your AI coding token usage (Claude Code, Codex, OpenCode… via ccusage) as a macOS wallpaper that updates itself.

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

token-wallpaper

Your AI coding token usage, as a macOS wallpaper that updates itself.

![Dark theme](docs/dark.png)

It reads the same local logs as [ccusage](https://github.com/ryoppippi/ccusage) — Claude Code, Codex, OpenCode, Gemini CLI and the other agents ccusage knows — and draws a dashboard on your desktop every 30 minutes. Dark or light follows your macOS appearance.

![Light theme](docs/light.png)

*Screenshots use made-up data (`render --demo`).*

What it shows

Estimated cost; total, input, output and cache tokens
Active days, current and longest streak, today's cost and tokens, best day
Daily tokens for the last 30 days, split into output, input and cache
A 26-week activity heatmap
Token share by tool and by model

The small number on each card is the change of the last 30 days against the 30 days before. On the two "Today" cards it is today against the 30-day daily average.

Requirements

macOS (tested on macOS 26 with a Retina and a 5K display)
Python 3.9 or newer (the one that ships with the Xcode command line tools is fine); no packages
Node.js, so npx can run ccusage
Google Chrome, or another Chromium browser: Chromium, Microsoft Edge, Brave

Install

git clone https://github.com/lycfyi/token-wallpaper.git
cd token-wallpaper
python3 tokenwall.py install

`install` writes a LaunchAgent to `~/Library/LaunchAgents/`, runs an update right away, and then updates every 30 minutes (`--interval SECONDS` to change it).

Then open **System Settings → Wallpaper** and turn on **Show on all Spaces**. macOS only lets a program change the current Space of each display.

Commands

python3 tokenwall.py update                 # collect, render each screen, set the wallpaper
python3 tokenwall.py render --out x.png     # one image; --size 5120x2880 --scale 2 --dark --demo
python3 tokenwall.py import cc.json         # merge an older `ccusage daily --json` report
python3 tokenwall.py uninstall              # remove t