💰 Token Optimizer

Plugin de ahorro de contexto instalado en Hermes (2026-10-28, VPS).

• Versión: 0.2.1 beta · commit 41cc1a7
• Repo: https://github.com/alexgreensh/token-optimizer
• Plugin: ~/.hermes/plugins/token-optimizer/ (9 archivos, 17 hooks)
• Checkout: ~/token-optimizer/ (~105 MB) — no borrar: los motores de compresión y checkpoints se ejecutan desde ahí
• Licencia: PolyForm Noncommercial 1.0.0 (uso personal, no comercial)

Qué hace

• Comprime la salida de terminal y de herramientas (git, find, ls, docker, tests, logs…) y guarda el original completo por si hace falta.
• Cachea relecturas: releer un fichero sin cambios devuelve un mapa de estructura; si cambió, solo el diff.
• Avisa de bucles (mismo comando 3 veces, rachas de fallos) y deduplica salidas repetidas.
• Checkpoints de la tarea activa antes de que Hermes compacte, y restauración posterior del contexto.
• Pistas de sesiones anteriores: al empezar una sesión nueva apunta al último checkpoint y empareja por tema.
• Puntuación de calidad de contexto (S–F) y registro de coste/uso por sesión.

Cómo pedírmelo

• /token-optimizer — resumen de tokens y coste de las últimas sesiones
• /token-optimizer cost ayer parser — qué costó una sesión pasada
• /token-optimizer checkpoint — guardar un checkpoint ahora
• /token-optimizer expand <id> — recuperar una salida comprimida completa
• hermes token-optimizer — dashboard en http://localhost:24844

Mantenimiento

• Actualizar: cd ~/token-optimizer && git pull && bash install.sh --hermes --enable
• Comprobar: python3 ~/token-optimizer/skills/token-optimizer/scripts/measure.py hermes-doctor
• Desinstalar: bash install.sh --hermes --uninstall y quitar - token-optimizer de plugins.enabled
• Apagar funciones sueltas: variables TOKEN_OPTIMIZER_HERMES_* a 0 (terminal, tool-results, read-cache, checkpoints, restore, continuity, verbosity, redaction)

Notas

• Lee ~/.hermes/state.db en solo lectura (mode=ro), sin telemetría ni llamadas de red y sin dependencias Python.
• Es un plugin, no una skill: Hermes los carga al arrancar, así que hace falta reiniciar el gateway para que los 17 hooks entren en juego.
• Instalación verificada: hermes-doctor → 19 OK, 0 WARN, 0 FAIL. Único cambio en config.yaml: plugins.enabled: [token-optimizer].

Enlaces

• Repo: https://github.com/alexgreensh/token-optimizer
• Integración Hermes: https://github.com/alexgreensh/token-optimizer/blob/main/hermes/README.md
• Documentación: https://alexgreensh.github.io/token-optimizer/