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

  • 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 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