Installation

Installation

GNOME (Linux)

Requirements: GNOME Shell 45–50, an active Claude Code login.

git clone https://github.com/fschmutz/claude-usage-panel.git
cd claude-usage-panel
./install.sh

install.sh copies the extension, compiles its GSettings schema, clears the global disable-user-extensions switch if set, and enables the extension for every login. Then log out and back in — Wayland only loads new extensions at login.

gnome-extensions info claude-usage-panel@fschmutz.github.io   # State: ACTIVE

From a packaged release

Download the …shell-extension.zip asset (not "Source code") from the latest release:

gnome-extensions install --force claude-usage-panel@fschmutz.github.io.shell-extension.zip

macOS

Requirements: macOS 13+, Xcode 15+ or the Swift toolchain.

cd macos
swift run          # icon appears in the menu bar
# or ./build-app.sh   # builds ClaudeUsagePanel.app

See macOS for the login-item and Keychain details.