Get Moshi
guide

What Moshi does

Moshi is a mobile terminal for long-running coding agents, shells, and tmux sessions on a machine you already control.

updated 2 days ago2 min readpage 1 / 23

What a baby monitor is to a sleeping kid, Moshi is to your AI agents.

Moshi gives your phone or tablet a real terminal into a machine you already use for development. Start Claude Code, Codex, OpenCode, Gemini, Cursor, Kimi, Qwen, or a normal shell on your host, then watch, answer, and steer it from iOS or Android without keeping a laptop open.

What you can do from your phone

  • Operate agents remotely. Drive Claude Code, Codex, OpenCode, Gemini, Cursor, Kimi, or Qwen on your Mac, Linux box, VPS, or homelab from a real terminal — not a screenshot of one.
  • Answer their requests. Approvals, prompts, and "are you sure" questions land in the inbox, on the lock screen, and in the Live Activity. One tap to allow, deny, or read first.
  • Understand what's happening. Live Activities show the active turn; the inbox shows tool runs and turn completions; quota and token usage are visible in Settings so you know what's burning.
  • Run on impulse. Caught between meetings, in a cab, on a walk — kick off a refactor, ask a question, fix a typo. The session stays alive until you come back.
  • Talk to it. Dictation works with Apple's on-device SpeechAnalyzer, local Whisper, or a hosted cloud engine. Chat mode composes prompts before sending; command mode types straight into the shell. See Voice and dictation.
  • Send images directly. Paste a screenshot, photo, or clipboard image into a prompt. The agent gets a fetchable URL — no scp, no temp files on the host. See Image paste.
  • Type, the way phones make hard. A terminal toolbar, custom shortcuts, a D-pad, and full hardware-keyboard support exist so a phone keyboard never gets in the way.

What Moshi does not host

Moshi does not run your code in Moshi's cloud and does not replace your agent CLI. Your shell, repos, SSH config, mosh server, tmux sessions, and agent subscriptions stay on your own machine.

model

Think of Moshi as the mobile control surface. The compute, tools, git credentials, and agent processes remain on the host you connect to.

Main parts of the app

Home shows saved connections and active sessions. A saved connection stores host, port, username, auth mode, transport preference, and optional mosh or SSH routing settings.

Terminal is the live session view. It includes scrollback, reconnect behavior, paste controls, the keyboard toolbar, dictation, image paste/upload, and session switching.

Inbox shows agent events from moshi-hook: approvals, session starts, tool activity, and turn completion. The same events can update Live Activities and push notifications.

Settings controls terminal appearance, input behavior, notifications, agent hooks, file sharing, biometric prompts, iCloud sync, language, and Pro-only personalization options.

Recommended setup

For the most reliable experience:

  1. Install mosh and tmux on the host.
  2. Add a Moshi connection using SSH key auth.
  3. Use tmux as the long-lived workspace.
  4. Enable push notifications.
  5. Install moshi-hook on the host if you use coding agents.

That setup lets the terminal survive network changes, lets your agent keep running when the app is backgrounded, and gives Moshi enough context to notify you when attention is needed.