Al cerrar una jornada intensa de depuración asistida por IA y revisar la factura de la API, ¿alguna vez ha comprobado cuánto presupuesto se destinó a cortesías innecesarias en lugar de código útil? Los agentes modernos repiten saludos largos, matizan conclusiones obvias y reenvían cientos de líneas de registros de terminal en cada iteración del bucle.
Caveman es una habilidad de código abierto y un proxy local creado por Julius Brussee bajo el lema "why use many token when few token do trick". Comprime respuestas conversacionales y salidas extensas de herramientas en agentes de programación, mantiene intactos código, rutas y errores, y permite recuperar el texto original desde SQLite cuando hace falta.
Importante
- Recuperación local sin pérdidas: Las salidas extensas comprimidas por el proxy reciben identificadores direccionados por contenido (
ccr_...) guardados en una base SQLite local (~/.caveman/ccr.db), permitiendo al agente restaurar el texto original exacto mediante MCP. - Transparencia sobre el ahorro del 65%: Los responsables del proyecto reportan cerca de un 65% menos de tokens en pruebas de prosa, mientras que un estudio independiente de JetBrains (julio de 2026 en SkillsBench) midió un 8,5% real en tareas completas de programación; Kling Digital no ha ejecutado pruebas de laboratorio propias sobre esa cifra.
- Fidelidad exacta del código: La compresión elimina relleno conversacional y ruido repetitivo de logs, sin modificar jamás bloques de código, comandos de terminal ni trazas de error.
Para equipos técnicos que diseñan soluciones de inteligencia artificial en producción, el gasto descontrolado de tokens afecta de forma directa al margen operativo. Incluso cuando la dirección técnica estima el presupuesto inicial con una calculadora de costos, el crecimiento silencioso de la ventana de contexto durante ciclos prolongados de pruebas suele convertirse en el mayor desvío financiero. Esa presión en las facturas de API explica por qué Caveman se propagó con tanta rapidez entre desarrolladores.
Por qué Caveman ganó tracción tan rápido entre desarrolladores
A finales de 2026, agentes como Claude Code, Codex CLI, Cursor, Windsurf, OpenCode y Gemini CLI dejaron de actuar como simples asistentes de autocompletado para ejecutar bucles autónomos de decenas de pasos. Resolver un fallo complejo implica leer múltiples archivos, lanzar suites de pruebas, inspeccionar salidas de compilación y reinyectar gran parte de ese historial en cada llamada al modelo.
Como los modelos de lenguaje están alineados para conversar con cortesía humana, envuelven diagnósticos directos en párrafos innecesarios. Explicar un re-renderizado en React puede consumir 69 tokens de prosa habitual, mientras que la causa raíz técnica cabe en 19 tokens: "New object ref each render. Inline object prop = new ref = re-render. Wrap in useMemo."
Dentro de las tendencias del ecosistema abierto de agentes IA de noviembre de 2026, Caveman puso sobre la mesa la disciplina de higiene de contexto. No obstante, evaluar su utilidad real exige diferenciar su capa inicial de instrucciones de su arquitectura más madura basada en proxy local.
Arquitectura de dos capas: habilidad "Say Less" y proxy local "Read Less"
Lo que comenzó como una regla de sistema ligera evolucionó hacia una pila de dos capas que optimiza tanto lo que el modelo escribe como lo que lee en cada turno.
1. Capa de compresión de salida (Habilidad y niveles de intensidad)
La habilidad principal caveman se publica bajo licencia MIT e instruye al agente para omitir introducciones amables, adverbios vacíos y artículos prescindibles, protegiendo estrictamente bloques de código, comandos y rutas de archivo.
El desarrollador puede ajustar el nivel de concisión en cualquier momento de la sesión mediante comandos rápidos:
/caveman lite: Suprime cortesías y muletillas conservando frases legibles (la documentación cita alrededor de un 30% de reducción en prosa)./caveman(modofullpredeterminado): Aplica el estilo telegráfico estándar donde los mantenedores reportan cerca de un 65% menos de tokens en texto explicativo./caveman ultra: Nivel máximo de síntesis, eliminando encabezados secundarios y transiciones (los autores señalan rangos del 75% al 80% en explicaciones)./caveman off: Restaura al instante la redacción natural, indispensable al redactar descripciones de pull requests, registros de arquitectura o documentación para clientes.
2. Capa de compresión de entrada y recuperación reversible (caveman-proxy)
En proyectos reales, el grueso de la factura no proviene de las respuestas del modelo, sino de los tokens de entrada acumulados: registros extensos de pruebas, respuestas JSON voluminosas y trazas repetitivas que viajan al proveedor en cada turno. El proxy local (caveman start o caveman wrap, con componentes de motor distribuidos bajo BSL-1.1 / Apache-2.0 según el paquete) intercepta el tráfico local entre el agente y la API para compactar ese ruido antes del envío.
Lo más valioso del diseño es que evita el truncamiento ciego mediante un almacén de recuperación direccionado por contenido:
- Cuando el proxy elide o compacta una salida extensa, conserva íntegros los códigos de salida, rutas y tipos de error, sustituyendo el bloque repetitivo por un identificador único (
ccr_...occr://). - En el mismo instante, guarda los bytes originales sin comprimir en una base SQLite local acotada (
~/.caveman/ccr.db) junto con metadatos y marcas temporales. - Si el agente detecta que necesita inspeccionar una línea exacta omitida en el resumen, invoca la herramienta local de Model Context Protocol (MCP) llamada
caveman_retrievecon dicho identificador. El proxy devuelve el texto original exacto desde el disco local, sin depender de almacenamiento externo en la nube.
Consejo
Si archivos estáticos de contexto como CLAUDE.md consumen miles de tokens al inicio de cada sesión, el comando /caveman-compress los compacta automáticamente y guarda una copia legible de respaldo fuera del repositorio en $XDG_DATA_HOME/caveman-compress/backups/.
Lectura honesta de la cifra del 65% de reducción de tokens
Un análisis técnico serio debe separar los benchmarks publicados por los autores de las evaluaciones independientes en cargas de trabajo reales. Los responsables de Caveman indican reducciones cercanas al 65% en pruebas centradas en respuestas textuales y preguntas técnicas breves. Con total rigor metodológico, desde Kling Digital confirmamos que no hemos ejecutado pruebas internas propias para certificar ese porcentaje; debe interpretarse como la métrica reportada por los creadores del proyecto y no como un recorte automático garantizado en cualquier factura.
En julio de 2026, JetBrains publicó una evaluación A/B independiente de la habilidad Caveman sobre SkillsBench, ejecutando cientos de tareas reales de programación de largo recorrido. Sus resultados aclararon dos puntos fundamentales:
- En programación real, la habilidad por sí sola ahorró un 8,5% de salida: En tareas de código complejas, la mayor parte de la salida del agente corresponde a código fuente, parches diff y parámetros de herramientas que Caveman protege acertadamente sin comprimir. Por ello, la caída global de tokens de salida fue del 8,5% y no del 65%.
- Sin degradación medible de calidad: Las pruebas de JetBrains confirmaron que obligar al agente a responder en estilo telegráfico no redujo de forma estadísticamente significativa la tasa de acierto técnico (p = 0,82).
Precisamente esa evidencia impulsó la evolución hacia el proxy local (caveman-proxy) enfocado en los tokens de entrada. Las mediciones posteriores compartidas por el proyecto sobre la canalización con proxy reportan alrededor de un 33,2% menos de tokens de entrada facturados por el proveedor en sesiones con salidas extensas, sin comprometer la precisión. La conclusión práctica es clara: acortar la prosa ayuda, pero la verdadera palanca de ahorro está en comprimir de forma reversible las entradas repetitivas.
Comparativa de estrategias para reducir el gasto de tokens
Ninguna herramienta resuelve por sí sola todo el problema del consumo de contexto. Esta tabla resume cómo encaja cada capa de Caveman frente a flujos convencionales y memoria persistente:
| Enfoque | Objetivo principal | Impacto reportado / medido | Recuperación del original | Integridad del código | Escenario recomendado |
|---|---|---|---|---|---|
| Agente estándar sin filtros | Ninguno (flujo bruto) | Línea base (0%) | Siempre sin comprimir | Completa | Formación, documentos para clientes y especificaciones |
| Caveman Skill (capa de prompt) | Prosa de salida del modelo | Autores: ~65% en prosa; JetBrains: ~8,5% en código real | Cambio instantáneo con /caveman off | Código y rutas exactos | Depuración interactiva y consultas técnicas breves |
Caveman Proxy (caveman-proxy) | Logs de herramientas, tests y JSON | Pruebas del proyecto: ~33,2% menos tokens de entrada | Restauración total vía ccr_... y caveman_retrieve MCP | Errores y rutas exactos | Monorepos grandes con ciclos intensivos de pruebas |
Memoria persistente (claude-mem) | Contexto repetido entre sesiones | Carga progresiva en 3 capas desde índice ligero | Consulta selectiva con timeline y get_observations | Referencias íntegras | Desarrollo de funcionalidades a lo largo de varios días |
Mientras Caveman recorta el desperdicio dentro de una sesión activa, combinarlo con la capa que analizamos en la guía de memoria persistente con claude-mem evita además que el agente pierda tiempo y tokens releyendo el repositorio desde cero al abrir una sesión nueva.
Instalación y configuración del proxy local
Desde el repositorio oficial JuliusBrussee/caveman es posible instalar únicamente la habilidad MIT o desplegar la pila completa con CLI y proxy local:
npx skills add JuliusBrussee/caveman -g
npx @caveman-ai/cli@latest
caveman tools config path
caveman-proxy recovery-store status
La configuración global reside en ~/.caveman-cloud/config.json y las reglas por repositorio en ./.caveman/config.json:
{
"mode": "full",
"proxy": {
"enabled": true,
"preserveCodeBlocks": true,
"recoveryStore": "~/.caveman/ccr.db",
"maxStoreSizeMb": 256
},
"mcp": {
"retrieveTool": "caveman_retrieve"
}
}
Advertencia
Seguridad de secretos y licencias: Como caveman-proxy intercepta peticiones locales y guarda salidas en ~/.caveman/ccr.db, evite imprimir claves API o datos regulados por consola y limite la retención en disco. Antes de redistribuir el motor proxy comercialmente, valide los términos BSL-1.1 con su equipo legal.
Cuándo conviene adoptarlo en equipos de ingeniería
En proyectos de desarrollo de software, Caveman aporta mayor valor aplicado con criterio:
- Actívelo en ciclos repetitivos: Fallos de CI, suites de pruebas extensas y búsquedas en monorepos aprovechan de inmediato la elisión reversible de logs.
- Desactívelo (
/caveman off) para entregables humanos: Al redactar RFCs, auditorías de seguridad o documentación para clientes, el matiz discursivo pesa más que el ahorro de tokens. - Mida con telemetría propia: Registre una semana de consumo base antes de activar la habilidad y el proxy por fases.
Consulte también nuestra guía de arquitectura e instalación de REA MCP. Para estructurar agentes de programación auditables y con control de costos, escríbanos desde la página de contacto de Kling Digital.




