Mac + iOS setup
Set up Nomad Shell in two passes.
Mac side handles Mosh, Tailscale, and tmux persistence. iOS side registers the secure key and connects with voice + macro controls.
Mac setup
Prepare the machine your agents run on.
- Install mosh, tmux, and tailscale on your Mac.
- Enable Remote Login (SSH) and add your Nomad Shell public key.
- Start a tmux session: tmux new -A -s nomad_session.
- (Optional) Run tailscale up and use the 100.x IP in Nomad Shell.
- (Optional) Set up the webhook endpoint for approval notifications.
$ brew install mosh tmux tailscale
$ sudo systemsetup -setremotelogin on
$ tailscale up
iOS setup
Connect, register keys, and enable voice.
- Install Nomad Shell and allow microphone + Face ID permissions.
- Add a new host with IP (or Tailscale IP), username, and key tag.
- Connect once to register the Secure Enclave SSH key.
- Use the Macro Deck for tmux keys and long‑press PTT for voice input.
- Paste the webhook token into CLAUDE.md to enable approvals.
Tip: use the Halo Bar status (green/amber/red) to track agent state at a glance.