Ahorra hasta un 60 % de tu factura de tokens

Tu contexto bajo control

Los equipos desperdician cerca del 40 % de su presupuesto de tokens en ruido: esquemas MCP sin usar, historial de chat fuera de tema, proyectos abandonados. tokenguard encuentra esas fugas y las elimina con un comando.

scan → mcp lazy → chats compact → budget. Sin cuenta, sin llamadas de red, MIT.

Probar en 30 seg → Ver qué encuentra

31 tests pasandoNode ≥ 20MIT LicenseCero telemetría

tokenguard — scan

$ tokenguard scan Harnesses & chats Harness Found Chats Size ──────────────── ───── ───── ─────── DeepSeek Harness yes 12 15.9 MB ℹ total sessions: 12 (15.9 MB) MCP Client Server Tools ~Tokens Verdict ────── ────── ───── ─────── ─────── DSH safari 2 ~221 lazy ✓ $ tokenguard chats drift --all OpenRouter Explorer Free 939 ≈2.1M split Digital twins 859 ≈1.8M split ⚠ 3 chats drifted — splitting recommended $ tokenguard mcp lazy safari --apply ✓ Lazy proxy: ~/.tokenguard/lazy/safari.cjs ✓ idle timeout: 10min $

−87% schema tokens

Proxy MCP perezoso

Costes de esquemas MCP hasta −90 %

Detector de deriva

Dónde dividir y cuánto ahorrar

Compactación

500 msgs → resumen + últimos 8

Presupuestos y perfil

Límites diarios y CI gate

8 integraciones

9 comandos

2.4B tokens analizados

~40 % del gasto es ruido

Probar en 30 seg →

Rápido · Seguro · Local · Abierto

Por qué lo instalan los equipos

Cada función cierra una fuga concreta

Dry-run por defecto. Nada cambia sin --apply, y antes se escribe una copia de seguridad.

Proxy MCP perezoso

Costes de esquemas MCP hasta un 90 % menos. El cliente ve 2 herramientas en vez de 50+; el upstream arranca en el primer call_tool y duerme si está inactivo.

Detector de deriva de tema

Señala el mensaje exacto donde la conversación se desvió y estima los tokens que recuperas abriendo un chat nuevo. Totalmente offline, sin LLM.

Compactación de chat

Comprime 500+ mensajes en un resumen estructurado — peticiones, archivos, comandos, temas clave — y mantiene los últimos 8 literales. Contexto limpio en un chat nuevo.

Perfilador de tokens y presupuestos

Gasto por día, sesión, herramienta y modelo. Fija un límite diario y deja que CI falle al excederse. Estimación en USD vía pricing.json.

Higiene de proyectos

Encuentra repos muertos e inacabados por métricas git y los archiva con git bundle + tar + manifiesto. Restauración con un solo clone.

Chequeo de documentación

Detecta enlaces rotos, versiones y puertos contradictorios, párrafos duplicados, fechas «actualizado el» obsoletas. La documentación vieja deja de quemar contexto.

Compatibilidad

Funciona con lo que ya usas

Chats, rename, configs MCP y proxies perezosos para todos los harnesses principales.

Harness	Chats	Rename	Config MCP	Lazy
DeepSeek Harness	Completo	Nativo	Perfiles YAML	Proxy + --apply
Claude Code	Lectura	—	~/.claude.json	Proxy
OpenAI Codex CLI	Mejor esfuerzo	—	config.toml	Proxy
Gemini CLI	—	—	settings.json	Proxy
Cursor	—	—	~/.cursor/mcp.json	Proxy
VS Code / Copilot	—	—	.vscode/mcp.json	Proxy
Claude Desktop	—	—	claude_desktop_config.json	Proxy

Empezar

Instala en 30 segundos

Node.js ≥ 20 o un binario listo. Sin cuenta, sin llamadas de red, licencia MIT.

terminal
 # global install
npm install -g tokenguard
tokenguard version

tokenguard 0.3.4

# first look at the environment
tokenguard scan 
 # isolated run
docker run --rm \
  -v ~/.tokenguard:/data \
  -v ~/.dsh:/dsh \
  tokenguard/tokenguard:latest scan

DeepSeek Harness  yes     12      15.9 MB 
 # prebuilt binary (Linux x64)
curl -fsSL https://github.com/tokenguard/tokenguard/releases/latest/download/tokenguard-linux-x64.tar.gz | tar xz
sudo mv tokenguard /usr/local/bin/

tokenguard version
tokenguard 0.3.4 
 # from source
git clone https://github.com/tokenguard/tokenguard.git
cd tokenguard && npm install
npm link

tokenguard scan 

FAQ

Preguntas y respuestas

¿Cuánto puedo ahorrar realmente?

Depende de tu configuración MCP. Los equipos con varios servidores MCP suelen obtener la mayor ganancia con el proxy perezoso: los esquemas de herramientas sin usar dejan de viajar en cada petición. Ejecuta tokenguard scan — informa tokens de esquemas y desperdicio estimado antes de cambiar nada.

¿Es seguro ejecutarlo en un entorno en uso?

Sí. Todo es dry-run por defecto, los cambios requieren --apply, se escribe una copia de seguridad antes de cualquier modificación, las sesiones modificadas en los últimos 2 minutos se omiten y no hay llamadas de red sin un flag explícito.

¿Qué harnesses están soportados?

DeepSeek Harness (completo: chats, rename, usage), Claude Code, OpenAI Codex CLI, Gemini CLI, Cursor, VS Code / Copilot y Claude Desktop para configs MCP.

¿Es gratis?

Sí — MIT, gratis para siempre. Está previsto un nivel Pro con dashboards de equipo, SSO y gateway MCP gestionado; el CLI seguirá siendo open source.

Empieza a ahorrar tokens hoy

Descubre tus fugas con un comando

Ejecuta tokenguard scan — informa a dónde van los tokens antes de cambiar nada.

Instalar tokenguard → Abrir en GitHub

Gratis y MIT. Pro (dashboards de equipo, SSO, gateway MCP) está en la hoja de ruta — el CLI seguirá siendo open source.