⚡ Antigravity Quota Viewer

Comprehensive visualization of AI model quota status in Antigravity with predictive analysis and modern dashboard.

🇪🇸 Versión en Español

✨ Features

📊 Visual Dashboard with modern glassmorphism design
🔮 Quota Exhaustion Prediction based on burn rate
📈 Real-time Burn Rate Analysis per model
🏥 Overall Health Score showing weighted average of all quotas
🎯 Customizable Alerts for low specific quotas
💳 Prompt Credits Tracking (available vs total)
📱 Integrated Status Bar with summary info
🔄 Auto-refresh via configurable polling

🚀 Installation

From Marketplace

You can install the extension directly from your favorite marketplace:

Antigravity / Open VSX: Install from Open VSX
VS Code Marketplace: Install from VS Code Marketplace

Open Antigravity IDE or VS Code
Go to Extensions (Cmd+Shift+X)
Search for "Antigravity Quota Viewer"
Click Install

Manual Installation

Download the .vsix file from the Releases page.
Open Antigravity IDE
Extensions → ... → Install from VSIX
Select the downloaded file

📖 Usage

Available Commands

Command	Description	Shortcut
`Quota Viewer: Open Dashboard`	Open full dashboard	-
`Quota Viewer: Quick Status`	Quick status view	-
`Quota Viewer: Refresh Now`	Manually refresh data	-

Quick Access

Status Bar: Click on the quota indicator in the bottom bar
Command Palette: Cmd+Shift+P → Search "Quota Viewer"

⚙️ Configuration

Open Settings (Cmd+,) and search for "Quota Viewer":

{
  // Enable automatic monitoring
  "quotaViewer.enabled": true,
  
  // Polling interval in seconds (minimum 30s)
  "quotaViewer.pollingInterval": 120,
  
  // Models to show in status bar (IDs or labels)
  "quotaViewer.pinnedModels": [],
  
  // Alert threshold percentage (5-50%)
  "quotaViewer.alertThreshold": 20
}

📊 Dashboard Features

The dashboard displays:

Overall Health Score: Weighted average of all quotas
Active Models Count: Number of available models
Session Usage: Usage since Antigravity started
Model Cards: For each AI model:
- Remaining percentage with circular visualization
- Time until reset
- Burn rate (consumption speed)
- Predicted exhaustion ETA
- Usage in current session
- Active model badge

🔧 Development

Requirements

Node.js 20+
npm 8+
Antigravity IDE installed

Local Setup

# Clone repository
git clone https://github.com/AsierDev/antigravity-quota-viewer
cd antigravity-quota-viewer

# Install dependencies
npm install

# Compile
npm run compile

# Run tests
npm test

# Coverage
npm run test:coverage

# Package extension
npm run package

Testing in Antigravity

Open the project in Antigravity
Press F5 to start debugging
The extension will be active in the new Antigravity window

🏗️ Architecture

src/
├── core/               # Core services
│   ├── processDetector.ts   # Antigravity process detection
│   ├── quotaService.ts       # Quota API client
│   └── platformStrategies.ts # Multi-platform strategies
├── insights/           # Analysis and predictions
│   └── insightsService.ts    # Burn rate and ETA calculation
├── ui/                 # UI Components
│   ├── statusBar.ts          # Status bar manager
│   └── dashboard/            # WebView dashboard
└── types/              # TypeScript definitions

out/                    # Compiled code
coverage/               # Coverage reports

🧪 Tests

84 unit tests with Jest
40% global coverage (core services >80%)
Test suites:
- processDetector.test.ts: Process detection
- quotaService.test.ts: API calls
- insightsService.test.ts: Data analysis

npm test              # Run all tests
npm run test:watch    # Watch mode
npm run test:coverage # With coverage report

🤝 Contributing

Contributions are welcome!

Fork the repository
Create your feature branch (git checkout -b feature/AmazingFeature)
Commit your changes (git commit -m 'Add: amazing feature')
Push to the branch (git push origin feature/AmazingFeature)
Open a Pull Request

Guidelines

Keep tests passing
Add tests for new features
Follow project TypeScript conventions
Document public functions with JSDoc

🐛 Issues

Report bugs or request features on GitHub Issues

📄 License

🙏 Acknowledgements

Antigravity Team for the excellent IDE
VS Code Community for the extensible APIs

Made with ❤️ for the Antigravity community

⚡ Antigravity Quota Viewer

🇺🇸 English Version

Visualización exhaustiva del estado de cuotas de modelos AI en Antigravity con análisis predictivo y dashboard moderno.

🇪🇸 Versión en Español

✨ Features

