gusage 1.0.5 → 1.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +10 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# gusage
|
|
2
2
|
|
|
3
|
-
A
|
|
3
|
+
A CLI / TUI to monitor Gemini CLI usage.
|
|
4
4
|
|
|
5
5
|
<p align="center">
|
|
6
6
|
<img src="https://raw.githubusercontent.com/a-hariti/gusage/master/assets/demo.png" width="500" />
|
|
@@ -11,6 +11,7 @@ This tool reverse-engineers the internal API handshakes used by the main Gemini
|
|
|
11
11
|
## Features
|
|
12
12
|
|
|
13
13
|
- **Live Monitoring:** Real-time quota updates using the `--watch` flag.
|
|
14
|
+
- **Low-Quota Alerts:** Optional desktop notifications with `--notify` when usage drops below a threshold.
|
|
14
15
|
- **Machine Readable:** Supports JSON output for easy integration with other tools.
|
|
15
16
|
- **Fast:** Returns results in sub-second time.
|
|
16
17
|
- **Smart Sorting:** Automatically sorts models to highlight the ones you care about.
|
|
@@ -46,6 +47,12 @@ gusage --watch
|
|
|
46
47
|
# Monitor quota every 1 minute and 20 seconds
|
|
47
48
|
gusage --watch 1m20s
|
|
48
49
|
|
|
50
|
+
# Monitor quota and notify when any model falls below 20% (default threshold)
|
|
51
|
+
gusage --watch --notify
|
|
52
|
+
|
|
53
|
+
# Monitor quota and notify when any model falls below 15%
|
|
54
|
+
gusage --watch 30s --notify 15
|
|
55
|
+
|
|
49
56
|
# Output raw JSON for scripting
|
|
50
57
|
gusage --json | jq .
|
|
51
58
|
|
|
@@ -57,12 +64,14 @@ gusage --json --watch 5s | jq .
|
|
|
57
64
|
|
|
58
65
|
- `-h, --help`: Show help message.
|
|
59
66
|
- `-w, --watch [interval]`: Update live every interval (default: 10s). Supports units like `20s`, `5m`, `1m20s`.
|
|
67
|
+
- `-n, --notify [threshold]`: Send a desktop notification when a model drops below the threshold percent (default: `20`). Requires `--watch`.
|
|
60
68
|
- `-j, --json`: Output raw JSON instead of a table. Can be combined with `--watch` for streaming data.
|
|
61
69
|
- `--no-color`: Disable color output (also respects `NO_COLOR` env var).
|
|
62
70
|
|
|
63
71
|
## Requirements
|
|
64
72
|
|
|
65
73
|
- **Authentication:** You must have already authenticated via the official Gemini CLI (`gemini login`).
|
|
74
|
+
- **Notifications (Linux only):** `notify-send` must be installed when using `--notify`.
|
|
66
75
|
|
|
67
76
|
## License
|
|
68
77
|
|