NOMAD SHELL
Quick setup + manual fallback

Set up Nomad Shell with script + QR.

Implemented flow: run quick-setup on your host, scan QR in the iOS app, then connect over Mosh using a Secure Enclave key or password.

Get TestFlight

Mac setup

Prepare the server with the same script path used by the app.

  • Run quick-setup and let it install/configure SSH + mosh prerequisites.
  • If using SSH key auth, include your authorized_keys line in the setup flow.
  • Keep SSH port reachable and allow UDP 60000-61000 for Mosh traffic.
  • Use the QR output from setup to import host/user/port into Nomad Shell.
$curl -fsSL https://raw.githubusercontent.com/NomadShell/Scripts/main/quick-setup.sh | bash
$NOMAD_PUBKEY_B64='<base64-authorized-key-line>' bash -c "$(curl -fsSL https://raw.githubusercontent.com/NomadShell/Scripts/main/quick-setup.sh)"

iOS setup

Scan, authenticate, connect, and validate notifications.

  • Open Nomad Shell and choose Add Server -> Scan QR.
  • Pick authentication: Secure Enclave SSH key (recommended) or password.
  • If using key auth, copy the generated key line into ~/.ssh/authorized_keys.
  • Connect and use Halo Bar to monitor session state.
  • Open Settings -> Webhook Command, copy it to your agent workflow, then run Test Webhook.
Tip: swipe gestures and pinch-to-zoom are available in terminal view, and Halo Bar colors map to run/approval/error states.