Claude Usage Tracker for Linux

Linux product adaptation / 2026-present

An unofficial Linux port that joins a GNOME usage monitor, native preferences, notifications, history, and a configurable Claude Code statusline.

Role: Linux adaptation author and maintainer
Contribution: Ported the tracker to Linux with a GNOME panel and terminal statusline.
Evidence type: Linked public source

24hLocal usage chartBacked by seven days of percentage samples

3Focused test suitesUsage, statusline, and settings projection

0600Local file modeHistory, cache, configuration, and backups

The problem

The macOS tracker experience did not exist as one coherent Linux product. A port also had to reuse Claude Code login safely instead of introducing another credential store or embedding a session key in a script.

Two sources, two Linux surfaces

The statusline receives limits from Claude Code. Only the panel reads the OAuth token, in memory, to query the usage API.

Claude Codesession JSON

Statuslinepace and reset

Linux trackernormalization and settings

Usage APIactive limits

GNOME panelchart and alerts

Decisions

Combine the macOS tracker visual and statusline direction with an existing GNOME Shell extension foundation, preserving explicit upstream credit.
CostThe port inherits two upstream projects, and neither of them owes it compatibility.
Let the statusline consume Claude Code session JSON from standard input while the panel keeps the OAuth token in memory for its usage request.
CostThe token is gone after a restart, so the panel has to treat being unauthenticated as a normal state.
Normalize legacy and dynamic model limits, retain bounded percentage-only history, and keep cached values visible during service failures.
CostHistory can answer questions about pace but none about absolute usage.
Install the statusline by preserving unrelated Claude settings, creating a timestamped backup, and testing hostile terminal input and configuration projection.
CostInstallation is slower and harder to follow than overwriting the settings file would be.

Outcome

Linux users get one native panel and terminal view of session pace, model limits, reset times, notifications, and recent usage without duplicating their Claude login.

Evidence and scope

Claude Usage Tracker for Linux repository Upstream attribution Test workflow

Looking for a collaborator?

Share the work and its constraints. I reply by email.

Send a message