📊 Dashboard visual con diseño glassmorphism moderno
🔮 Predicción de agotamiento de cuotas basada en burn rate
📈 Análisis de burn rate por modelo en tiempo real
🏥 Overall Health Score mostrando promedio ponderado de cuotas
🎯 Alertas personalizables cuando la cuota está baja
💳 Seguimiento de Prompt Credits disponibles
📱 Status bar integrado con información resumida
🔄 Actualización automática via polling configurable

🚀 Instalación

Desde Marketplace

Puedes instalar la extensión directamente desde tu marketplace favorito:

Antigravity / Open VSX: Instalar desde Open VSX
VS Code Marketplace: Instalar desde VS Code Marketplace

Abrir Antigravity IDE o VS Code
Ir a Extensions (Cmd+Shift+X)
Buscar "Antigravity Quota Viewer"
Click en Install

Instalación Manual

Descarga el archivo .vsix desde la página de Releases.
Abrir Antigravity IDE
Extensions → ... → Install from VSIX
Seleccionar el archivo descargado

📖 Uso

Comandos Disponibles

Comando	Descripción	Atajo
`Quota Viewer: Open Dashboard`	Abrir dashboard completo	-
`Quota Viewer: Quick Status`	Vista rápida de estado	-
`Quota Viewer: Refresh Now`	Actualizar datos manualmente	-

Acceso Rápido

Status Bar: Click en el indicador de cuota en la barra inferior
Command Palette: Cmd+Shift+P → Buscar "Quota Viewer"

⚙️ Configuración

Abre Settings (Cmd+,) y busca "Quota Viewer":

{
  // Habilitar monitoreo automático
  "quotaViewer.enabled": true,
  
  // Intervalo de actualización en segundos (mínimo 30s)
  "quotaViewer.pollingInterval": 120,
  
  // Modelos a mostrar en status bar (IDs o labels)
  "quotaViewer.pinnedModels": [],
  
  // Umbral de alerta en porcentaje (5-50%)
  "quotaViewer.alertThreshold": 20
}

📊 Dashboard Features

El dashboard muestra:

Overall Health Score: Promedio ponderado de todas las cuotas
Active Models Count: Número de modelos disponibles
Session Usage: Uso desde que iniciaste Antigravity
Model Cards: Para cada modelo AI:
- Porcentaje restante con visualización circular
- Tiempo hasta el reset
- Burn rate (velocidad de consumo)
- ETA de agotamiento predicha
- Uso en la sesión actual
- Badge de modelo activo

🔧 Desarrollo

Requisitos

Node.js 20+
npm 8+
Antigravity IDE installed

Setup Local

# Clonar repositorio
git clone https://github.com/AsierDev/antigravity-quota-viewer
cd antigravity-quota-viewer

# Instalar dependencias
npm install

# Compilar
npm run compile

# Ejecutar tests
npm test

# Coverage
npm run test:coverage

# Empaquetar extensión
npm run package

Testing en Antigravity

Abrir el proyecto en Antigravity
Presionar F5 para iniciar debug
En la nueva ventana de Antigravity, la extensión estará activa

🏗️ Arquitectura

src/
├── core/               # Servicios principales
│   ├── processDetector.ts   # Detección del proceso Antigravity
│   ├── quotaService.ts       # Cliente API de cuotas
│   └── platformStrategies.ts # Estrategias multi-plataforma
├── insights/           # Análisis y predicciones
│   └── insightsService.ts    # Cálculo de burn rate y ETAs
├── ui/                 # Componentes de interfaz
│   ├── statusBar.ts          # Gestor de status bar
│   └── dashboard/            # WebView dashboard
└── types/              # Definiciones TypeScript

out/                    # Código compilado
coverage/               # Reportes de coverage

🧪 Tests

84 tests unitarios con Jest
40% coverage global (core services >80%)
Test suites:
- processDetector.test.ts: Detección de procesos
- quotaService.test.ts: Llamadas API
- insightsService.test.ts: Análisis de datos

npm test              # Ejecutar todos los tests
npm run test:watch    # Watch mode
npm run test:coverage # Con reporte de coverage

🤝 Contribuir

Las contribuciones son bienvenidas!

Fork el repositorio
Crea tu feature branch (git checkout -b feature/AmazingFeature)
Commit tus cambios (git commit -m 'Add: amazing feature')
Push al branch (git push origin feature/AmazingFeature)
Abre un Pull Request

Guidelines

Mantener tests pasando
Agregar tests para nuevas features
Seguir convenciones TypeScript del proyecto
Documentar funciones públicas con JSDoc

🐛 Issues

Reporta bugs o pide features en GitHub Issues

📄 License

🙏 Agradecimientos

Antigravity Team por el excelente IDE
Comunidad VS Code por las APIs extensibles

Hecho con ❤️ para la comunidad de Antigravity