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
  • v1.0.1 14e58b184d

    v1.0.1 — Claude Usage Monitor
    All checks were successful
    Checks / Functional checks (push) Successful in 36s
    Details Explain this check
    Stable

    ClaudiuSchuster released this 2026-10-27 11:24:17 +00:00 | 13 commits to main since this release

    The applet stays under the usage endpoint's rate limit.

    • 2-minute minimum: the refresh interval starts at 2 minutes. At a one-minute pace the usage endpoint rejected about every second request (HTTP 429). A stored shorter value now refreshes every 2 minutes.
    • No harm from refresh spam: the helper asks the endpoint at most once every 110 seconds per access token, counted between send times, so the regular refreshes always get through. Refresh now, a reload or a setting change in between gets the endpoint's last answer again:
      • after a success, the same snapshot, with no new history sample;
      • after a failure (HTTP 429, 5xx, an unreadable or empty answer), the same error, shown with the last good state;
      • after a rejected token, the next sign-in source, without sending the rejected token again.
    • Private state: the answers live in recent-answers.json (mode 0600, truncated token fingerprints, at most 110 seconds old). last-snapshot.json keeps its 1.0.0 format.

    Validation (receipt):

    • three independent review rounds, with all findings fixed;
    • a mutation check that caught 18 of 18 mutants;
    • the full suite run with the clock shifted up to one year ahead;
    • 96 Python tests and 14 CJS suites;
    • a live install on Cinnamon 6.6.9.

    install.zip sha256 bd5c15143e441ee770871600f1322e884a6b65b05d39aff6c15680b0312aa223. Check it against SHA256SUMS, then unpack it into ~/.local/share/cinnamon/applets/ or run ./install.sh from a clone.

    Not affiliated with or endorsed by Anthropic. GPL-3.0-or-later.

    Downloads