Sesiones

Pi guarda conversaciones como sesiones para que puedas continuar trabajando, avanzar desde turnos anteriores y volver a visitar rutas anteriores.

Las sesiones se guardan automáticamente en ~/.pi/agent/sessions/, organizadas por directorio de trabajo. Cada sesión es un archivo JSONL con una estructura de árbol.

pi -c                  # Continue most recent session
pi -r                  # Browse and select from past sessions
pi --no-session        # Ephemeral mode; do not save
pi --name "my task"    # Set session display name at startup
pi --session <path|id> # Use a specific session file or partial session ID
pi --fork <path|id>    # Fork a session file or partial session ID into a new session

Utilice /session en modo interactivo para ver el archivo de sesión actual, el ID de sesión, el recuento de mensajes, los tokens y el costo.

Para el formato de archivo JSONL y SessionManager API, consulte Session Format.

/resume abre un selector de sesión interactivo para el proyecto actual. pi -r abre el mismo selector al inicio.

En el selector puedes:

• buscar escribiendo
• alternar visualización de ruta con Ctrl+P
• alternar el modo de clasificación con Ctrl+S
• filtrar a sesiones con nombre con Ctrl+N
• cambiar el nombre con Ctrl+R
• eliminar con Ctrl+D, luego confirmar

Cuando está disponible, pi usa trash CLI para eliminar en lugar de eliminar archivos permanentemente.

Utilice /name <name> para establecer un nombre de sesión legible por humanos:

/name Refactor auth module

Establezca el nombre al inicio con --name o -n:

pi --name "Refactor auth module"
pi --name "CI audit" -p "Review this build failure"

Las sesiones con nombre son más fáciles de encontrar en /resume y pi -r.

Las sesiones se almacenan como árboles. Cada entrada tiene un id y un parentId, y la posición actual es la hoja activa. /tree te permite saltar a cualquier punto anterior y continuar desde allí sin crear un archivo nuevo.

Forma de ejemplo:

├─ user: "Hello, can you help..."
│  └─ assistant: "Of course! I can..."
│     ├─ user: "Let's try approach A..."
│     │  └─ assistant: "For approach A..."
│     │     └─ user: "That worked..."  ← active
│     └─ user: "Actually, approach B..."
│        └─ assistant: "For approach B..."

Los modos de filtro son: predeterminado, sin herramientas, solo para usuario, solo con etiquetas y todos. Configure el valor predeterminado con treeFilterMode en Settings.

Seleccionar un usuario o mensaje personalizado:

1. Mueve la hoja al padre del mensaje seleccionado.
2. Coloca el texto del mensaje seleccionado en el editor.
3. Le permite editar y volver a enviar, creando una nueva rama.

Seleccionar un asistente, herramienta, compactación u otra entrada que no sea de usuario:

1. Mueve la hoja a esa entrada.
2. Deja el editor vacío.
3. Le permite continuar desde ese punto.

Al seleccionar el mensaje del usuario raíz, la hoja se restablece a una conversación vacía y se coloca el mensaje original en el editor.

Utilice /tree cuando desee mantener las alternativas juntas. Utilice /fork o /clone cuando desee un archivo de sesión independiente.

Cuando /tree cambia de una rama a otra, pi puede resumir la rama abandonada y adjuntar ese resumen en la nueva posición. Esto preserva el contexto importante del camino que dejaste sin volver a reproducir toda la rama.

Cuando se le solicite, elija uno de:

1. sin resumen
2. resumir con el mensaje predeterminado
3. resumir con instrucciones de enfoque personalizadas

Consulte Compaction para ver branch summarization partes internas y ganchos de extensión.

Los archivos de sesión son JSONL y contienen entradas de mensajes, cambios de modelo, cambios de nivel de pensamiento, etiquetas, compactaciones, resúmenes de ramas y entradas de extensión.

Para analizadores, extensiones, uso de SDK y el SessionManager completo API, consulte Session Format.