[01]
Start it on the pane you want
Right-click a pane, choose Control remotely. Lume starts a small web server on your machine and shows a QR code. Nothing is sent anywhere yet.
$ local by default · no account · no app to install
Control your terminal
from your phone.
Lume serves a page from your own machine. Scan the code and the session you already have open is in your hand — same scrollback, same working directory, same running process.
01 HOW IT WORKS
Three steps, no configuration.
[02]
Scan it — once
Your phone opens a page served by your machine and pairs itself: no app store, no account, no code to type. Next time it reconnects without the QR code.
[03]
Type
You are in the same session, not a new one. A Termux-style key row gives you Ctrl, Esc, Tab and the arrows; directory completion and swipe-to-move-cursor are there too.
02 TWO WAYS TO REACH IT
Your network, or anywhere — your call.
The difference matters, so here it is plainly.
same Wi-Fi — out of the box
Your phone talks straight to your machine over the local network. Nothing leaves your network, nothing transits a third party.
from anywhere — opt-in
Install cloudflared in one click and Lume opens a quick tunnel with each share, for a public HTTPS address. Rather stay on your network? Turn it off in Settings → Remote.
what protects it
Devices are paired, each with its own key, and revocable one by one. The session itself is end-to-end encrypted: your Wi-Fi and the tunnel only ever see ciphertext.
03 WHY IT EXISTS
For the build you walked away from.
long jobs
A migration, a release, a large test suite. Lume notifies you when a long command finishes; the phone lets you look at what it actually printed.
CLI agents
Agents pause to ask. Rather than losing twenty minutes because you left the desk, read the question and answer it from where you are.
not a replacement for SSH
This is for the machine on your desk that is already doing something. For a server you administer, SSH remains the right tool — and Lume has an SSH manager for that.
04 FAQ
Questions, answered.
? Does my terminal traffic go through anyone's servers?+
Not in a readable form. On your own network the phone talks straight to your machine. Through the optional cloudflared tunnel, traffic transits Cloudflare's edge — but the session is end-to-end encrypted between your device and your machine, so the tunnel only ever carries ciphertext. You stop the share whenever you want.
? Do I need an account or an app?+
Neither. The phone opens a web page served by your own machine. There is nothing to install on the phone and no account anywhere.
? Is it a new session, or the one I already had open?+
The one you already had open. It is the same PTY: same scrollback, same working directory, same running process. Type on the phone and the desktop window shows it immediately.
? How is access protected?+
By pairing. The QR code carries a one-time secret (single use, valid ten minutes) in the part of the URL browsers never send over the network. Scanning it registers that device with its own key; from then on it reconnects on its own. Every paired device is listed in Lume, where you can revoke it — its live connection is cut immediately — and stopping remote control disconnects everyone.
? Can I open it from my laptop instead of my phone?+
Yes — from any browser, or from another Lume: paste the pairing link into its palette (Connect to another Lume) and your desktop's terminal opens in a pane there. It reconnects by itself after a Wi-Fi switch or a restart, and you can switch between the desktop's terminals from the palette.
? How is this different from SSH or tmux?+
SSH gives you a shell; this gives you the session you are already in, from a browser, with no client to configure. It is not a replacement for SSH on a server — it is for the machine on your desk that is already doing something you want to keep an eye on.
# Remote control is one feature of Lume, an open-source terminal with command blocks, inline AI and split panes.