Ullage — Development skill for Claude Code
Context-window telemetry for Claude Code and OpenAI Codex, plus Cursor agent activity: a macOS menu bar item showing how full your live session's context is, backed by a local SQLite history of every.
How to install Ullage
This entry records only its repository, not the path inside it, so there is no
exact command to give. Open sturdynut/Ullage and copy the folder into
~/.claude/skills/, or the file into ~/.claude/agents/.
What Ullage does
Context-window telemetry for Claude Code and OpenAI Codex, plus Cursor agent activity: a macOS menu bar item showing how full your live session's context is, backed by a local SQLite history of every API call.
Alternatives in Development
- Scope Recall Hermes — Local long-term memory for Hermes, Codex, Claude Code, WorkBuddy and dsh agents: one SQLite store, source-back 438 ★
- Tmux Claude Hatch — tmux plugin that runs Claude Code sessions in popups per project directory, with an fzf picker showing each se 381 ★
- Quosparr — 🐦 Native menu bar & tray app for macOS, Windows and Linux: track Codex, Claude Code and Grok quotas, resets 288 ★
README
Ullage
**See how full your Claude Code context window is, live, from the menu bar.**
Ullage watches your Claude Code and OpenAI Codex CLI session transcripts, keeps every API call in a local SQLite database, and shows the context window's fill level as a percentage in the macOS menu bar. It also lists Cursor agent activity, though Cursor records no token counts locally so it has no fill percentage. Click it to break the current session down turn by turn and see what is actually taking up the window. A separate history window charts your activity across days and projects.
Everything stays on your machine. Nothing is uploaded.
**Ullage** — the empty space left at the top of a barrel or tank. Here, the room still left in the context window.
What it looks like
- Menu bar: a gauge icon whose needle rises with occupancy, followed by the
percentage
. It
turns amber past 85%, and drops to a plain gauge with no number once a session
has been idle for 30 minutes, so a stale figure is never mistaken for a live
one. - Popover — click the menu bar item for:
- the active project, model, and headline percentage;
- a session picker that follows the most recently active session, or pins one so it holds still while others are talking;
- a chart of context tokens per turn, with the window as the ceiling, the 85% line, and a marker wherever a compaction dropped the window (hover for the exact turn, tokens, and chan
Related Skills
Agent Usage Bar
macOS menu bar app showing how much Codex and Claude quota is left, what you spent locally, and when the windo
Quota Bar
macOS menu bar app showing how much Codex and Claude quota is left, what you spent locally, and when the windo
Crowsnest
See which Claude Code session is waiting on you — a macOS menu bar app showing your Claude Code sessions (loca
Tokenmax
macOS menu bar app showing remaining Claude Code and Codex quota, with reset countdowns, burn-rate projection,
Tokease
macOS menu bar app showing your remaining Claude 5-hour and weekly usage limits. No token read, 100% local.
Claude Codex Limits
macOS menu-bar app showing remaining Claude Code & Codex usage limits (session 5h / weekly 7d).
Related Agents
Apple UI Designer
Visual and theme redesigns in current Apple design language (macOS 27 / iOS 26+ Liquid Glass, vibrancy, system
macOS UI Designer
Use this agent when you need to plan, design, or evaluate macOS application user interfaces from a UI/UX persp
Community Dashboard Curator
Community telemetry and dashboard aggregator. Scans and compiles metrics across Skool cohorts, Discord activit