Handmux

🌐 English  ·  🇨🇳 中文

handmux.com
One phone, a whole mobile vibe-coding cockpit. Built on tmux — one command on your computer, scan a QR, and your live session, Claude Code, Codex, git, previews and docs are all in your hand, creativity ready wherever you are.

handmux puts the *same live tmux workspace* from your computer in any phone or desktop browser. Keep coding with Claude Code, Codex, Pi, or any terminal tool; review changes, answer prompts, preview apps, and move files without starting a separate remote session. It is self-hosted, open-source, and needs no phone app or handmux account.

    

  Real phone browser, real panes — say what you need and Claude Code writes it, then tap a filename to preview (left); a push pings you when needed, and you review the git repo & each agent's usage (right).

📖 Docs · 🧭 Roadmap · 📝 Changelog · 📦 npm

Quick start · about a minute

Your computer needs tmux and Node ≥ 22.16; the phone just needs a browser. Pick one:

Homebrew — macOS (recommended) · installs Node + tmux for you:

npm — any platform · if you already have Node:

Then run it:

start prints a QR code (plus a URL and token). Scan it with your phone — the token rides in the code, so you're signed in on first open. You'll see your real tmux session; tap one and start driving.

Want to reach it from anywhere? Add one flag for a free public HTTPS link:
Tunnel types, self-hosting, Windows/WSL2, and the full command & flag reference → see the docs.

Why handmux

- 🧶 One workspace, everywhere. Your phone drives the real tmux panes already running on your computer—not a screenshot or a separate cloud session.
- 🔔 Stop babysitting agents. See which panes are working or waiting, get notified when you are needed, and approve from your phone.
-…