Mobile companion
nodeterm mobile is an iOS companion app. It attaches to the terminal sessions running on your desktop and lets you check in on them from your phone — watch an agent, read output, type a reply — without the canvas.
What it is
Section titled “What it is”The iOS app (built in SwiftUI) connects to your desktop’s core and attaches to its tmux sessions over the same transport protocol the rest of nodeterm speaks. Your sessions keep running on the desktop; the phone is a second window onto them. Because it attaches to live tmux sessions, a terminal you open on the phone is the same session you have on the desktop — not a separate copy.
Pairing
Section titled “Pairing”Pair the phone from the desktop app with a QR code: the app shows a code, you scan it, and the two are connected.
- On the same network, the phone reaches your desktop directly.
- Off-network, the connection runs end-to-end encrypted through a relay, so you can reach your sessions from anywhere. Relay connections count against your quota on the free tier — see Relay quota & Pro. Local-network connections never do.
What you can do
Section titled “What you can do”The phone’s surface is terminals — there is no canvas on a phone. You:
- Attach to sessions — open any of your desktop terminals and see its live output.
- Watch agents — follow an agent working in a session, and see when it needs you.
- Type — send input to a session, so you can nudge an agent or run a command on the go.
Because the phone attaches to tmux sessions rather than mirroring the canvas, canvas-only concepts — group frames, node layout, worktree bindings — don’t appear on it; the sessions themselves are all reachable.