sturdynut

Ullage — Development skill for Claude Code

Development community

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 logo: a brass U-shaped capacity gauge on charcoal

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

Ullage popover: 30% headline, a context-per-turn chart, and a bar breaking the window into baseline, tool results, assistant output, and other
  • Menu bar: a gauge icon whose needle rises with occupancy, followed by the percentage  Ullage menu bar item showing a gauge icon and 30% . 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