shard-BRAINS/BRAINS-claude-usage-monitor

¿Qué hace BRAINS-claude-usage-monitor?

Extensión de VSCode que muestra el uso de tokens de Claude Code a partir de transcripciones JSONL locales. Ventanas móviles de 5h/7d, gráfico de evolución y ponderación de tokens facturables según la tarifa de Anthropic.

Características

• Transcripciones JSONL: Analiza los archivos de registro de Claude Code generados localmente.
• Ventanas móviles: Visualiza el uso en las últimas 5 horas y los últimos 7 días.
• Sparkline: Muestra un gráfico de evolución en miniatura para ver las tendencias de uso.
• Ponderación de costos: Aplica los pesos de tokens facturables de Anthropic (input 3x más barato que output, tokens de razonamiento más caros).
• Interfaz en VSCode: Se integra directamente en el panel de estado de VSCode.

Instalación

1. Clona el repositorio:

   git clone https://github.com/tu-usuario/BRAINS-claude-usage-monitor.git
   

2. Abre la carpeta en VSCode y ejecuta npm install para instalar las dependencias.

3. Presiona F5 para iniciar la depuración de la extensión.

Uso

Una vez instalada, la extensión se ejecuta en segundo plano. Puedes ver el uso de tokens en el panel de estado inferior de VSCode. Haz clic en el indicador para abrir un panel detallado con las ventanas de 5 horas y 7 días.

Configuración

Esta extensión no requiere configuración adicional. Busca automáticamente los archivos de transcripción en el directorio predeterminado de Claude Code.

Estructura del proyecto

.
├── .vscode
│   └── launch.json
├── src
│   ├── extension.ts          # Punto de entrada de la extensión
│   ├── tokenUsage.ts         # Lógica de análisis de tokens
│   ├── transcriptReader.ts   # Lector de archivos JSONL
│   └── sparkline.ts          # Generador del gráfico de evolución
├── package.json
├── tsconfig.json
└── README.md

Contribuciones

Las contribuciones son bienvenidas. Por favor, abre un issue o un pull request.

Licencia

MIT