muxplex

A web-based dashboard for tmux sessions. Access and manage all your tmux sessions from any device — browser, phone, tablet.

Features

• Live tile grid showing all running tmux sessions
• Click any session to open a full interactive terminal
• Bell/activity notifications across sessions
• Multi-device support with state sync
• Mobile-friendly, responsive, PWA-capable
• Works over Tailscale private network

Stack

• Backend: Python FastAPI coordinator (coordinator/)
• Frontend: Vanilla JS + xterm.js (frontend/)
• Terminal: ttyd (WebSocket bridge to tmux)
• Proxy: Caddy

Running

# Install dependencies
pip install -r requirements.txt

# Start coordinator (from this directory)
python -m uvicorn coordinator.main:app --host 0.0.0.0 --port 8099

# Start Caddy proxy
caddy run --config Caddyfile

Development

# Run tests
python -m pytest

Brand assets

Design language, tokens, and brand assets in assets/branding/. To regenerate PNG/favicon assets from SVG sources:

python3 scripts/render-brand-assets.py