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
- Claude Private — Claude Code without any telemetry - the perfect cli to combo with CCR 350 ★
- Codex OpenAI Proxy — Proxy server to use ChatGPT Plus tokens with CLINE/Claude Code extensions via OpenAI API compatibility 124 ★
- Cc Bar — Native macOS menu bar app: track quota, usage and cost for Codex (multi-account) and Claude Code, from your me 119 ★
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
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.
Vibebar
VibeBar is a lightweight macOS menu bar app that monitors live TUI session activity for Claude Code, Codex, an
Modeldeck
macOS menu bar app that tracks usage limits across all your Claude Code and Codex CLI accounts — live "% left"
Related Agents
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
Cursor Research Agent
Senior Cursor/Anysphere researcher specializing in Cursor IDE - researches latest context window and model ava