🔧 Token Optimizer

Plugin de optimización de contexto para agentes de código, de alexgreensh (repo). Se instala como plugin nativo en cada plataforma y trabaja desde los hooks (PreToolUse / PostToolUse / SessionStart / Stop / UserPromptSubmit), sin proxy ni servidor MCP intermedio.

Qué es

Una capa externa que intercepta lo que va a entrar en el contexto y lo que sobrevive a la compactación. No reescribe prompts ni toca el prefijo ya cacheado: comprime contenido nuevo, archiva lo grande, mide, y avisa.

Plataformas

Claude Code (superficie de referencia), Hermes, Codex, OpenCode, OpenClaw, Copilot, Cursor, Pi, Google Antigravity y Grok Build (beta). Devin tiene un filtro de salida en beta. La status bar de escritorio, subagent-cache y las recomendaciones automáticas son exclusivas de Claude Code.

Piezas

• Compresión activa (9 features, activas por defecto): delta mode, structure map, first-read skeleton (solo código), compresión de bash/search, nudges de salida concisa, nudges de calidad, detección de bucles, activity mode, extracción de decisiones.
• Smart Compaction: checkpoints progresivos por llenado y por caída de calidad, restauración tras compactar, digest de contexto.
• Continuidad: pistas entre sesiones, resume-lean, checkpoint scoring.
• Quality scoring S–F con 7 señales y barra de estado.
• Auditoría estructural: CLAUDE.md, skills, MCP y memoria, más memory-review.
• Base SQLite local (15 tablas entre DB por sesión y trends), sin telemetría.
• Progressive disclosure: resultados >4KB archivados, recuperables con expand.

Instalación en Hermes

git clone https://github.com/alexgreensh/token-optimizer.git
token-optimizer/install.sh --hermes

Según el README, aporta a Hermes compresión de salida de terminal, relecturas más baratas, avisos de bucle, checkpoints que sobreviven a la compactación, pistas de sesiones previas y dashboard, a través de los hooks de plugin de Hermes.

Por qué nos interesa

Nura corre en un VPS con contexto largo y sesiones que se compactan; el wiki se mantiene en sesiones con muchas lecturas de fichero repetidas. Los dos ejes que sí aplican aquí son relecturas delta/skeleton y checkpoint + digest tras compactación. La parte de dashboard y coach es Claude-only.

Riesgos

• Proyecto de un autor, sin auditoría externa; toda la evidencia de ahorro es autopublicada.
• El instalador engancha hooks en la configuración del agente: conviene leer qué escribe antes de ejecutarlo en el VPS y comprobar el desinstalador (docs/uninstall.md), que el README describe como limpio.
• No sustituye a la memoria del agente: la audita, no la reescribe.