OSS-Singularity/cinnamon-claude-usage
OSS-Singularity/cinnamon-claude-usage
Watch
5
0
Fork
You've already forked cinnamon-claude-usage
 0
Code Issues Pull requests Releases 8 Packages Activity Actions
8 releases 8 tags
  • v0.1.0 4751a176b1

    v0.1.0 — Claude Usage Monitor
    All checks were successful
    Checks / Functional checks (push) Successful in 31s
    Details Explain this check
    Stable

    ClaudiuSchuster released this 2026-10-27 01:00:13 +00:00 | 19 commits to main since this release

    The third applet of the OSS Singularity usage family: your Claude plan usage, beautifully in view in the Cinnamon panel.

    Claude Usage Monitor

    Highlights

    • 5-hour session and all-models week as quota rings in the panel and popup, with live reset countdowns.
    • Model weeks such as Fable (and Sonnet, Opus or any model- or surface-scoped week Claude reports) with their own section and an always-open 24-hour graph; extra usage shows what is left of the monthly cap and the 24h/12h/4h/1h spend.
    • No setup: reads the Claude Code login (~/.claude/.credentials.json) and calls Claude's read-only usage endpoint — the same request the Claude apps send. Optional masked token setting, CLAUDE_CODE_OAUTH_TOKEN or ~/.config/cinnamon-claude-usage/oauth-token; a rejected token falls through to the next source.
    • Claude Desktop fallback: without a usable token the applet still shows the session and weekly percentages Claude Desktop records for itself.
    • Opt-in login renewal: Claude Code logins last 8 hours; the Renew the Claude Code login automatically switch lets Claude Code sign in again from the expired login's refresh token (a complete re-login, run detached with a lock and backoff).
    • Careful by design: the applet never refreshes, writes or logs tokens itself; the setting reaches the helper through its environment, redirects are refused and error text is redacted.
    • Launchers: Claude and Claude Code open Claude Desktop's deep links (or the web app / CLI), plus Refresh now and the Claude usage settings.

    Install

    Download install.zip, check it against SHA256SUMS (install.zip sha256 c9a4425d19caf5898ce7b01997e9fae75810eeee796817896afb9f8cf3abf235), unpack it into ~/.local/share/cinnamon/applets/ and enable Claude Usage Monitor in System Settings → Applets — or clone the repository and run ./install.sh. Requires Cinnamon 5.8+ and Python 3.10+.

    Validated with two independent review rounds, 70 Python tests, 13 CJS suites, isolated Xvfb captures and a live install on Cinnamon 6.6.9 (receipt).

    Forked from cinnamon-z-usage 1.0.10. Not affiliated with or endorsed by Anthropic. GPL-3.0-or-later.

    Downloads