tmux-next EN · 中文 · Manual · 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.

Typing a prompt on a phone is the slow part, so you can dictate one instead. Tap the microphone and a panel takes the keyboard's place; what you say piles up in an editable draft — say a sentence, fix the name it misheard, say the next — and one tap sends the lot. It needs a recognition key of your own, and stays hidden until you set one.

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.

It also tracks the Jira ticket a session is for, not just the session itself. One ticket can have several sessions; its PRs, checks, and status show up on the ticket's own card, and that status moves forward on its own as PRs open, checks go green, and branches merge. See what's new for how that grew out of typing ticket keys into session names.

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. The simplest way to reach it from your phone is Tailscale — your own devices only, with nothing exposed to the public internet. For a public URL with a login instead, the Caddy guide walks through a working setup.

GitHub npm Manual What's new Tailscale Caddy