muxdeck
muxdeck es una aplicación web de un solo archivo que permite crear, gestionar e interactuar con sesiones de tmux desde el navegador.
Ficha actualizada 23 sept 2026, 1:56 · upstream 23 sept 2026, 1:44 · release v0.14.12
Qué es muxdeck
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
muxdeck es una herramienta web completa para la gestión de sesiones de tmux a través del navegador. Ofrece una terminal completa en pantalla mediante WebSocket integrado con xterm.js, permitiendo múltiples observadores por sesión. Incluye funciones como crear, eliminar y renombrar sesiones, seguimiento de ramas Git (incluyendo estado dirty), monitoreo de puertos activos, soporte para copiar/cortar texto entre tmux y sistema, y un modo mouse configurable por paneo. La aplicación es resiliente ante desconexiones con reintentos automáticos y cuenta con una interfaz PWA para dispositivos móviles.
- Monitorear múltiples sesiones de desarrollo simultáneamente en el mismo terminal
- Gestionar sesiones tmux desde un navegador sin necesidad de abrir la terminal
- Verificar estado de procesos, puertos y ramas Git de forma rápida
- Copiar texto seleccionado entre tmux y sistema mediante clipboard integrado
- Crear sesiones tmux con detección automática de dirty branches y puertos activos
- Usar el navegador como terminal sin instalar tmux en la máquina local
- Single-binary architecture: todo el frontend está embebido, no requiere dependencias externas ni compilación adicional
- Full tmux integration: permite crear sesiones reales, usar comandos tmux (attach, kill, rename) y acceder a su terminal
- Git branch tracking: cada sesión muestra la rama actual y detecta cuando el tree está dirty
- Clipboard synchronization: selecciona texto en tmux y copia al sistema o viceversa con un solo clic
- Resilient connection handling: si se cae la conexión WebSocket, la app reintentará automáticamente con backoff
- Split view support: permite visualizar dos sesiones lado a lado en pantallas anchas mediante el hash del enlace
- No soporta múltiples paneos simultáneos (solo un terminal por sesión)
- La conexión WebSocket requiere que la máquina local tenga tmux instalado
- El modo mouse está limitado a sesiones creadas por muxdeck y no se puede activar en paneos existentes
- La API de SSH no está soportada directamente, solo el protocolo de attach estándar
- No tiene soporte nativo para SSH sessions (solo tmux)
- En entornos de producción sin HTTPS, la autenticación por token es opcional y se genera dinámicamente
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.
muxdeck es un servidor HTTP simple que puede desplegarse en cualquier entorno. Para uso local: ejecuta ./muxdeck desde el directorio raíz. Para redes privadas (VPN, WireGuard), usa `-token` o `-no-auth`. Para TLS, añade `-tls-cert cert.pem -tls-key key.pem`. En entornos de supervisión (systemd, launchd), crea un unit con `Environment=MUXDECK_ADDR=0.0.0.0:8300 MUXDECK_TOKEN=...` y `ExecStart=/usr/local/bin/muxdeck`. Para PWA en iOS/Android, usa HTTPS o localhost para que funcione el service worker.
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.