claude-use-extension/README.md

Claude Usage Tracker - Extensión de Chrome

Extensión de Chrome que mejora la página de uso de Claude (https://claude.ai/settings/usage) añadiendo:

Características

📊 División semanal del uso

• Divide la barra de progreso "Todos los modelos" en los 7 días de la semana
• Muestra visualmente cuánto deberías usar cada día para no quedarte sin cuota
• Indica con colores si vas bien (verde), con cuidado (amarillo) o excedido (rojo)

⏱️ Información de sesión

• Hora de inicio de la sesión actual
• Hora actual
• Duración de la sesión

📈 Estadísticas

• Uso diario ideal (≈14.29% por día)
• Promedio real de uso
• Días restantes hasta el reinicio

Instalación

1. Crear iconos PNG (requerido):

   • Abre icons/icon.svg en un editor de imágenes
   • Exporta como PNG en tamaños: 16x16, 48x48 y 128x128
   • Guárdalos como icon16.png, icon48.png e icon128.png en la carpeta icons/

2. Cargar en Chrome:

   • Abre Chrome y ve a chrome://extensions/
   • Activa el "Modo de desarrollador" (esquina superior derecha)
   • Haz clic en "Cargar extensión sin empaquetar"
   • Selecciona la carpeta claude-use-extension

3. Usar:

   • Ve a https://claude.ai/settings/usage
   • La extensión se activará automáticamente mostrando el tracker semanal

Estructura de archivos

claude-use-extension/
├── manifest.json      # Configuración de la extensión
├── content.js         # Script que modifica la página
├── styles.css         # Estilos del tracker
├── icons/
│   ├── icon.svg       # Icono fuente (SVG)
│   ├── icon16.png     # (crear manualmente)
│   ├── icon48.png     # (crear manualmente)
│   └── icon128.png    # (crear manualmente)
└── README.md

Cómo funciona

• Detección de uso: La extensión busca la barra de progreso en la página y extrae el porcentaje de uso actual
• Cálculo semanal: Asume que el uso se reinicia los lunes y calcula el uso ideal diario (100%/7 ≈ 14.29%)
• Sesión: Guarda la hora de inicio en localStorage y la mantiene si llevas menos de 4 horas

Personalización

Puedes modificar styles.css para cambiar los colores y estilos del tracker.

Notas

• La extensión solo funciona en https://claude.ai/settings/usage
• Los datos de sesión se guardan localmente en tu navegador
• No se envía ninguna información a servidores externos