Roost: Una barra lateral binaria de un solo Go para Claude Code con historial de prompts enlazables, árbol de archivos y notificaciones

Un desarrollador creó Roost para abordar tres carencias al usar Claude Code sobre SSH mediante tmux: historial de prompts cliqueable, un árbol de archivos para reducir el uso de cat y notificaciones push cuando Claude está esperando. Es un único binario Go que sirve una interfaz web en 127.0.0.1:8080 diseñada para túneles SSH.

Características principales

• Terminal xterm.js respaldado por tmux: Sobrevive a desconexiones WebSocket, suspensión y reinicios del servidor. Cada sesión es tmux new-session -A -s {id}.
• Árbol de archivos: Previsualiza archivos, carga por arrastrar y soltar, y sigue automáticamente tu directorio actual leyendo pane_current_path de tmux, sin necesidad de integración con el shell.
• Panel de actividad: Lee ~/.claude/projects/*.jsonl y muestra cada prompt. Haz clic en un prompt y el terminal se desplaza hasta ese turno.
• Indicadores en la barra superior: Muestran el modelo activo y los tokens de contexto más recientes.
• Notificaciones push: Usa el hook Stop de Claude Code para notificar a tu portátil cuando Claude queda inactivo, incluso si la pestaña está en segundo plano.

Decisiones de diseño

• tmux como capa de durabilidad: El shell sobrevive a desconexiones y reinicios porque tmux maneja la persistencia de la sesión. Roost solo posee un puente WebSocket y un registro de disco de solo añadidura.
• Un solo usuario por instancia: Sin cuentas ni RBAC. Dos personas compartiendo un host ejecutan roost serve en diferentes puertos. Los UIDs de UNIX manejan el aislamiento; los proxies inversos manejan la autenticación multiinquilino.
• JavaScript vanilla, sin paso de compilación: El frontend consiste en archivos <script> simples incrustados mediante //go:embed all:web. Sin empaquetador: más fácil de depurar y distribuir.

Corrección de error notable

display-message -p '#{x}\x1f#{y}' de tmux devuelve 0x1f como un guion bajo literal cuando se lanza sin una configuración regional UTF-8 (por ejemplo, desde unidades systemd). La corrección de una línea: tmux -u. Si canalizas tmux a través de separadores de campo, fija la configuración regional.

Compatibilidad

Validado en servidor Linux + Chrome en Windows mediante túnel SSH. macOS como servidor funciona, pero tiene asperezas. Las sesiones de Codex funcionan si intercambias agentes. Repositorio: github.com/liamsysmind/roost. Tarballs v0.1.0 en github.com/liamsysmind/roost/releases/tag/v0.1.0.