Run your first session

Connect

Tap a saved connection on the home screen. If you used Easy Pair, the connection is already saved with the generated key. If the connection uses any private key or saved password, Moshi reads the credential from secure storage and starts the session. If biometric checks are enabled, iOS prompts before Moshi uses the credential.

The terminal opens directly into the remote shell. From there, run your normal tools:

$tmux new -s work
$cd ~/projects/my-app
$claude

Use the toolbar

The terminal toolbar provides common keys and actions that are awkward on a software keyboard: Enter, Backspace, paste, shortcuts, command history, keyboard toggle, and movement controls. You can customize the toolbar later in Settings -> Input.

If you use a hardware keyboard, Moshi supports app-level shortcuts such as command-key session switching and paste.

Switch away safely

Moshi keeps active sessions in the app. With mosh and tmux, the remote work continues even if:

• The phone locks.
• The app is backgrounded.
• The device changes networks.
• The terminal view reconnects later.

For long-running agent work, tmux is still recommended. tmux keeps the shell and agent process alive on the host even if the mobile terminal disconnects.

Add notifications

There are two notification paths:

• Push notifications can be sent by webhooks or agent events.
• Agent hooks let supported CLIs send approval and completion events through moshi-hook.

Enable push notifications first, then pair moshi-hook from Settings -> Agent Hooks if you want the inbox and Live Activity features. This token pairing is separate from Easy Pair, which only sets up SSH/Mosh host access.

Verify the setup

Run a small agent or shell task, lock the device briefly, then reopen Moshi. A good first-session setup should reconnect to the same terminal or tmux session without restarting the remote process.