cc-menubar

Pace your quota — proactive forecasting for Claude Code Max, not retroactive tracking.

30+ Claude Code usage tools exist. Almost all show what you already spent. cc-menubar inverts this: instead of "how much did I use?", it answers "how far will my quota take me?"

_{See runway, not spend. The 5-Hour row shows what's left and when it resets — every other Claude Code menu-bar tool shows what you already spent.}

Three Principles

Install

brew install calvindotsg/tap/cc-menubar
brew install --cask swiftbar
cc-menubar install
open -a SwiftBar

Or with uv:

uv tool install cc-menubar
cc-menubar install

Menu Bar Icon

A gauge icon showing remaining quota. The needle position reflects how much quota is left in the current window (default: 5-hour). The gauge glyph swaps between three SF Symbols variants (100percent / 50percent / 0percent) as your 5-hour quota crosses the 66% and 33% thresholds — a visible state change, not just a needle rotation. Configurable text, color thresholds, and metric cycling.

Dropdown Sections

Configuration

Config at ~/.config/cc-menubar/config.toml. Built-in defaults apply automatically.

cc-menubar init          # Generate commented config
cc-menubar config        # Show merged config
cc-menubar config --default  # Show all defaults

Title Options

[title]
text = "none"                       # "none" | "percent" | "label"
color = "monochrome"                # "monochrome" | "threshold" | "always"
metric = "5h"                       # "5h" | "7d"
cycle = []                          # ["5h", "7d", "opusplan", "context"]

Theme

[theme]
preset = "ayu"   # "ayu" (default) or "catppuccin"

# Override individual roles
[theme.light]
success = "#custom"

[theme.dark]
success = "#custom"

Sections

[quota]
enabled = true

[activity]
enabled = true
days = 7

[tools]
enabled = true
top_n = 10

[projects]
enabled = true
[projects.aliases]
# "-Users-me-myproject" = "My Project"

Quota setup

cc-menubar reads canonical-shape Claude Code statusline JSON from ~/Library/Caches/cc-menubar/statusline-input.json (override via [quota] cache_file). It ships no producer — you wire an existing statusline to write the cache file via POSIX tee. Pick the scenario that matches your setup and paste into ~/.claude/settings.json.

Scenario A — no existing statusline (fresh install)

{
  "statusLine": {
    "type": "command",
    "command": "tee ~/Library/Caches/cc-menubar/statusline-input.json | jq -r '\"[\\(.model.display_name)] \\(.context_window.used_percentage // 0)% context\"'"
  }
}

Writes the cache file and renders a minimal Claude Code footer.

Scenario B — existing custom script

{
  "statusLine": {
    "type": "command",
    "command": "tee ~/Library/Caches/cc-menubar/statusline-input.json | ~/.claude/statusline.sh"
  }
}

Your script reads stdin as before; tee writes the cache as a side effect.

Scenario C — existing published tool (ccstatusline, CCometixLine, ccusage statusline)

{
  "statusLine": {
    "type": "command",
    "command": "tee ~/Library/Caches/cc-menubar/statusline-input.json | ccusage statusline"
  }
}

Portability: tee is POSIX (present in every shell); jq is needed only for Scenario A; cc-menubar install creates the cache directory so tee never fails on a missing parent.

CLI Commands

Data Sources

• Quota: Reads canonical Claude Code statusline JSON cache (see Quota setup)
• Burn rate: ccusage blocks --json --active (optional, install via brew install ccusage)
• Activity, tools, models, context: JSONL files in ~/.claude/projects/

Requirements

• macOS 14.0+ (for SF Symbols 5 gauge family)
• Python 3.11+
• SwiftBar or xbar

License

MIT