Welcome

Pocketmux gives you secure access to your tmux terminal sessions from your phone. The pmux agent runs on your host machine as a transparent drop-in replacement for tmux, while the Pocketmux mobile app connects to it over an end-to-end encrypted WebRTC DataChannel. Terminal data flows directly between your devices -- the signaling server relays connection metadata only and never sees your terminal content.

How it works

1. Install pmux on your host machine.
2. Run pmux init to generate an Ed25519 identity keypair and configure the agent.
3. Run pmux pair to display a QR code. Scan it with the Pocketmux mobile app to pair your phone.
4. Use pmux exactly like tmux. Sessions are now accessible from your phone.

Key principles

• Transparent tmux proxy -- every command passes through unchanged to tmux -L pmux. Replace tmux with pmux in your workflow with zero learning curve.
• Dedicated socket -- pmux sessions are isolated from your regular tmux via the -L pmux socket. Your existing tmux sessions are unaffected.
• Zero-knowledge server -- the signaling relay handles connection setup and device pairings. It never sees terminal content, session metadata, or user activity.
• End-to-end encrypted -- all terminal data flows over peer-to-peer WebRTC DataChannels between your host and your phone.
• Ed25519 identity -- cryptographic device authentication with no passwords, no OAuth, and no accounts.
• Open source -- the agent and server are MIT licensed. The protocol is documented and the wire format uses MessagePack.

Quick example

pmux                          # start new session
pmux new-session -s work      # named session
pmux attach -t work           # attach to session
pmux ls                       # list sessions
pmux split-window -h          # split pane -- every tmux command works

Next steps

Get started by installing pmux.