Brian Krabach
23d1d9c113
Addresses code quality suggestion from review: requirements.txt was a redundant secondary source of truth. Dependencies are now exclusively managed in pyproject.toml with proper runtime/dev separation. - requirements.txt: replaced with a comment redirecting to pip install -e '[dev]' - README.md: updated install command from pip install -r requirements.txt to pip install -e '[dev]'
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 (runtime + dev)
pip install -e ".[dev]"
# 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