Skip to content

v0.2.0 — Context window widget

Choose a tag to compare

@Bread-bang Bread-bang released this 12 Jun 07:44
· 26 commits to main since this release

Added

  • Context‑window widget: a second menu bar item showing the live context occupancy of the Claude Code session you're currently typing in — a scroll glyph plus the occupied percentage, styled to match the usage widget.
  • Occupancy is read from the local transcript (~/.claude/projects/<cwd>/<uuid>.jsonl); no server API involved.
  • Automatic 200K vs 1M context‑window detection (recorded /context output, <budget:token_budget> tag, model facts, occupancy ratchet, [1m] keys).
  • Active‑session identification via a self‑installed Claude Code hook relay plus a tty‑atime bridge — the widget follows whichever terminal pane you last typed in, with no Accessibility permissions and terminal‑agnostic.
  • The hook is installed idempotently into ~/.claude/settings.json on first launch, preserving existing hooks.

Install: brew install bread-bang/tap/claude-usage

Notarized build; opens with no Gatekeeper warnings. Requires macOS 13+.