Skip to main content

claudewatch-usage

The terminal rate-limit view behind the Show usage menu item of the ClaudeWatch GNOME Shell extension: a live, auto-refreshing display of your Claude 5-hour and 7-day usage windows.

Install

pipx install claudewatch-usage
# or: pip install --user claudewatch-usage

Both put a claudewatch-usage command in ~/.local/bin. The extension looks there as well as on PATH.

Use

Create the opt-in token file, then run the command (or click Show usage in the extension's menu):

mkdir -p ~/.config/claudewatch
ln -s ~/.claude/.credentials.json ~/.config/claudewatch/token
claudewatch-usage

Stdlib only, no third-party dependencies. The only network request is to https://api.anthropic.com/api/oauth/usage, made with the token above.

Release files for claudewatch-usage 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for claudewatch-usage 0.1.0
File Size Uploaded
claudewatch_usage-0.1.0.tar.gz 89.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for claudewatch-usage 0.1.0
File Interpreter ABI Platform
claudewatch_usage-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 103.5 kB

Release files / claudewatch_usage-0.1.0.tar.gz

Download URL claudewatch_usage-0.1.0.tar.gz
Size 89.6 kB
Tags Source
SHA-256 checksum
How to use checksums
c255af5cd1eea8abd397acf0764971dc84d5374efa5c6d5b5a48abf141716301
BLAKE2b-256 checksum
How to use checksums
23c66cea1404b5f06c5a1b6c7e1483a2ffd8ea6fb75cb8222fe3ae78e444c018
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.4

Release files / claudewatch_usage-0.1.0-py3-none-any.whl

Download URL claudewatch_usage-0.1.0-py3-none-any.whl
Size 13.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
ef269ed4de514b1592c4e706f868e5196a2459d93d2bd3e01ef6ed40594546ec
BLAKE2b-256 checksum
How to use checksums
50052831972061fb1b5fdf5c9835805686750bdc793e369b85985604d919a4eb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.4

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page