Sesiones e historial

Como funcionan las sesiones

Cada vez que usa YeePilot, su conversacion se guarda automaticamente como una sesion. Las sesiones capturan sus prompts, respuestas de la IA, planes de comandos, decisiones de aprobacion y salida de ejecucion. Nunca necesita guardar manualmente -- sucede en segundo plano.

Cuando inicia YeePilot, retoma su sesion mas reciente. Si prefiere comenzar de cero, use el comando /new.

Gestionar sesiones

Crear una nueva sesion

> /new

Esto crea una sesion nueva con un historial de conversacion limpio. Su sesion anterior se conserva y puede retomarse despues.

Listar todas las sesiones

> /sessions

Esto muestra una lista de sus sesiones guardadas con sus nombres, fechas de creacion y conteos de mensajes. Seleccione una sesion de la lista para cambiar a ella.

Sessions:
  1. nginx-troubleshooting     (12 messages, 2h ago)
  2. database-migration        (8 messages, yesterday)
  3. firewall-setup            (23 messages, 3 days ago)
 
Switch to: _

Renombrar una sesion

Por defecto, las sesiones se nombran automaticamente. Delelas nombres significativos para encontrarlas despues:

> /rename nginx-troubleshooting

Tambien puede renombrar sin argumentos para que se le solicite un nombre:

> /rename
Enter new name: prod-server-audit

Exportar una sesion

Exporte la sesion actual como una transcripcion de texto plano:

> /export

Esto guarda la conversacion completa -- sus prompts, respuestas de la IA, comandos propuestos y salida de ejecucion -- como un archivo de texto legible. Las exportaciones son utiles para documentacion, informes de incidentes o para compartir con colegas.

Gestion de la ventana de contexto

Los modelos de IA tienen una ventana de contexto limitada -- la cantidad de texto que pueden considerar a la vez. A medida que su conversacion crece, se acerca a este limite. YeePilot maneja esto automaticamente a traves de la compactacion de contexto.

Como funciona la compactacion

Cuando la ventana de contexto alcanza aproximadamente el 80% de capacidad, YeePilot activa la compactacion automatica:

1. Se selecciona el 80% mas antiguo de los mensajes en la conversacion
2. Estos mensajes se resumen en un resumen conciso
3. El resumen reemplaza los mensajes originales
4. El 20% mas reciente de los mensajes permanece intacto

Este proceso es transparente. No necesita tomar ninguna accion, y la conversacion continua normalmente. La IA retiene el contexto esencial de la parte anterior de la conversacion mientras libera espacio para nuevas interacciones.

Que preserva la compactacion

El resumen retiene:

• Decisiones clave y resultados
• Rutas de archivos importantes y valores de configuracion
• Mensajes de error y sus resoluciones
• El objetivo general de la sesion

Lo que se pierde naturalmente:

• Salida exacta de comandos del inicio de la sesion
• Pasos intermedios detallados
• Comandos exploratorios que no llevaron a nada

Si necesita hacer referencia a la salida exacta de una parte anterior de una sesion larga, considere exportar la sesion antes de que ocurra la compactacion, o inicie una nueva sesion para la siguiente tarea.

Seguimiento de tokens

YeePilot rastrea el uso de tokens para cada sesion, brindandole visibilidad sobre el consumo de API y los costos.

Ver el uso de tokens

Presione Ctrl+S durante una sesion para ver el panel de estadisticas, que incluye:

• Tokens de prompt -- tokens enviados a la IA (sus mensajes mas el contexto)
• Tokens de respuesta -- tokens generados por la IA
• Total de tokens -- uso combinado para la sesion
• Costo estimado -- calculado a partir del precio por token de su modelo

Entender los costos de tokens

El uso de tokens varia significativamente segun:

• Longitud de la conversacion -- sesiones mas largas usan mas tokens por mensaje porque el historial completo se envia como contexto
• Modo agente -- las tareas de multiples pasos consumen mas tokens debido al contexto repetido y las llamadas a herramientas
• Modo de pensamiento -- niveles de pensamiento mas altos usan mas tokens de respuesta
• Contexto de archivos -- los archivos cargados con /file se suman al conteo de tokens de prompt

Mantener los costos bajos

• Use modelos gratuitos de OpenRouter para tareas rutinarias
• Inicie nuevas sesiones con /new en lugar de continuar conversaciones muy largas
• Elimine archivos del contexto con /unfile cuando ya no se necesiten
• Use modos de pensamiento mas bajos (/think low) para tareas sencillas
• Monitoree el uso con Ctrl+S periodicamente

Almacenamiento de sesiones

Las sesiones se almacenan localmente en ~/.yeepilot/sessions/. Cada sesion es un archivo JSON que contiene el historial completo de la conversacion y metadatos. Estos archivos solo son accesibles para su cuenta de usuario.

Las sesiones nunca se envian a los servidores de YeePilot. Permanecen completamente en su maquina. Los unicos datos que salen de su sistema son los que envia a su proveedor de IA elegido como parte del flujo normal de prompt/respuesta.

Flujos de trabajo practicos

Sesiones basadas en tareas

Cree una nueva sesion para cada tarea distinta:

> /new
> /rename firewall-audit-2026-02
> Check all iptables rules and identify any overly permissive entries

Esto mantiene sus sesiones organizadas y las hace faciles de encontrar despues.

Respuesta a incidentes

Durante un incidente, la sesion se convierte en un registro en tiempo real de su investigacion:

1. Inicie una nueva sesion: /new
2. Nombrela: /rename incident-2026-02-27-api-outage
3. Trabaje en el diagnostico con YeePilot
4. Exporte cuando se resuelva: /export

La transcripcion exportada sirve como un informe de incidente que muestra exactamente que se verifico, que se encontro y que acciones se tomaron.

Retomar trabajo

Volviendo a una tarea al dia siguiente:

> /sessions

Seleccione la sesion relevante. La IA tiene el contexto completo de la conversacion y puede continuar donde lo dejo.