📉 Reducir el porcentaje usado

A medida que trabajas con OpenCode, el agente acumula contexto, conversaciones, archivos analizados y acciones realizadas.

Todo ese historial ocupa espacio dentro de la ventana de contexto del modelo y se refleja en el porcentaje de uso que aparece en la interfaz.

Aunque tener contexto es útil, también puede convertirse en un problema cuando la sesión crece demasiado.

🧠 ¿Qué significa el porcentaje de uso?

El porcentaje indica cuánto contexto está utilizando actualmente la sesión.

Por ejemplo:

6% significa que una pequeña parte del contexto está ocupada
50% indica que la sesión ya contiene bastante información acumulada
Porcentajes más altos implican un mayor consumo de tokens

Cuanto más crece ese porcentaje:

Más tokens consume cada interacción
Más información debe procesar el modelo
Más ruido puede introducirse en las respuestas

⚠️ Por qué conviene reducirlo

Cuando una sesión se vuelve muy larga, el modelo tiene que manejar una cantidad creciente de información.

Esto puede provocar varios efectos:

Mayor consumo de tokens
Costes más elevados
Respuestas menos precisas
Más dificultad para identificar la información realmente relevante

Por eso es recomendable limpiar o compactar sesiones largas cuando ya han acumulado suficiente historial.

🛠️ El comando `/compact`

OpenCode incorpora un comando específico para resolver este problema:

/compact

Este comando realiza una operación muy útil:

Compacta la sesión actual generando un resumen de todo el trabajo realizado hasta ese momento.

En lugar de conservar cada mensaje y cada acción del historial, el agente crea una representación resumida de la información importante.

📋 Qué ocurre durante la compactación

Al ejecutar el comando:

El agente analiza toda la sesión.
Identifica la información relevante.
Genera un resumen estructurado.
Elimina el historial detallado anterior.
Sustituye todo el contexto por ese resumen.

De esta forma se conserva el conocimiento importante sin mantener toda la conversación original.

📉 Reducción inmediata del contexto

En el ejemplo mostrado en la clase, la sesión estaba utilizando aproximadamente un 6% del contexto disponible.

Después de ejecutar /compact:

El agente generó el resumen.
Eliminó el historial anterior.
El porcentaje bajó al 3%.

Es decir, se redujo aproximadamente a la mitad.

Aunque el ejemplo utiliza valores pequeños, el efecto es mucho más relevante cuando trabajas durante largos periodos en proyectos complejos.

🧩 El nuevo contexto generado

Tras la compactación, OpenCode crea un nuevo contexto resumido.

Entre los elementos que suele conservar se encuentran:

Objetivos del proyecto
Restricciones existentes
Preferencias definidas
Progreso realizado
Tareas completadas
Información importante para continuar trabajando

Ese resumen se convierte en la nueva base de conocimiento del agente.

🤖 Cómo sigue funcionando el agente

Una vez finalizado el proceso, el agente continúa trabajando normalmente.

La diferencia es que ahora:

Tiene menos contexto que procesar
Consume menos tokens
Mantiene la información esencial
Puede seguir avanzando en el proyecto sin cargar todo el historial previo

Desde ese momento, el resumen generado pasa a ser el contexto principal utilizado por OpenCode.

🎯 Cuándo utilizar `/compact`

Es recomendable ejecutar este comando cuando:

Llevas mucho tiempo trabajando en una misma sesión
El porcentaje de contexto empieza a crecer demasiado
Quieres reducir el consumo de tokens
Notas que el agente está manejando demasiado historial

No es necesario usarlo constantemente, pero resulta muy útil en proyectos largos.

📌 Ideas clave de esta clase

Quédate con estos conceptos:

OpenCode acumula contexto durante toda la sesión
Cuanto más contexto exista, más tokens se consumen
Un exceso de información puede introducir ruido
El comando /compact permite reducir el contexto utilizado
La compactación genera un resumen automático
El historial anterior se reemplaza por información resumida
El agente mantiene los datos importantes para continuar trabajando
Reducir el contexto puede mejorar la eficiencia de la sesión

🚀 Mantén tus sesiones optimizadas

La capacidad de compactar sesiones es una de las herramientas más útiles para trabajar durante largos periodos con agentes de IA.

Utilizar /compact de forma estratégica te permitirá mantener proyectos extensos bajo control, reducir costes y asegurar que el agente siga centrándose en la información realmente importante.

💡 Tip: Si observas que el porcentaje de contexto sigue creciendo después de varias horas de trabajo, ejecuta /compact antes de que la sesión se vuelva demasiado grande. Mantendrás el rendimiento del agente sin perder la información esencial del proyecto.