MOSHLINE
Host Helper quick setup + terminal-only fallback

Install Moshline Host Helper, then scan one QR.

The stable GitHub quick-setup URL installs a versioned, SHA-256-verified Host Helper. It configures SSH, Mosh, a persistent local service, and supported coding-agent hooks used by Inbox, approvals, and Usages.

Mac setup

The install script and versioned Host Helper package are published from NomadShell/Scripts on GitHub.

  • Run quick setup; it installs SSH/Mosh prerequisites and the verified Moshline Host Helper package.
  • If using SSH key auth, keep using NOMAD_PUBKEY_B64; the legacy variable remains supported.
  • Scan the Host Helper QR, then run moshline-host doctor to verify the daemon and agent hooks.
  • Keep SSH and Host Helper port 24000 reachable on your trusted network; allow UDP 60000-61000 for Mosh.
  • For the previous terminal-only QR flow, run the MOSHLINE_TERMINAL_ONLY=1 command. Inbox and Usages require Host Helper.
$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)"
$MOSHLINE_TERMINAL_ONLY=1 bash -c "$(curl -fsSL https://raw.githubusercontent.com/NomadShell/Scripts/main/quick-setup.sh)"

iOS setup

Pair Host Helper first, then connect and verify the agent surfaces you need.

  • Open Moshline and scan the Host Helper QR from Add Server.
  • Pick authentication: Secure Enclave SSH key (recommended) or password.
  • Open Inbox after running a supported coding agent to confirm its lifecycle events arrive.
  • Open Usages only after Codex emits verified usage data; a terminal connection alone cannot provide it.
  • If a surface is missing, run moshline-host doctor on the paired host before reconnecting.
A paired Host Helper proves connectivity, but Usages stays unavailable until Codex reports verified usage. Other providers remain empty in this release.

Finish the coding-agent loop

Trust the Codex hook

After Host Helper setup, start Codex interactively, run /hooks, review the Moshline command, and trust its current definition. Codex skips new or changed non-managed hooks until you approve their exact hash.

Verify push delivery

Scan the Host Helper QR, allow notifications, then open Settings → Agent Setup in Moshline and send Test Webhook. Pairing connects this iPhone’s private webhook destination to the host.

Codex usage is provider-reported

Moshline reads verified token and rate-limit data exposed by Codex transcripts. It never estimates usage from terminal activity. Other providers and stale data stay empty.