Skip to content

Commit 55d3fa6

Browse files
authored
Add claude-usage@mtwebster. (#8132)
Monitors claude AI usage for given credentials and displays it in the panel.
1 parent fe347ad commit 55d3fa6

File tree

13 files changed

+521
-0
lines changed

13 files changed

+521
-0
lines changed
Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
files/claude-usage@mtwebster/CHANGELOG.md

claude-usage@mtwebster/README.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
files/claude-usage@mtwebster/README.md
Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
## 1.0.0
2+
3+
Initial release
Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
# Claude Usage Monitor
2+
3+
A Cinnamon panel applet that displays Claude API usage limits (5-hour and 7-day) by polling the Anthropic API endpoint.
4+
5+
## Features
6+
7+
- Displays 5-hour and 7-day usage percentages in the panel
8+
- Color-coded text: green (<50%), yellow (50-80%), red (>80%)
9+
- Configurable polling interval (1-60 minutes, default 5)
10+
- Tooltip shows reset times and last update time
11+
- Custom credentials path support
12+
13+
## Requirements
14+
15+
- Claude Code installed and configured (provides API credentials)
16+
- Alternatively, you can specify a custom path to your Claude credentials file
17+
- *Long-lived API keys are not supported (claude setup-token).* You can revert to a 'normal' token by deleting your credentials file and logging in using `/login`.
18+
- Internet access (for calls to `https://api.anthropic.com/api/oauth/usage`).
19+
20+
## Installation
21+
22+
### From Cinnamon Settings (Recommended)
23+
24+
1. Open Cinnamon Settings → Applets
25+
2. Go to the "Download" tab
26+
3. Search for "Claude Usage Monitor"
27+
4. Click "Install"
28+
5. Enable the applet in the "Manage" tab
29+
30+
### Manual Installation
31+
32+
1. Download and extract the applet
33+
2. Copy the folder `claude-usage@mtwebster` to `~/.local/share/cinnamon/applets/`
34+
3. Enable the applet in Cinnamon Settings → Applets
35+
36+
## License
37+
38+
GPL-3.0 License.
39+
40+
[Changelog](https://github.com/linuxmint/cinnamon-spices-applets/blob/master/claude-usage@mtwebster/CHANGELOG.md)

0 commit comments

Comments
 (0)