Copilot Budget GuardExtensión de VS Code que monitoriza el consumo estimado (USD) de GitHub Copilot Chat leyendo los logs nativos del cliente. No intercepta peticiones ni requiere agentes externos: calcula costes a partir de los precios oficiales y notifica cuando te acercas a tu presupuesto. Estado: Extensión publicada en el Marketplace de Visual Studio Code — este README está orientado a usuarios finales (sin instrucciones de instalación/compilación). Resumen de funcionalidades
Uso rápido
ConfiguraciónConfiguración disponible en Ajustes > Copilot Budget Guard o en
PrivacidadEl historial guarda métricas agregadas por día y por modelo. No se almacenan prompts ni contenido de peticiones. Precios (referencia)La extensión descarga precios oficiales; la UI refleja valores actualizados. Tabla orientativa:
SoportePara bugs o mejoras, abre un issue en el repositorio. Instrucciones de desarrollo y empaquetado en Requisitos previos
Instalación
Tras la instalación, recarga VS Code con Para verificar que se ha instalado correctamente:
Cómo funcionaLa extensión no requiere ningún agente de chat ni intercepta peticiones. Lee periódicamente los logs internos de Copilot Chat mediante el comando Polling adaptativo:
Usa Copilot Chat con normalidad — la extensión detecta el uso automáticamente. UsoBarra de estadoEn la esquina inferior derecha aparece el consumo mensual en tiempo real, con una barra de progreso ASCII y un icono de color según el porcentaje:
Pasa el ratón sobre el ítem para ver el desglose completo (tokens de entrada y salida, totales mensual y diario). Haz clic para abrir el Dashboard. DashboardAbre un panel con:
Comandos de la paleta (
|
| Comando | Descripción |
|---|---|
Copilot Budget: Ver Dashboard de consumo |
Abre el panel de estadísticas |
Copilot Budget: Actualizar datos ahora |
Fuerza un poll inmediato de los logs |
Copilot Budget: Configurar límites |
Abre los ajustes de la extensión |
Alertas de umbral
Al alcanzar los porcentajes configurados (por defecto 80%, 90%, 100%) aparece una notificación con botón directo al Dashboard.
Configuración
Todas las opciones están en Ajustes > Copilot Budget Guard (o edita settings.json):
| Clave | Por defecto | Descripción |
|---|---|---|
| copilotBudget.monthlyTokenLimit | 1000000 | Límite mensual de tokens sobre el que se calculan los umbrales. Ver referencia de planes abajo. |
| copilotBudget.sessionTokenLimit | 50000 | Límite diario informativo (persiste entre reinicios, se resetea al cambiar de día). |
| copilotBudget.warnAtPercents | [80, 90, 100] | Porcentajes del límite mensual en los que emitir avisos. |
| copilotBudget.retentionDays | 90 | Días de historial a conservar. Los días más antiguos se eliminan automáticamente. |
| copilotBudget.logDirectory | "" | Directorio del log. Vacío = ~/.copilot-budget/. |
Log de uso
El historial se guarda en ~/.copilot-budget/usage-log.json (o en el directorio configurado). Es un JSON legible con totales diarios — nunca se almacenan prompts ni contenido de peticiones. Los días más antiguos que retentionDays se eliminan automáticamente en cada escritura.
Desarrollo
# Compilar en modo watch
npm run watch
# O compilar una vez
npm run compile
Para depurar, abre el proyecto en VS Code y pulsa F5 — se abrirá una ventana de extensión de desarrollo.