roost
Roost es una herramienta de escritorio en el navegador para gestionar sesiones de shell. Utiliza un proceso independiente (PTY) que no se detiene al cerrar pestañas, reiniciar el backend o perder conexión. Incluye IA local a través del CLI integrado.
Ficha actualizada 23 sept 2026, 14:08 · upstream 23 sept 2026, 13:41 · release v0.0.9
Qué es roost
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Roost permite administrar sesiones de shell desde la interfaz web sin depender de tmux tradicional. Su diseño centralizado evita que las ventanas del navegador afecten la terminal y viceversa. La arquitectura separa claramente entre el frontend (frontend/), el backend (backend/) y el proceso del PTY (terminal-daemon). El sistema soporta múltiples sesiones concurrentes, cada una con su propio estado de flujo de escritura, permitiendo escribir en diferentes terminales sin interferencia.
- Gestionar múltiples sesiones de shell simultáneamente desde un solo navegador
- Soportar entornos donde tmux no es disponible o no funciona correctamente
- Permitir que el usuario cambie de terminal sin perder el contexto del flujo de escritura
- Integración con agentes de IA como Claude Code, Codex, Gemini CLI y OpenCode
- Gestión de sesiones en entornos de producción donde tmux puede fallar o no ser adecuado
- Soporta múltiples sesiones concurrentes sin interferencia entre ellas
- Permite escribir en diferentes terminales simultáneamente con flujo de escritura independiente
- Incluye IA local a través del CLI integrado (Claude Code, Codex, Gemini CLI, OpenCode)
- Soporta edición molecular (.mol/.sdf) directamente desde el navegador
- Soporta visualización y edición de archivos PDF, Markdown y 3D
- Permite capturar y visualizar gráficos como imágenes o diagramas
- No es un servicio en la nube ni tiene autenticación multi-tenencia
- La seguridad depende del usuario: el password está en ~/.roost/auth-password (0600)
- El backend no está diseñado para exposición pública directa sin proxy seguro
- Soporta solo Node.js ≥ 22.13.0 como mínimo
- No tiene soporte nativo para bases de datos externas ni persistencia de datos en disco
- La autenticación es local y no se soporta OAuth o credenciales de terceros
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Para usar Roost, necesitas Node.js ≥ 22.13.0. Instala el proyecto con npm ci y luego ejecuta npm start para abrir http://localhost:5173. La primera vez que inicies, se generará un password en ~/.roost/auth-password. Para ejecutar como servicio persistente, instala Caddy y usa npm run service:install (http://localhost:8080). El proceso del PTY está en com.roost.terminal, el backend en com.roost.backend y la web en com.roost.web. No se recomienda usar systemd para Linux ya que puede causar problemas con sudo o no encontrar el backend. Para producción, usa npm run build --workspace frontend y npm run publish.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.