vmux
Apps

All vmux Apps

Manuals for every vmux app across visionOS, macOS, iOS, tvOS, watchOS, and CLI.

Overview

vmux is a family of apps that work together. The visionOS app is the flagship — a spatial SSH workspace built for Apple Vision Pro. Companion apps extend that workspace to other Apple platforms (Mac, iPhone, Apple TV, Apple Watch) and provide the supporting infrastructure that makes secure remote work practical: an SSH agent, a hardware-backed remote signer, a custom keyboard, home-screen widgets, a Live Activity, and a CLI daemon. Pick the apps that match your devices and workflow — most users start with one and grow into the rest.

By platform

visionOS

AppWhat it doesManual
vmuxThe flagship spatial SSH terminal. Open as many translucent terminal windows as you need, place them around your room, and connect each one to a different host. Eye-tracking focus, Optic ID lock, and a Metal-rendered terminal that feels native to visionOS.visionOS manual

macOS

AppWhat it doesManual
vmuxMacNative Mac terminal app that shares profiles, themes, and saved hosts with the rest of the family. Sandboxed and ready for the Mac App Store, with a familiar menu bar and standard window chrome.vmuxMac
vmuxAgentA menu bar SSH agent that turns your iPhone into a hardware-backed signer for any SSH client on your Mac. Forwards signing requests to RemoteSignerPhone over Multipeer Connectivity.vmuxAgent
MacKeyHostLets your Apple Vision Pro drive your Mac as if it were a wireless keyboard and mouse. Useful when you want to keep your hands free or work on the Mac from across the room.MacKeyHost

iOS

AppWhat it doesManual
vmuxPhoneThe iPhone terminal. Has its own SSH stack, an embedded keyboard tuned for terminal use, voice input, and Face ID lock. Works standalone or paired with vmuxWatch.vmuxPhone
RemoteSignerPhoneHolds Secure Enclave SSH keys on your iPhone and signs authentication challenges with Face ID or Touch ID. The phone-side half of vmuxAgent.RemoteSignerPhone
vmuxKeyboardExtensionA system-wide custom keyboard with terminal-friendly keys (arrows, Tab, Esc, Ctrl, function keys, common shell symbols) for use anywhere iOS lets you type.Keyboard extension
vmuxWidgetsHome-screen and Lock Screen widgets showing recent hosts, session status, and one-tap connections.Widgets
Live ActivityA Dynamic Island and Lock Screen indicator for active SSH sessions: connection state, host name, and quick actions while a session is running.Live Activity

tvOS

AppWhat it doesManual
vmuxTVRead-only session viewer for the living room. Pair it with your iPhone or Mac to follow long-running jobs, dashboards, or logs on the big screen.vmuxTV

watchOS

AppWhat it doesManual
vmuxWatchA wrist companion to vmuxPhone. View the list of active sessions, see snapshots of the last screenful from each, and get tap notifications when something noteworthy happens. Read-only by design.vmuxWatch

CLI

AppWhat it doesManual
vmux + vmuxd daemonRun vmux from any terminal, attach and detach panes, and keep sessions alive in the background. The daemon multiplexes panes much like tmux but speaks the vmux protocol that the spatial and mobile apps already understand.The daemon

How they fit together

The pieces stack into a few common shapes. On visionOS you typically connect to remote hosts via SSH. If you want hardware-backed key storage, your Vision Pro (or Mac) talks to vmuxAgent on your Mac, which forwards signing requests to RemoteSignerPhone on your iPhone — keys stay in the iPhone's Secure Enclave and you approve every signature with Face ID. MacKeyHost goes the other direction: your Vision Pro drives the Mac, useful for keeping a Mac visible inside an immersive space. On iOS, vmuxPhone runs SSH on its own and pairs with vmuxWatch for at-a-glance status; the keyboard extension, widgets, and Live Activity ride alongside. The daemon keeps long-running panes alive on a server or workstation so the GUI apps can attach and detach without losing state.

Vision Pro  --SSH-->  remote host
     |
     +-- (signing) --> Mac (vmuxAgent) --MPC--> iPhone (RemoteSignerPhone, Secure Enclave)
     |
     +-- (control) --> Mac (MacKeyHost)

iPhone (vmuxPhone) --SSH--> remote host
                        \--> Watch (vmuxWatch, read-only)

Any terminal --> vmuxd daemon --> attached panes

Where to start

  • If you have a Vision Pro, start at the main docs and connect your first host.
  • If you want hardware-backed SSH on your Mac, set up vmuxAgent together with RemoteSignerPhone.
  • If you live in the terminal, see the daemon and pair the CLI with whichever GUI app fits the device you carry.
  • If you want a phone-only workflow, start with vmuxPhone and add vmuxWatch once you're settled.