toktracker
TokTracker es un panel auto-alojado local-first para rastrear uso de agentes IA en múltiples dispositivos. Usa Bun, separa gateway/API/SQLite del cliente escáner y dashboard React/Vite. Soporta JSONL/SQLite/CSV de múltiples fuentes.
Ficha actualizada 26 sept 2026, 19:58 · upstream 26 sept 2026, 19:50 · release v0.1.5
Qué es toktracker
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
TokTracker es una solución auto-alojada diseñada para proporcionar visibilidad centralizada sobre el uso de agentes de IA en la codificación a través de múltiples dispositivos locales. La arquitectura separa las responsabilidades entre un gateway que aloja la API y base de datos SQLite, clientes ligeros que escanean sesiones locales en cada máquina, y un dashboard web construido con React y Vite para la visualización de datos.
El sistema funciona mediante una configuración local-first donde los clientes recopilan métricas de tokens, costos estimados o reportados por proveedores, modelos utilizados y proyectos activos. Los datos se sincronizan incrementalmente al gateway mediante claves de ingesta AES-256-GCM, manteniendo la privacidad sin enviar datos a servicios externos no controlados. La instalación requiere Bun 1.3.12 o superior y ofrece scripts para macOS, Linux y Windows.
La plataforma soporta múltiples fuentes de datos incluyendo formatos JSONL, SQLite, CSV desde herramientas como Cursor, GitHub Copilot, Claude Code y OpenCode. Incluye mecanismos de actualización automática gestionados por gateway con canales estables o nightly, y permite migraciones seguras desde instalaciones globales legacy mediante almacenamiento versionado de releases.
- Auditoría centralizada del consumo de tokens y costos en múltiples máquinas de desarrollo
- Visualización histórica de sesiones de agentes IA con soporte para actualizaciones incrementales
- Gestión de dispositivos conectados con autenticación por códigos de emparejamiento temporales
- Control de versiones de clientes con capacidad de rollback a versiones anteriores
- Arquitectura local-first sin dependencia de servicios cloud externos para el procesamiento de datos
- Soporte nativo para múltiples formatos de sesión (JSONL, SQLite, CSV) de diferentes agentes IA
- Actualizaciones automáticas gestionadas por gateway con ventana de mantenimiento configurable
- Encriptación AES-256-GCM para payloads de ingesta con separación clara de claves
- Requiere Bun 1.3.12 o superior como runtime obligatorio para todas las plataformas soportadas
- No incluye Docker ni archivos de composición, requiriendo instalación manual del runtime
- El dashboard requiere emparejamiento manual mediante códigos temporales por dispositivo
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Recomendado alojar el gateway en una máquina con acceso a red local confiable y configurar firewall para el puerto elegido (default 3000). Utilizar HTTPS fuera de redes privadas confiables y establecer TOKTRACKER_CORS_ORIGIN si se requiere acceso cross-origin. Los clientes deben configurarse con la URL del gateway y clave de ingesta compartida, verificando /api/health antes de sincronizar.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.