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.

The other direction too: when Claude makes something to look at — a chart, a diagram, an HTML report — drop it in ~/.tmux-next/gallery and it shows up under Artifacts, so you can see it on your phone without moving files to another machine. Images render in a grid; HTML and SVG render in place, sandboxed.

Smaller things add up: rename a session in place, size the text by hand or pinch to zoom, and the list keeps the session you were just in on top. Scrolling a program's history works the moment you reconnect.

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