Metadata-Version: 2.5
Name: claudewatch-usage
Version: 0.1.0
Summary: Live Claude Code rate-limit view for the ClaudeWatch GNOME Shell extension
Project-URL: Homepage, https://github.com/yevhen-chernenko/claudewatch
Project-URL: Issues, https://github.com/yevhen-chernenko/claudewatch/issues
Author: Yevhen Chernenko
License-Expression: GPL-2.0-or-later
License-File: LICENSE
Classifier: Environment :: Console
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# claudewatch-usage

The terminal rate-limit view behind the **Show usage** menu item of the
[ClaudeWatch GNOME Shell extension](https://github.com/yevhen-chernenko/claudewatch):
a live, auto-refreshing display of your Claude 5-hour and 7-day usage windows.

## Install

```sh
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):

```sh
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.
