Conecta tus cuentas.
Entiende lo que estás leyendo.

Requisitos e información del lanzamiento

AIUsageWatch es una app nativa gratuita para la barra de menús de macOS 14 o posterior. El lanzamiento público está en preparación. Añadiremos un enlace de descarga verificado a este sitio web cuando esté disponible. Tus cuentas de proveedores y los cargos de sus planes son independientes.

Mueve la app publicada a Aplicaciones antes de activar Abrir al iniciar sesión. La app reside en la barra de menús y no necesita un icono en el Dock. Abrir desde Finder la app que ya está en ejecución trae Preferencias al primer plano.

Conecta tus proveedores

1. Codex: instala la CLI de Codex e inicia sesión. Configura la cuenta para que use su directorio de configuración, normalmente ~/.codex. La app utiliza las credenciales guardadas de ese directorio a través del app-server local de la CLI.
2. Claude: la cuenta predeterminada ~/.claude utiliza tu sesión de claude.ai en Safari. En Preferencias, concede acceso al archivo Cookies.binarycookies de Safari. Para un directorio de configuración independiente de Claude, inicia sesión con Claude Code utilizando ese CLAUDE_CONFIG_DIR; la app lee su archivo .credentials.json.
3. Cursor: inicia sesión en cursor.com desde Safari y concede acceso al archivo de cookies de Safari en Preferencias. Cursor no utiliza un directorio de cuenta para su lectura.
4. Grok: selecciona el directorio de Grok que contiene logs/unified.jsonl. Ejecuta Grok para actualizar la lectura de facturación de ese registro.

La app lee la información de cuota disponible en cada fuente. Las fuentes de la CLI de Claude y Codex necesitan sus correspondientes credenciales guardadas. La vista previa del sitio web nunca accede a tus cuentas.

Cuentas personales y de trabajo juntas

Abre Preferencias… desde el menú o pulsa ⌘,. Cada cuenta tiene una etiqueta, proveedor, directorio, color y letra. Utiliza + para añadir un directorio; la app deduce el proveedor a partir de su contenido. Comprueba el proveedor antes de utilizar la nueva cuenta.

Para otra sesión de Codex, selecciona un CODEX_HOMEindependiente. Para otra sesión de Claude, utiliza un CLAUDE_CONFIG_DIR independiente con sus propias credenciales guardadas. La sesión predeterminada de Claude en Safari puede ser ambigua cuando contiene varias organizaciones; utiliza un directorio de configuración independiente en ese caso. El lector de Cursor utiliza la sesión disponible de Safari, por lo que añadir una fila duplicada de Cursor no crea una sesión independiente.

Más cuentas añaden columnas, con un máximo de tres filas en cada columna. Las letras y los colores personalizados ayudan a identificar las cuentas. Los ajustes generales incluyen la frecuencia de actualización, marcadores de porcentaje, letras y un aviso de caducidad de restablecimientos acumulados de Codex cuando esa información es compatible.

Entiende las barras

La parte rellena indica la cuota restante. Con el 0% restante no hay barra rellena. El color identifica una cuenta. El menú muestra porcentajes, fechas de restablecimiento disponibles, detalles de las ventanas correspondientes y el estado de la lectura.

Claude incluye detalles semanales y de cinco horas cuando están disponibles; Codex selecciona el límite semanal principal. Cursor utiliza su propia cifra de uso incluido, cuyos datos no indican un periodo de uso. Grok utiliza una cifra de créditos semanales del registro de la CLI. Los porcentajes de distintos proveedores no equivalen a las mismas cantidades de tokens, solicitudes o dólares.

Detecta los restablecimientos acumulados de Codex antes de que caduquen

