antigravity-quota-tui 1.0.0 → 1.0.2

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.
Files changed (2) hide show
  1. package/README.md +82 -8
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,25 +1,99 @@
1
- # Antigravity QuotA
1
+ <div align="center">
2
+
3
+ # Antigravity QuotA (TUI)
2
4
 
3
- A sleek terminal dashboard to monitor your AI model quotas and rate limits across multiple accounts.
5
+ **A sleek terminal dashboard to monitor your AI model quotas and rate limits across multiple accounts.**
4
6
 
5
- ## Install
7
+ [![npm version](https://img.shields.io/npm/v/antigravity-quota-tui.svg?style=flat-square)](https://www.npmjs.com/package/antigravity-quota-tui)
8
+ [![License](https://img.shields.io/badge/License-MIT-green?style=flat-square)](#)
9
+
10
+ <img src="https://raw.githubusercontent.com/Dinujaya-Sandaruwan/Antigravity-QuotA/main/assets/screenshot.jpg" alt="Antigravity Quota Dashboard" width="800"/>
11
+
12
+ </div>
13
+
14
+ ---
15
+
16
+ ## Overview
17
+
18
+ `antigravity-quota-tui` is a standalone CLI tool that provides a beautiful, real-time dashboard for monitoring your Google Cloud Code / AI Companion API quotas.
19
+
20
+ Whether you are managing multiple accounts for **Gemini**, **Claude**, or **Flash Lite** models, this tool aggregates all your remaining quotas, reset times, and local rate-limit caches into a single, interactive terminal interface.
21
+
22
+ *Note: This npm package is a lightweight JavaScript wrapper that automatically downloads the highly-optimized native Go binary for your specific operating system (Windows, macOS, or Linux).*
23
+
24
+ ---
25
+
26
+ ## Installation
27
+
28
+ Install the package globally using npm to make the `ant-quota` command available everywhere on your system:
6
29
 
7
30
  ```bash
8
31
  npm install -g antigravity-quota-tui
9
32
  ```
10
33
 
34
+ ---
35
+
11
36
  ## Usage
12
37
 
38
+ Launch the dashboard from any terminal by typing:
39
+
13
40
  ```bash
14
41
  ant-quota
15
42
  ```
16
43
 
17
- ## Configuration
44
+ ### Controls
45
+ - **`R`**: Refresh quota data from the API
46
+ - **`Up` / `Down`** (or `K` / `J`): Scroll the view
47
+ - **`Click`**: Click on a category title (e.g., *Claude Models*) to view the full list of grouped models
48
+ - **`Q`** or **`Ctrl+C`**: Quit
18
49
 
19
- Place your config at `~/.config/opencode/antigravity-accounts.json`, or override with the `OPENCODE_CONFIG_DIR` environment variable.
50
+ ---
20
51
 
21
- See the [full documentation](https://github.com/Dinujaya-Sandaruwan/Antigravity-QuotA) for details.
52
+ ## Configuration (Important!)
22
53
 
23
- ## License
54
+ The tool requires your account credentials to fetch the data. It expects to find a configuration file named `antigravity-accounts.json`.
55
+
56
+ > **CRITICAL: The `OPENCODE_CONFIG_DIR` Variable**
57
+ >
58
+ > To ensure the tool can reliably find your configuration file across different operating systems, **it is highly recommended to set the `OPENCODE_CONFIG_DIR` environment variable.**
24
59
 
25
- MIT
60
+ Place your `antigravity-accounts.json` file in a secure folder, and point the tool to that folder:
61
+
62
+ **macOS / Linux:**
63
+ ```bash
64
+ # Add this to your ~/.bashrc or ~/.zshrc profile:
65
+ export OPENCODE_CONFIG_DIR="/path/to/my/config/folder"
66
+ ```
67
+
68
+ **Windows (PowerShell):**
69
+ ```powershell
70
+ # Set it in your environment variables:
71
+ $env:OPENCODE_CONFIG_DIR="C:\Path\To\My\Config\Folder"
72
+ ```
73
+
74
+ *(Fallback: If not set, it attempts to read from `~/.config/opencode/` on macOS/Linux, or `C:\Users\<User>\.config\opencode\` on Windows).*
75
+
76
+ ### Sample `antigravity-accounts.json`
77
+
78
+ ```json
79
+ {
80
+ "accounts": [
81
+ {
82
+ "email": "your-email@example.com",
83
+ "refreshToken": "1//0eabc...",
84
+ "rateLimitResetTimes": {}
85
+ }
86
+ ],
87
+ "activeIndex": 0
88
+ }
89
+ ```
90
+
91
+ ---
92
+
93
+ ## Links
94
+
95
+ - **GitHub Repository**: [Dinujaya-Sandaruwan/Antigravity-QuotA](https://github.com/Dinujaya-Sandaruwan/Antigravity-QuotA)
96
+ - **Report an Issue**: [GitHub Issues](https://github.com/Dinujaya-Sandaruwan/Antigravity-QuotA/issues)
97
+
98
+ ## License
99
+ MIT License. See the [GitHub repository](https://github.com/Dinujaya-Sandaruwan/Antigravity-QuotA) for full details.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "antigravity-quota-tui",
3
- "version": "1.0.0",
3
+ "version": "1.0.2",
4
4
  "description": "A sleek terminal dashboard to monitor your AI model quotas and rate limits across multiple accounts.",
5
5
  "bin": {
6
6
  "ant-quota": "bin/ant-quota.js"