Claude Usage Menu Bar

A macOS menu bar plugin (for SwiftBar) that tracks your Claude Code usage against the 5-hour rolling block and weekly limits, with a pace indicator showing whether you're ahead of or behind a linear weekly burn. It also shows live Mac network download and upload speed in the menu bar.

Features

• Live download/upload speed with 3s, 5s, or 10s smoothing.
• Peak network speed and short text sparklines in the dropdown.
• Network health, active interface, daily/since-boot traffic totals, system pressure, and top network-using processes in the dropdown.
• Configurable top bar: weekly + network, network only, weekly only, compact, or stacked compact (experimental image mode).
• Bytes/sec and bits/sec display modes.
• Weekly burn-rate projection from the local sample log.
• Built-in settings rows and a doctor/debug report action.
• Optional standalone network-speed.1s.py SwiftBar plugin.

Requirements

• macOS 12+
• Python 3.9+ (the system /usr/bin/python3 is fine)
• SwiftBar installed (brew install --cask swiftbar)
• Claude Code installed and logged in (claude once)

Install

make install

This symlinks bin/claude-usage.1s.py into your SwiftBar plugins folder. Refresh SwiftBar (right-click any plugin → Refresh All) and it should appear within a few seconds.

The first poll will pop a macOS Keychain prompt asking for permission to read Claude Code-credentials. Click Always Allow for silent operation.

Uninstall

make uninstall

Optional network-only plugin

make install-network

This adds bin/network-speed.1s.py as a separate SwiftBar item. Use it if you want Claude usage and network speed split into separate menu-bar entries.

Development

make venv     # creates .venv with pytest
make test     # runs the test suite
make run      # runs the plugin once and prints SwiftBar output to stdout

See docs/superpowers/specs/2026-04-28-claude-usage-menu-bar-design.md for the full design.