pmux — Pocketmux Agent

pmux is a transparent drop-in replacement for tmux that makes your terminal sessions accessible from your phone. Replace tmux with pmux in your workflow — every command works identically, but sessions are automatically accessible from the Pocketmux mobile app over an encrypted peer-to-peer connection.

pmux new-session -s work      # just like tmux, but now accessible from your phone
pmux attach -t work
pmux ls

Highlights

• Drop-in tmux replacement — all tmux commands pass through unchanged via a dedicated socket (-L pmux)
• Peer-to-peer encrypted — terminal data flows directly between host and phone over WebRTC DataChannels; the signaling server never sees your content
• Zero-knowledge architecture — the server only relays connection metadata, never terminal data or session information
• Ed25519 identity — no passwords, no accounts; cryptographic keypair generated locally at setup
• QR code pairing — scan once from the mobile app to establish a secure link
• OS service integration — runs as a launchd (macOS) or systemd (Linux) service with automatic restart
• Cross-platform — macOS (universal binary) and Linux (amd64, arm64)

Install

# Homebrew
brew install shiftinbits/tap/pmux

Pre-built binaries and DEB/RPM/Snap packages are available on GitHub Releases.

Getting Started

pmux init     # generate identity, install service
pmux pair     # scan the QR code with the Pocketmux app
pmux          # start a session — it's now on your phone

Documentation

Full documentation is available at docs.pmux.io:

• Installation — platform-specific setup instructions
• Initialization — first-time setup walkthrough
• Pairing — connecting your mobile device
• CLI Reference — all commands and options
• Configuration — config file, environment variables
• Architecture — how it all works under the hood

License

MIT — see LICENSE