Cuando Codex comunica los restablecimientos acumulados disponibles y sus fechas de caducidad, AIUsageWatch puede mostrar un punto de aviso junto a la cuenta antes de que caduque el siguiente restablecimiento acumulado. Abre el menú para ver la cantidad disponible y la información de caducidad. Un restablecimiento acumulado sin utilizar puede perderse cuando caduca; esto es independiente del momento habitual en que se restablece tu cuota semanal.

Activa Avisar antes del restablecimiento en Preferencias y elige 1–14 días de antelación. El valor predeterminado es de dos días, con un punto de aviso rojo; puedes cambiar el color. El punto sigue visible aunque las letras de las cuentas estén desactivadas. El aviso depende de que la app esté en ejecución, los avisos estén activados y los datos de caducidad estén disponibles y actualizados. No utiliza automáticamente un restablecimiento acumulado ni envía una notificación del sistema.

La solicitud automática de inicio de Codex

Cuando una lectura semanal de Codex en tiempo real indica el 100% restante, AIUsageWatch envía una pequeña solicitud mediante codex exec utilizando las credenciales guardadas de la CLI de ese directorio. Su finalidad es iniciar una ventana semanal que podría permanecer inactiva. Utiliza el modelo disponible por defecto de Codex y consume una pequeña cantidad de la cuota de esa cuenta.

Un punto rojo señala la cuenta mientras la solicitud está en curso o si falla. El menú explica el estado y permite reintentar manualmente. La app recuerda el intento en memoria para esa ventana semanal. Las consultas repetidas no envían más solicitudes para ese intento recordado; volver a abrir la app borra la memoria y puede dar lugar a otra solicitud si la lectura en tiempo real sigue siendo del 100%.

La fuente alternativa de transcripciones históricas no envía solicitudes de inicio. El inicio automático de Claude no está activado en la versión actual. Esto es independiente de la lectura del uso, y las preferencias actuales no ofrecen un interruptor para la solicitud de inicio de Codex.

Una cifra es antigua, falta o no es la esperada

• Lectura guardada: la última lectura válida se guarda en caché en tu Mac y se restaura al abrir la app. El menú indica su antigüedad cuando falla una actualización.
• Límite de solicitudes o fallo de conexión: los reintentos se retrasan 15 minutos después de alcanzar un límite de solicitudes y 2 minutos después de otros errores. Actualizar ahora omite esa espera.
• Conexión de Safari: comprueba que hayas iniciado sesión con el proveedor correcto, revisa el permiso del archivo de cookies y confirma que la sesión no sea ambigua.
• Grok: ejecuta la CLI para registrar una nueva lectura de uso. Una ventana vencida o un registro antiguo se muestra como histórico en lugar de como un saldo en tiempo real.
• Codex: confirma que la CLI esté disponible y que el directorio configurado tenga las credenciales de la cuenta deseada. Las transcripciones utilizadas como alternativa pueden mostrar información antigua si el app-server no está disponible.

Los endpoints y los datos de los proveedores pueden cambiar. Una lectura no garantiza que el proveedor acepte la siguiente solicitud. Consulta la página de tu cuenta del proveedor si un saldo o un restablecimiento parecen incorrectos.

Ajustes locales y conexiones con proveedores

Las preferencias y las lecturas en caché se guardan en ~/Library/Application Support/AiUsageWatch/. La app no lee directamente el Llavero. Las CLI de los proveedores gestionan su propio proceso de inicio de sesión. Los lectores en tiempo real contactan con el proveedor correspondiente utilizando la sesión o las credenciales existentes. Lee la política de privacidad para conocer las diferencias entre el almacenamiento local de la app, las conexiones con proveedores y los mensajes de soporte.

Informa de un problema

Contacta con el soporte de AIUsageWatch con la versión de la app, la versión de macOS, el proveedor, el estado de la lectura y los pasos para reproducir el problema. Si utilizas el modo de diagnóstico --dump , revisa su salida antes de enviarla. Elimina tokens, valores de cookies, rutas privadas de cuentas y cualquier otra información sensible. No subas archivos de credenciales.