antigravity-usage 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Antigravity Usage Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,136 @@
+# antigravity-usage
+
+CLI tool to check Antigravity model quota via Google Cloud Code API. Supports multiple Google accounts simultaneously.
+
+Inspired by [ccusage](https://github.com/ryoppippi/ccusage).
+
+## Installation
+
+```bash
+npm install -g antigravity-usage
+```
+
+## Quick Start
+
+```bash
+# Login with your first account
+antigravity-usage login
+
+# Add more accounts
+antigravity-usage accounts add
+
+# See quota for ALL accounts at once
+antigravity-usage quota --all
+
+# Switch active account
+antigravity-usage accounts switch user@gmail.com
+```
+
+## Commands
+
+### `antigravity-usage accounts`
+
+Manage multiple Google accounts.
+
+```bash
+antigravity-usage accounts list            # List all accounts & status
+antigravity-usage accounts add             # Add a new account (OAuth)
+antigravity-usage accounts switch <email>  # Set the active account
+antigravity-usage accounts remove <email>  # Remove an account & its data
+antigravity-usage accounts current         # Show active account info
+antigravity-usage accounts refresh --all   # Refresh tokens for all accounts
+```
+
+### `antigravity-usage login`
+
+Authenticate with Google (adds to your accounts list).
+
+```bash
+antigravity-usage login [options]
+```
+
+- `--no-browser`: Print URL instead of opening browser
+- `-p, --port <port>`: Specify callback server port
+
+### `antigravity-usage quota`
+
+Fetch and display quota information (default command).
+
+```bash
+antigravity-usage quota [options]
+```
+
+Options:
+- `--all`: Fetch data for **all** accounts in parallel
+- `-a, --account <email>`: Fetch data for a specific account
+- `--refresh`: Force fresh data (ignore local cache)
+- `--json`: Output as JSON
+- `-m, --method <method>`: `auto` (default), `local`, or `google`
+
+### `antigravity-usage status`
+
+Show authentication and token status.
+
+```bash
+antigravity-usage status        # Status for active account
+antigravity-usage status --all  # Status for all accounts
+```
+
+### `antigravity-usage logout`
+
+Remove stored credentials.
+
+```bash
+antigravity-usage logout [email]  # Logout specific account
+antigravity-usage logout --all    # Logout from all accounts
+```
+
+## Features
+
+### Smart Caching
+To keep things snappy when managing many accounts, the tool caches quota data for **5 minutes**.
+- Use `--refresh` to bypass the cache.
+- The cache is stored per-account.
+
+### Offline Capabilities 🔌
+Antigravity Usage is designed to work seamlessly offline:
+1. **Local Method**: Reads directly from your IDE's language server (no internet required).
+2. **Caching**: If you're completely offline, you can still view the last known quota for all your accounts.
+
+### Responsive UI 📱
+Tables automatically adapt to your terminal size:
+- **Compact View**: For smaller screens or side-by-side terminals.
+- **Spacious View**: Optimizes layout for wide terminals.
+- **Auto-sizing**: Gracefully handles very small widths.
+
+### Fetch Methods
+- **auto (default)**: Tries local Antigravity server first (offline), then falls back to Google API (online).
+- **local**: Only talks to your IDE's Antigravity server (**Offline**, no login needed).
+- **google**: Only talks to Google Cloud APIs (Online only).
+
+---
+
+## Configuration
+
+### OAuth Credentials
+The tool works out of the box with built-in credentials. To use your own:
+```bash
+export ANTIGRAVITY_OAUTH_CLIENT_ID="..."
+export ANTIGRAVITY_OAUTH_CLIENT_SECRET="..."
+```
+
+### Token Storage
+Data is stored in your system's config directory:
+- **macOS**: `~/Library/Application Support/antigravity-usage/accounts/`
+- **Linux**: `~/.config/antigravity-usage/accounts/`
+- **Windows**: `%APPDATA%/antigravity-usage/accounts/`
+
+## Development
+
+```bash
+npm run dev -- quota --all
+npm test
+```
+
+## License
+MIT

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+
+export {  }