plumichat
Aplicación web auto-alojada que permite controlar sesiones de Claude Code desde dispositivos móviles, con streaming en tiempo real, gestión de permisos táctil y sandboxing de dos capas para miembros. No requiere base de datos ni compilación, ejecuta Node 22+.
Ficha actualizada 22 sept 2026, 18:18 · upstream 22 sept 2026, 16:44 · release sin release detectada
Qué es plumichat
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
PlumiChat es una aplicación web auto-alojada diseñada específicamente para controlar sesiones de agentic coding desde dispositivos móviles, particularmente optimizada para funcionar como PWA en iPhones con conexiones inestables. La aplicación conecta directamente con el SDK del agente de Claude, proporcionando streaming de salida en tiempo real, llamadas a herramientas, aprobaciones de permisos y un terminal real, manteniendo todo el trabajo ejecutándose localmente en la máquina del usuario.
La arquitectura se basa en Express con Node 22 y módulos ES nativos sin transpilación, utilizando el SDK @anthropic-ai/claude-agent-sdk que incluye su propia CLI. El frontend es vanilla ES modules servidos directamente desde un directorio public sin bundler. La persistencia utiliza JSONL de las sesiones del SDK y un almacén JSON atómico pequeño, sin base de datos tradicional.
La aplicación implementa Web Push nativo usando solo node:crypto para notificaciones en pantalla bloqueada, gestión de cuentas con autenticación por email/PIN y WebAuthn, y sandboxing mediante bubblewrap/seatbelt en Linux/macOS. Incluye capacidades de exportación a formatos documentales, navegador de archivos y memoria opcional a través de Supermemory.
- Control móvil de sesiones de codificación con Claude Code desde iPhone sin necesidad de teclado físico
- Gestión de permisos de herramientas mediante tarjetas táctiles con opciones de permitir siempre/una vez/denegar
- Terminal persistente en tmux que sobrevive a reinicios del servidor con copia de texto optimizada para móviles
- Notificaciones Web Push que llegan incluso cuando el teléfono está bloqueado o sin conexión Wi-Fi
- Gestión de múltiples conversaciones con vista dividida y memoria opcional entre sesiones mediante Supermemory
- Exportación de respuestas a formatos .docx, .pptx, .xlsx y .pdf para compartir resultados
- Implementación nativa de Web Push RFC 8291+8292 con node:crypto que permite notificaciones en pantalla bloqueada
- Sandboxing de dos capas independientes (SDK canUseTool policy + OS sandbox) para miembros con fail-closed
- Arquitectura sin base de datos usando JSONL del SDK y almacén JSON atómico para persistencia ligera
- Optimización específica para conexiones móviles inestables con turns que sobreviven a pérdida de conexión
- Terminal real sobre WebSocket dentro de tmux que mantiene sesiones activas tras reinicios del servidor
- Gestión de cuentas con roles (owner/admin/member), invitaciones únicas caducables y WebAuthn passkeys
- Windows no soporta sandboxing para miembros, rechazando automáticamente las sesiones de miembros en lugar de ejecutarlas sin confinamiento
- Sin framework de testing formal, solo harness de caracterización para operations.js y node --check como gate de sintaxis
- Sin rate limiting, fail2ban o WAF integrados - diseñado exclusivamente para despliegue personal no público
- Rewind solo funciona con turns ejecutados después de habilitar file checkpointing, reportando 'no file checkpoint' para conversaciones antiguas
- Sister apps reciben la cookie de sesión cruda (no scoped por puerto), documentado como intencional pero sin corrección
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.
Requiere Node 22.9+ con npm install y npm start. Necesita ANTHROPIC_API_KEY o CLI firmado en suscripción Claude. Portos: 3002 (chat), 6767 (WebSocket terminal), 8085 (API). No exponer a internet público sin autenticación - bind por defecto a 127.0.0.1. Generar VAPID keypair para Web Push en primer uso. Windows requiere instalación como owner-only. Linux/macOS soportados completamente, Windows con limitaciones de sandboxing y GPU/temperatura.
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.