tmux-next EN · 中文 · GitHub

tmux, from your phone

A small web client for tmux. It lists the sessions running on your machine and lets you open any of them in a browser. I wrote it to check on Claude Code from my phone without walking back to the laptop.

The session list: three sessions, each with its last few lines; one has a green dot. — The session list. Each session shows its last few lines. When Claude finishes a turn and is waiting on you, that session gets a green dot and sorts to the top, so you don't have to open each one to check.

A single session full-screen, with a small keyboard toolbar at the bottom. — A session, full screen. The keys a phone keyboard doesn't have (Esc, Ctrl, the arrows) are in a bar along the bottom.

When I'm working with Claude in a session I often want to show it a screenshot. So there's an image button in that bottom bar — pick a photo or paste one, and its saved path drops into the prompt, which is how the tools running here read an image. You can also select terminal text to copy it, on the phone or the desktop.

Install

You need tmux 3.2 or newer and Bun.

$ bunx tmux-next

It serves on http://127.0.0.1:7682 and lists the tmux sessions on the machine.

It has no login of its own, and binds to localhost only. To reach it from your phone you need a reverse proxy in front doing HTTPS and a login — otherwise you're putting a shell on the open internet. The Caddy guide walks through a working setup.

GitHub npm Deploy guide