tmux on watch

Your terminal.
On your wrist.

Live tmux output on Apple Watch. ANSI colors. Instant notifications. One command to set up.

augustbenedikt — tmux a — 120×30
└─ [main ffed100] Tighten launch copy and watch preview for release
4 files changed, 42 insertions(+), 19 deletions(-)
To https://github.com/beneaug/tmuxonwatch.com.git
7759159..ffed100 main -> main
Release surface updated. The latest site preview now keeps the watch and terminal examples aligned with App Store-safe launch copy:
Clean terminal examples — no risky permission or brand callouts
Review-ready screenshots — focused on tmux output and watch display
Demo mode confirmed — reviewers can test without server setup
The updated build preview should be live on tmuxonwatch.com within a minute or two.
Release check finished in 3m 28s
How does this launch look? (optional)
1: Bad 2: Fine 3: Good 0: Dismiss
prepare the launch screenshots and verify the watch view matches the phone layout
►► live updates on (shift+tab to cycle)
01:2.1.49*
19:25
Apple Watch

Worked for 7m 31s

  [Image #17] [Image #18]

(↑ to select)

prepare the launch screenshots and verify the watch view matches the phone layout
►► live updates
on (shift+tab to cycle)

Setup

Three steps. Under a minute.

bash
$ brew install beneaug/tmuxonwatch/tmuxonwatch
$ tmuxonwatch-install
=> Checking prerequisites...
Found Python 3.12
Found tmux 3.4
Server running on port 8787
01

Install

Homebrew install, then run tmuxonwatch-install. Python venv, auth token, launchd service — all automatic.

iPhone

tmuxonwatch

QR Code

Point camera at QR code

02

Scan

The installer prints a QR code. Point your iPhone camera at it.

Apple Watch

Worked for 7m 31s

  [Image #17] [Image #18]

(↑ to select)

prepare the launch screenshots and verify the watch view matches the phone layout
►► live updates
on (shift+tab to cycle)
03

Watch

Your tmux sessions appear on your wrist in full color. That's it.

Install

Ready? One command.

Works on local network and trusted VPN setups

Requires macOS, Python 3.10+, and tmux