@pandi-coding-agent/pandi-session

Extensión de Pi que agrega un dashboard /sessions independiente para descubrir sesiones Pandi locales por proyecto.

Packages

Package details

extension

Install @pandi-coding-agent/pandi-session from npm and Pi will load the resources declared by the package manifest.

npm repo home report

$ pi install npm:@pandi-coding-agent/pandi-session

Package: @pandi-coding-agent/pandi-session
Version: 0.2.4
Published: Jul 11, 2026
Downloads: 379/mo · 332/wk
Author: andrestobelem
License: MIT
Types: extension
Size: 33.3 KB
Dependencies: 0 dependencies · 2 peers

Pi manifest JSON

{
  "extensions": [
    "./index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pandi-session

En 30 segundos

pandi-session agrega /sessions: un menú al estilo /workflow para abrir un dashboard TUI propio, listar las sesiones Pi vivas de este proyecto, detectar registros stale y cambiar a otra sesión cuando Pi expone ctx.switchSession.

Es independiente del runtime de workflows. Por ahora vive como una superficie separada; cualquier consolidación futura se decidirá con evidencia después.

Uso

Comando	Qué hace
`/sessions`	En UI abre un menú interactivo; en headless imprime la lista textual.
`/sessions dashboard`	Abre el dashboard TUI si hay UI; en modo headless imprime la lista textual.
`/sessions list`	Imprime la lista textual de sesiones del proyecto.
`/sessions cleanup`	Limpia registros stale seguros; con UI pide confirmación y en headless requiere `--yes`.
`/sessions cleanup --dry-run`	Lista cada archivo con acción (`delete`/`keep`) y razón, sin borrar nada.
`/sessions cleanup --all-stale --yes`	También permite borrar heartbeats stale con PID vivo; nunca borra la sesión actual.

Teclas del dashboard

Tecla	Acción
`↑` / `↓` o `k` / `j`	Cambia la selección.
`Enter` / `→`	Cambia a la sesión seleccionada si hay transcript y `ctx.switchSession`.
`C`	Limpia registros stale con confirmación cuando hay UI.
`q` / `Esc`	Cierra el dashboard.

Modelo de datos

La extensión escribe heartbeats propios en .pi/pandi-session/live/ para proyectos trusted; fuera de un proyecto trusted usa el directorio global del agente, separado por hash de cwd.

Cada registro incluye pid, mode, cwd, timestamps, metadata de sessionManager y flags livianos (trusted, idle). Una sesión se considera live cuando el PID existe y el heartbeat sigue fresco.

Instalación independiente

pi install ./extensions/pandi-session

El paquete publica sus archivos TypeScript de primer nivel y no depende de otros paquetes de este monorepo en runtime.

Nota: Pi ya tiene un comando interactivo integrado llamado /session; por eso esta extensión usa el plural /sessions para no pisarlo.