readsrc/lib/auth.ts
editsrc/lib/auth.ts
bashpnpm tsc --noEmit
→Refactorizando middleware
purplemux
/
for Claude Code
Claude Code, muchas sesiones, a la vez. Más rápido.
Un panel multi-sesión sobre tmux.
Navegador, móvil, terminal — un flujo de trabajo sin cortes.
$
npx purplemux
Descargar para macOS
Por qué purplemux
Cada sesión, en un solo panel.
Cuantas más sesiones, más difícil es seguir su estado.
purplemux reúne todas en una pantalla para que veas qué está corriendo y dónde hace falta tu input de un vistazo.
Tu cuota, en tiempo real.
Chocarse con un límite en plena concentración te corta el flujo. Mientras esperas al próximo reset, el trabajo se queda parado.
purplemux mantiene las cuotas de 5 horas y 7 días fijadas en la barra lateral. Los colores cambian al 50% y al 80%, para que marques el ritmo antes de chocar con la pared.
Panel multi-sesión
Ve el estado running / needs-input de cada sesión de Claude Code de un vistazo.
Refactor auth module
readsrc/lib/auth.ts
editsrc/lib/auth.ts
00:24
Vista de sesión en vivo
Progreso en timeline — ya no hay que hacer scroll por logs del CLI.
IN PROGRESS3
landing-copy
REVIEW2
fix-auth-bug
tsc-errors
DONE7
Sesiones por estado
Cada sesión se ordena automáticamente en Review · In Progress · Done.
term
diff
web
Guardar y restaurar workspaces
Al correr sobre tmux, las sesiones sobreviven al cierre del navegador. Layout de paneles, pestañas y rutas se restauran mañana con un clic.
src/lib/auth.ts
12
13
14
15
12
13
14
15
Visor de Git diff
Revisa diffs en un panel junto al terminal. Side-by-side o inline, con resaltado de sintaxis.
~/dev❯docker compose up
~/dev❯vim src/handler.ts
~/dev❯ssh prod.example.com
~/dev❯pnpm dev
Un terminal de verdad
No solo Claude. Un terminal completo con xterm.js + node-pty para vim, docker, ssh, REPLs — lo que quieras.
Móvil & push
Fuera del escritorio, igual.
No hace falta quedarte en el escritorio solo para vigilar una tarea larga. Ábrelo en el navegador del móvil, añádelo a la pantalla de inicio y funcionará como una app nativa. Cierra la pestaña y las notificaciones de fin de tarea / input pendiente siguen llegando por Web Push.
Añadir a la pantalla de inicio (PWA)
Ábrelo en el navegador y añádelo a la pantalla de inicio para tener un icono a pantalla completa.
iOS (Safari)
- Abre
http://<host>:8022en Safari - Toca el botón Compartir de abajo
- Elige Añadir a pantalla de inicio
- Toca Añadir arriba a la derecha
Android (Chrome)
- Abre la URL en Chrome
- Abre el menú ⋮ arriba a la derecha
- Elige Instalar app o Añadir a pantalla de inicio
Activar las notificaciones push
- Activa Settings → Notification → On y permite las notificaciones del navegador
- Llegan por Web Push incluso en segundo plano
- Alertas de tarea completada y input necesario
- Toca una notificación para saltar directo a la sesión
Acceso externo con Tailscale
Para acceder desde fuera de tu red, Tailscale Serve es la vía más limpia. Trae cifrado WireGuard y certificados HTTPS de regalo.
$ tailscale serve --bg 8022
Luego podrás llegar a https://<machine>.<tailnet>.ts.net desde cualquier sitio.
iOS Safari necesita HTTPS para que PWA y Web Push funcionen bien.
Estadísticas & análisis
Todo tu uso, en una pantalla.
Los tokens de hoy, el coste del mes, el uso por proyecto, el desglose por modelo — reunidos en un sitio para mostrarte el ritmo y la estructura de coste de tu trabajo.
01
Cuatro tarjetas de resumen
Sessions · Total · Today · Month
02
Tendencia diaria de actividad
Sesiones · mensajes de los últimos 30 días
03
Rachas de trabajo
Longest · Current · Count · Avg
04
Línea de tiempo semanal
Día × hora + sesiones simultáneas
Informe diario con IA
Tu día, resumido automáticamente.
Al terminar el día se recogen los logs de sesión y un LLM escribe un brief de una línea y un resumen detallado. Se guarda en Markdown — úsalo en retros, informes o 1:1 sin tocar nada.
2026-04-13 (Mon)
Redactada la primera versión de la landing de purplemux. Conectada la sección mobile / PWA con el dashboard de stats. Unificado el tono estilo Apple y reemplazados todos los mockups de feature cards.
∧ Collapse
purplemux
Borrador de la landing
- Diseñada la estructura de ocho secciones con layouts Hero / Why / Mobile / Stats
- Convertido el color de marca purple en una variable OKLCH
- Aplicados los marcos de mockup para las capturas de desktop y móvil
Mockups de feature cards
- Reproducidos indicadores reales de spinner / pulse en el panel multi-sesión
- Ajustados los detalles CSS de los mockups de Git Diff, workspace y self-hosted
- Añadida la animación del diagrama de acceso con Tailscale
Brief + detailed juntos
El brief de una línea vive en el dashboard; expande al detallado con un clic. Es Markdown — pégalo directo en una retro o un informe.
Batch & regenerar
Rellena los días que falten en un solo batch, o regenera cualquier día suelto. El LLM procesa sesión a sesión para no perder contexto.
Rápido, desde cualquier lado
Vive en la barra lateral como Notes y se abre con Cmd ⇧ E (macOS) / Ctrl ⇧ E (Linux).
Todo local — nada sale de tu máquina.
Funciones
Todo lo que necesitas. Ni más, ni menos.
Terminal
7
- Paneles divididosDivisiones horizontales · verticales, redimensionables con drag
- Gestión de pestañasVarias pestañas, reordenar, título automático por proceso
- AtajosDividir · cambiar pestaña · mover foco
- TemasOscuro / claro · varios sets de color
- WorkspacesGuardar / restaurar paneles · pestañas · rutas de trabajo
- Visor de Git diffSide-by-side · resaltado de sintaxis
- Panel de navegadorVista previa Electron integrada
Integración con Claude Code
10
- Estado en tiempo realIn progress / needs input, transiciones instantáneas
- Modo sesiones en la barra lateralAlterna Workspace ↔ Sessions, vistas por estado
- Vista de sesión en vivoMensajes · llamadas a herramientas · tareas · prompts de permiso
- Reanudar con un clicRetoma sesiones interrumpidas desde el navegador
- Restore automáticoRecupera sesiones previas al reiniciar el servidor
- Quick promptsRegistra favoritos y lánzalos con un clic
- Historial de mensajesReutiliza mensajes anteriores
- Analíticas de usoTokens · coste · por proyecto · informes diarios
- Cuenta atrás del rate limitResto de 5h / 7d · tiempo hasta el reset
- Avisos de uso del límiteLa barra cambia a amber / red al 50% / 80%
Móvil & accesibilidad
7
- UI responsiveTerminal · timeline en móviles y tablets
- PWAAñadir a la pantalla de inicio · sensación de app nativa
- Web PushNotificaciones aunque cierres la pestaña
- Sync multi-dispositivoCambios de workspace reflejados en tiempo real
- TailscaleAcceso externo HTTPS seguro
- Auth por contraseñaHashing con scrypt
- Idiomas한국어 · English · 日本語 · 中文 · 11 idiomas
Personalización
9
- TemasLight / Dark / System automático
- Tamaño de fuenteNormal · Large · X-Large
- Custom CSSOverride total vía variables CSS
- Temas de terminalSets de color independientes para light / dark
- Reordenar sidebarMostrar/ocultar items · arrastra para reordenar
- Biblioteca de quick promptsAñade prompts personalizados · drag para ordenar
- Integración con editorEditor externo vía URL de code-server
- Control de notificacionesNotificaciones del sistema on/off
- Opciones de ClaudeActiva opciones del CLI como skip permissions
Arquitectura
Navegador ↔ Node.js ↔ tmux · Claude Code.
xterm.js se conecta a node-pty por WebSocket, y node-pty se enlaza a una sesión tmux en el socket dedicado purple.
El estado lo siguen a la vez los hooks de Claude Code y un watcher de logs JSONL.
Browser
UI
xterm.js
Terminal
Timeline
events
Status
indicators
Multi‑device
sync
WebSocket
/terminal
/timeline
/status
/sync
Node.js Server
:8022
node-pty
Binary PTY ↔ WS
JSONL Watcher
file → parse → send
Status Manager
process tree + JSONL tail
Binary PTY · stdin/out binario
Hooks + polling 5–15s
Intercepción de permission prompts
1MB backpressure · 10 queue
spawn · read
System
local
tmux · purple socket
session 1
session 2
…
Socket purple aislado
Recuperación paralela tras reinicio
Claude Code
~/.claude/sessions/
~/.claude/projects/{id}.jsonl
vs. Remote Control oficial
Más allá del control remoto — un workspace unificado.
Remote Control oficial es una herramienta de acceso remoto para seguir una sesión de Claude Code desde otro dispositivo. purplemux añade encima panel multi-sesión, extensiones de terminal y analíticas de uso — un entorno operativo self-hosted.
| Aspecto | Remote Control oficial | purplemux |
|---|---|---|
| Vista de sesiones simultánea | Abres una a una desde una lista | Todas las sesiones y estados en un único panel |
| Indicadores de estado | Online / offline | Busy · Review · Needs-input · Idle en tiempo real |
| Notificaciones push | Requiere la app móvil de Claude | Web Push · cualquier navegador, sin instalar nada |
| Persistencia del terminal | Solo mientras el proceso claude está vivo | Basado en tmux · restore automático tras reinicio |
| Herramientas incluidas | Solo la sesión de Claude Code | Terminal dividido · Git diff · workspaces |
| Analíticas de uso | — | Tokens · coste · por proyecto · informe diario con IA |
| Puntos fuertes | Oficial de Anthropic · integración con Claude móvil · auto-update | OSS de terceros · instalación y mantenimiento manuales |
Instalar
30 segundos, de principio a fin.
Solo necesitas Node.js 20+ y tmux. Una línea para instalar y abrir el navegador.
1
Ejecutar
Arranca al momento con npx. También puedes instalarlo global.
$ npx purplemux
2
Abrir el navegador
Por defecto el puerto es 8022. Cámbialo con la variable PORT.
→ http://localhost:8022
3
Acceso remoto (opcional)
Para acceder desde fuera recomendamos Tailscale Serve. Cifrado WireGuard y certificados automáticos incluidos.
$ tailscale serve --bg 8022
4
App nativa (opcional)
En macOS puedes usar también el build Electron. Compatible con Apple Silicon e Intel.
Descargar la última release →FAQ
Lo que seguramente te preguntas.
¿Me ahorrará dinero?
Hace que tu uso sea transparente. Coste de hoy, del mes y por proyecto, desglose de tokens por modelo, resto de rate limit de 5h / 7d — todo en una pantalla para ajustar el gasto tú mismo.
¿Puedo aprobar permission prompts desde el móvil?
Sí. purplemux captura los diálogos de permiso de Claude Code del terminal y los envía al panel y a las notificaciones móviles. Aprobarlos desde cualquier sitio — adiós a las tareas en pausa.
¿Si el sistema se cuelga, pierdo las sesiones?
Cerrar el navegador o perder la red no es problema — tmux mantiene las sesiones vivas. Incluso tras un reinicio completo, purplemux escanea el layout del workspace y restaura las sesiones previas de Claude en paralelo. Sin restore manual.
¿Dónde se guardan mis datos?
Los ajustes y datos de sesión se guardan en local bajo ~/.purplemux/.
Nada se envía a servidores externos. La autenticación queda como hash scrypt en config.json.
¿Funciona en Windows?
Oficialmente no. Las restricciones de tmux y node-pty hacen que solo soportemos macOS y Linux. Puede funcionar bajo WSL2, pero no lo probamos.
¿Entra en conflicto con mis sesiones tmux?
purplemux lanza una instancia tmux aislada sobre un socket purple dedicado.
Es totalmente independiente de tus sesiones tmux y de ~/.tmux.conf.
¿Cómo accedo desde fuera de mi red?
Recomendamos Tailscale Serve — cifrado basado en WireGuard y certificados HTTPS automáticos.
Si prefieres un proxy inverso propio, asegúrate de reenviar los headers Upgrade y Connection en Nginx / Caddy.
¿Tiene algún coste?
purplemux es open source con licencia MIT y gratuito. El uso de Claude Code se factura aparte.
¿Es realmente usable en móvil?
Sí. UI responsive, PWA y Web Push ya vienen incluidos. Añádelo a la pantalla de inicio para tener sensación de app nativa; cierra la pestaña y seguirás recibiendo las notificaciones de fin de tarea e input necesario.
¿Está traducido?
11 idiomas disponibles: 한국어 · English · 日本語 · 简体中文 · 繁體中文 · Deutsch · Español · Français · Русский · Português (Brasil) · Türkçe.
Empezar
Una línea y listo.
Con Node.js 20+ y tmux listos, lo tienes funcionando en 30 segundos.
$
npx purplemux
Descargar para macOS
Self-hosted · código abierto
En tu máquina, tuyo.
purplemux es una herramienta self-hosted que corre localmente.
Datos de sesión, ajustes e historial viven únicamente en ~/.purplemux/ y nunca abandonan tu máquina.
El código está bajo MIT — léelo, modifícalo, contribuye.
MIT License
100% local
0 telemetría
~/.purplemux/
├─ config.json
├─ workspaces.json
└─ sessions/
MIT
local-only