Skip to main content

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.