quotabar

# QuotaBar QuotaBar es una utilidad ligera, solo para barra de menús, para macOS 14+ que rastrea las cuotas de suscripción restantes de varios servicios de chat y codificación con IA. Proporciona un indicador visual de los límites de uso para **Cursor**, **ChatGPT** (Plus/Pro), **GLM** (z.ai/BigModel), **Grok** (SuperGrok de consumo) y **OpenCode Go**. La aplicación opera discretamente como una píldora oscura en la barra de estado, mostrando un porcentaje y un pequeño gráfico de barras, con un popover compacto para la gestión detallada de cuentas. ## Características clave - **Soporte multiservicio**: Monitorea el uso de cuotas de cinco plataformas de IA distintas utilizando sus endpoints de uso no oficiales pero estándar. - **Integración con la barra de menús**: Muestra un único icono en la barra de estado de macOS con un indicador de porcentaje. El color cambia a naranja cuando la cuota restante cae por debajo del 25%. - **Popover compacto**: Un popover de tamaño fijo (320x360) muestra tarjetas detalladas para cada proveedor o cuenta. Admite desplazamiento para múltiples cuentas e incluye acceso a la configuración. - **Gestión de múltiples cuentas**: Admite múltiples cuentas para ChatGPT y OpenCode Go. Los usuarios pueden cambiar entre cuentas activas directamente desde el popover, con la barra de estado reflejando el uso de la cuenta seleccionada. - **Almacenamiento local de credenciales**: Los secretos se almacenan de forma segura en el Llavero de macOS. Las preferencias no secretas se guardan en `~/.config/quotabar/config.json` con permisos restringidos (modo 0600). - **Sin telemetría**: La aplicación no envía ningún dato de uso ni telemetría a servidores externos más allá de obtener la información de cuota necesaria de las API de los respectivos proveedores. - **Enfoque en la privacidad**: Diseñada como un `LSUIElement` no sandbox para permitir la lectura de archivos locales (como la base de datos de estado de Cursor) y el manejo de cookies del navegador sin permisos complejos. ## Proveedores y métodos compatibles ### Cursor - Lee tokens de autenticación de la base de datos local de la aplicación Cursor (`state.vscdb`) o acepta cookies de sesión pegadas. - Obtiene datos de uso desde `cursor.com/api/usage-summary`. - Distingue entre los grupos "Cursor Models" y "Other Models". ### ChatGPT (Plus / Pro) - Admite múltiples cuentas mediante el Codex CLI (`codex login`) o entrada manual de cookies/JSON. - Utiliza el endpoint `wham/usage` para obtener los límites de sesión, semanales y mensuales. - Actualiza automáticamente los tokens caducados usando la API pública de OAuth si el Codex CLI está disponible. ### GLM (z.ai / BigModel) - Acepta claves API a través de Ajustes o variables de entorno. - Admite tanto la región global (`api.z.ai`) como la de China (`open.bigmodel.cn`). - Obtiene los límites de cuota desde la API de monitoreo. ### Grok (SuperGrok de consumo) - Lee la autenticación desde `~/.grok/auth.json` escrito por el Grok CLI o acepta tokens OAuth pegados. - Obtiene datos de facturación y uso desde la API proxy del Grok CLI. - Se dirige específicamente a los planes SuperGrok de consumo, no a las API de gestión de equipos. ### OpenCode Go - Soporte de múltiples cuentas mediante claves API almacenadas en el Llavero. - Obtiene el uso desde `opencode.ai/zen/go/v1/usage`. - Convierte los porcentajes de "usado" a "restante" para su visualización. ## Instalación El método de instalación recomendado es mediante Homebrew: ```bash brew tap ttaatoo/quotabar https://github.com/ttaatoo/quotabar brew install --cask ttaatoo/quotabar/quotabar ``` Si Gatekeeper bloquea la aplicación firmada ad-hoc, es posible que debas ejecutar: ```bash xattr -dr com.apple.quarantine /Applications/QuotaBar.app ``` Luego abre Ajustes del Sistema > Privacidad y seguridad y haz clic en **Abrir de todos modos**. ## Compilación desde el código fuente Requisitos: macOS 14+, Xcode 15.4+ (Swift 5.9+). ```bash git clone https://github.com/ttaatoo/quotabar.git cd quotabar open QuotaBar.xcodeproj ``` Ejecuta el proyecto en Xcode o compílalo desde la línea de comandos: ```bash xcodebuild -project QuotaBar.xcodeproj -scheme QuotaBar -configuration Release \ MARKETING_VERSION=0.0.13 CURRENT_PROJECT_VERSION=0.0.13 \ CODE_SIGN_IDENTITY="-" CODE_SIGNING_ALLOWED=YES CODE_SIGNING_REQUIRED=NO build ``` ## Descargo de responsabilidad QuotaBar es una herramienta independiente y no oficial. Interactúa con endpoints de uso privados que pueden cambiar sin previo aviso. No está afiliada a Cursor, OpenAI, z.ai, BigModel, xAI ni OpenCode. Los usuarios son responsables de gestionar sus propias credenciales y de comprender los riesgos de usar API no oficiales.