# moshterm > moshterm is a free Mosh, Eternal Terminal and SSH terminal for iPhone, iPad and Android, built for the coding agents you leave running in tmux, Zellij or Herdr on your own computer. Connect to your own Mac, Linux box, WSL or VPS over Mosh, Eternal Terminal or SSH. A small companion on that computer, moshterm-hook, adds lock-screen approvals, an Inbox of which sessions need you, and Chat View, with managed hooks for Claude Code, Codex and seven other agents. There is no account. Everything except live previews is free; moshterm Pro adds those. Source: https://moshterm.com/facts (checked 2026-11-20). ## At a glance - Name: moshterm - What it is: moshterm is a free Mosh, Eternal Terminal and SSH terminal for iPhone, iPad and Android, built for the coding agents you leave running in tmux, Zellij or Herdr on your own computer. - Price: Free. The optional moshterm Pro subscription adds live previews. - Account: None - Phones: iOS 18 or later (iPhone and iPad); Android 8 or later - Computers: macOS, Linux or WSL for the companion; any SSH server for the terminal on its own - Google Play: Available since 2026-11-20: https://play.google.com/store/apps/details?id=dev.moshterm.android - App Store: Coming soon - App languages: 15: English, Deutsch, Español, Français, Italiano, 日本語, 한국어, Nederlands, Polski, Português (Brasil), Русский, Svenska, Українська, 简体中文, 繁體中文 - Agents with managed hooks: Claude Code, Codex, OpenCode, Cursor, Grok Build, Kimi Code, Hermes, Pi, OMP - Multiplexers: tmux, Zellij, Herdr - Publisher: Micktron LLC, support@micktron.dev ## Connections - Transports: Mosh, Eternal Terminal and SSH, all built into the app. Auto tries Mosh, then Eternal Terminal, then SSH. - Hosts: Unlimited saved hosts and sessions at the same time. - SSH keys: Passwords and SSH keys are stored in the iOS Keychain or Android Keystore and can be locked behind biometrics. - Host keys: Trust on first use; a changed host key stops the connection until you decide. - Jump hosts: Connect through another saved host first. SSH agent forwarding is a per-host switch. - Cloudflare Tunnel: Connect to a host published through a Cloudflare Tunnel, or use the tunnel only when the direct address can't be reached. Through a tunnel the session runs over SSH, because Mosh needs UDP. - Security keys: YubiKey PIV keys for SSH on iPhone and iPad. - Staying connected: Mosh roams across networks. If iOS or Android ends the app, opening it again returns you to the session you left. ## Sessions - Multiplexers: On connect, moshterm lists the host's tmux, Zellij and Herdr sessions; pick one to attach. - Jump To: Move between windows and tabs. In tmux it moves only your phone's client. - Keyboard: A key bar with Esc, Tab, Ctrl, arrows and the running agent's own keys; custom shortcuts; hardware keyboards. - Dictation: The system speech recognizer, or a cloud service with an API key you bring. ## Coding agents - Companion: moshterm-hook runs as your user on macOS, Linux or WSL, listens only on 127.0.0.1, and is reached through the phone's own SSH connection. The app can install and update it over that connection. - Managed hooks: Claude Code, Codex, OpenCode, Cursor, Grok Build, Kimi Code, Hermes, Pi and OMP. - Approvals: An agent's permission prompt arrives on the phone with the command it wants to run. Approve asks you to unlock first. No limit on approvals. - Inbox: Every paired computer's agent sessions, sorted into Needs you, Working and Done, one row per session. - Chat View: The agent's transcript, read on your computer and shown as a conversation. Prompts you send go to the same pane. - Lock Screen: On iPhone a working agent shows as a Live Activity. - Code review: Git diffs and a file browser for the folder the terminal is in; paste images and attach files to the host. ## Privacy - Terminal traffic: Goes directly between your phone and your computer. It never passes through moshterm's servers. - Optional relay: Push notifications and the offline Inbox use moshterm's relay. Inbox snapshots and approval decisions are encrypted before they leave your devices. - Delete my data: Settings → Privacy & data → Delete my data removes relay records and shared files. It does not cancel a subscription. ## moshterm Pro Everything above is free, with no account, no counters and no trial timer. moshterm Pro is an optional subscription that adds: - Browser preview: your agent's dev server, opened in the app. - Simulator and device preview: the app your agent is building, mirrored to your phone. - Per week: $1.99 - Per month: $5.99 - Per year: $49.99 (eligible first-time subscribers get 14 days free) US prices; your store shows yours. Billed by Apple or Google and cancelled there. Pro never takes anything away from Free. ## Questions ### Is moshterm free? Yes. Mosh, Eternal Terminal, SSH, unlimited hosts, tmux, Zellij and Herdr reattach, agent approvals, the Inbox, Chat View and diffs are free, with no account and no trial timer. The optional moshterm Pro subscription adds live previews of dev servers and simulators. ### Do I need an account? No. The app connects straight to your own computers. There is nothing to sign up for. ### Which coding agents does it work with? The companion installs hooks for Claude Code, Codex, OpenCode, Cursor, Grok Build, Kimi Code, Hermes, Pi and OMP. Any other program still runs in the terminal as usual. ### Does my terminal session pass through moshterm's servers? No. What you type and see goes directly between your phone and your computer. Only optional push notifications and the offline Inbox use the relay. ### Is there an iPhone app? The iPhone and iPad app is coming soon to the App Store. The Android app is on Google Play now. ## A free Mosh client for iPhone, iPad and Android https://moshterm.com/mosh-client moshterm is a Mosh client for iPhone, iPad and Android, and it is free with no account. Install mosh-server on your computer, let UDP ports 60000–61000 through, and connect. The session survives network changes and a locked phone. If the host has no mosh-server, moshterm tries Eternal Terminal, then SSH. ### Set up the host Mosh signs in over SSH, then moves the session to UDP. The computer needs mosh-server. Add tmux too, so the session keeps running while your phone is away. macOS (Homebrew): ```sh brew install mosh tmux ``` Debian, Ubuntu, WSL: ```sh sudo apt install mosh tmux ``` both should print a path: ```sh command -v mosh-server tmux ``` ### Let the UDP ports through mosh-server picks a UDP port between 60000 and 61000 for each session. If the host has a firewall, open that range. ufw (Ubuntu, Debian): ```sh sudo ufw allow 60000:61000/udp ``` firewalld (Fedora, RHEL): ```sh sudo firewall-cmd --permanent --add-port=60000-61000/udp && sudo firewall-cmd --reload ``` When the ports are closed, moshterm says the server didn't answer over UDP instead of leaving you at a blank screen. ### What you get on the phone - Mosh is built into the app. There is nothing else to install on the phone. - Local echo shows what you type straight away on a slow link, before the host answers. Set it to Adaptive, Always or Off. - Auto tries Mosh first, then Eternal Terminal, then SSH, so a host without mosh-server still connects. - When you connect, pick one of the host's tmux, Zellij or Herdr sessions. If iOS or Android ends the app, opening it again puts you back there. - Unlimited hosts, keys kept in the iOS Keychain or Android Keystore, and a key bar with Esc, Tab, Ctrl and arrows. ### Mosh and tunnels Mosh needs UDP, so it can't run through a Cloudflare Tunnel, which carries TCP. Hosts you reach through a tunnel connect over SSH instead. See SSH through a Cloudflare Tunnel. ### Is moshterm's Mosh client free? Yes. Mosh, Eternal Terminal and SSH are all free in moshterm, with unlimited hosts and no account. The optional moshterm Pro subscription only adds live previews of dev servers and simulators. ### Does the phone need anything besides the app? No. The Mosh protocol is part of the app. Only the computer you connect to needs mosh-server. ### Why does SSH work but Mosh doesn't? Mosh starts over SSH on TCP, then needs a UDP port between 60000 and 61000 to reach the host. A firewall or network that blocks UDP stops it. Open the range, or connect with Eternal Terminal or SSH. ## Eternal Terminal on your phone https://moshterm.com/eternal-terminal moshterm has a native Eternal Terminal (ET) client for iPhone, iPad and Android. It speaks ET's own protocol to a stock etserver, by default on TCP port 2022, so a session picks up where it left off after the network drops. It is free. If the host has no etserver, moshterm connects over SSH and tells you what to install. ### Why ET as well as Mosh Mosh needs UDP, and some networks block it. ET works over TCP and reconnects to the same session when the connection comes back. With Auto, moshterm tries Mosh first, then ET, then SSH, so each host gets the best connection it can take. ### Set up etserver On a Mac, these are the same commands the app suggests when it finds no etserver: macOS (Homebrew): ```sh brew install et ``` runs etserver on port 2022: ```sh sudo brew services start et ``` On Linux, install Eternal Terminal from your distribution or the project's own packages. The server reads its port from its config file: /etc/et.cfg: ``` [Networking] port = 2022 bind_ip = 0.0.0.0 ``` If a firewall sits in front of the host, open that port: ufw (Ubuntu, Debian): ```sh sudo ufw allow 2022/tcp ``` ### Connecting ET signs in over SSH first, then hands the session to etserver. Use the same user, key and host you use for SSH. If etserver listens somewhere other than 2022, set the ET port in the host's settings. - If etserver isn't running, the session connects over SSH and a short note says what to install. - If etserver doesn't answer, the app says to check the ET port and the firewall. - A session the app keeps reattaches to the same shell after iOS or Android ends the app. - Run tmux, Zellij or Herdr on the host and the session picker lists their sessions when you connect. ### Should I use Mosh or Eternal Terminal? Use Mosh where UDP gets through: it roams between networks and can echo your typing locally. Use Eternal Terminal where only TCP is allowed. With Auto, moshterm tries Mosh, then ET, then SSH. ### Which etserver does it work with? A stock etserver. moshterm's ET client is tested against Eternal Terminal 7.0.0. ### Is ET free in moshterm? Yes. Eternal Terminal, Mosh and SSH are free, with unlimited hosts and no account. ## Claude Code from your phone https://moshterm.com/claude-code-mobile To use Claude Code from your phone, run it in tmux on your computer, install the moshterm companion there, and connect with moshterm on iPhone, iPad or Android. Its permission prompts reach your lock screen with the command it wants to run. Approve or deny them, or read the session as a chat. All of it is free. ### Set it up On the computer where Claude Code runs (macOS, Linux or WSL): installs moshterm-hook and starts it: ```sh curl -fsSL https://mickmosh-relay.mick-fb5.workers.dev/install.sh | sh ``` adds moshterm's hooks to ~/.claude/settings.json; yours stay: ```sh moshterm-hook install ``` Start Claude Code inside a tmux session, as you normally would: a session for the agent: ```sh tmux new -s api ``` inside that session: ```sh claude ``` Then connect from the phone. The app pairs with the companion on that first connection; there is nothing to copy. If the companion isn't installed yet, the app offers to install it for you. ### Approvals on the lock screen When Claude Code stops to ask permission, the companion sends the request to your phone with the command or the files involved. Deny works right from the notification. Approve asks you to unlock first. Your answer is typed into Claude Code's own dialog, but only after the companion checks that the dialog in the tmux pane is still the one you saw. If it changed, nothing is typed and the phone tells you. When Claude Code isn't in a tmux pane, the request shows Answer in terminal and takes you to the session. ### Chat View and the Inbox Chat View reads Claude Code's transcript on your computer and shows the session as a conversation: your prompts, its replies, and each tool call folded to one line. A prompt you send from Chat View goes to the same pane. Close it and the terminal is where you left it. The Inbox lists every Claude Code session on every paired computer under Needs you, Working and Done. On iPhone, a working session also sits on the Lock Screen as a Live Activity. ### Where things run Claude Code runs on your computer with your own login, exactly as it does at your desk. moshterm is the terminal and the notifications. What you type and see goes straight between your phone and your computer, never through moshterm's servers. ### Can I approve Claude Code permission prompts from my phone? Yes. With the moshterm companion installed and Claude Code running in a tmux pane, each permission prompt reaches your phone. Approve or deny it from the notification or the Inbox, and the companion types the answer into Claude Code after checking the prompt hasn't changed. ### Does Claude Code run on the phone? No. It runs on your own computer as usual. moshterm connects to that computer over Mosh, Eternal Terminal or SSH. ### Is it free? Yes. Approvals, the Inbox, Chat View and notifications are free, with no limit and no account. moshterm Pro only adds live previews of dev servers and simulators. ## Codex from your phone https://moshterm.com/codex-mobile Run the Codex CLI in tmux on your computer, install the moshterm companion, and connect with moshterm on iPhone, iPad or Android. Codex's approval prompts reach your phone with the command attached, Chat View shows the session as a conversation, and the Inbox shows whether Codex is working, waiting or done. Free, with no account. ### Set it up On the computer where Codex runs (macOS, Linux or WSL): installs moshterm-hook and starts it: ```sh curl -fsSL https://mickmosh-relay.mick-fb5.workers.dev/install.sh | sh ``` writes Codex's hooks.json and turns its hooks on: ```sh moshterm-hook install ``` The hooks go in Codex's own folder, $CODEX_HOME (~/.codex unless you changed it). Codex asks once whether to trust the new hooks. Then start Codex inside tmux: a session for the agent: ```sh tmux new -s web ``` inside that session: ```sh codex ``` Connect from the phone and the app pairs with the companion on that first connection. ### Approvals When Codex asks before running a command, the request reaches your phone. Approve or deny it, and the companion types y or Esc into Codex's own prompt, after checking the prompt in the tmux pane is still the one you saw. If it changed, nothing is typed and the phone says so. ### Chat View and the Inbox Chat View reads Codex's session files under $CODEX_HOME/sessions and shows them as a conversation, with tool calls folded to one line. Prompts you send from it go to the same pane. The Inbox keeps one row per Codex session on every paired computer. By default a finished turn only notifies you when the reply needs you, and everything else waits in the Inbox. ### Other agents The same companion manages hooks for Claude Code, OpenCode, Cursor, Grok Build, Kimi Code, Hermes, Pi and OMP. See Claude Code from your phone. ### Can I answer Codex approval prompts from my phone? Yes, when Codex runs in a tmux pane on a computer with the moshterm companion. Approve or deny from the notification or the Inbox; the companion types the answer into Codex after checking the prompt is unchanged. ### Does moshterm run Codex for me? No. Codex runs on your own computer with your own login. moshterm is the terminal, the notifications and the Inbox. ### Is it free? Yes. Approvals, Chat View, the Inbox and notifications are free, with no account. moshterm Pro only adds live previews. ## SSH through a Cloudflare Tunnel https://moshterm.com/cloudflare-tunnel-ssh moshterm connects to SSH hosts published through a Cloudflare Tunnel from iPhone, iPad and Android, with no cloudflared on the phone: enter the tunnel's public hostname as the host. It can also keep the tunnel as a backup that is used only when the direct address can't be reached. Mosh needs UDP, so tunnel sessions run over SSH. ### Publish SSH from the host On the computer, with cloudflared installed and signed in to your Cloudflare account (cloudflared tunnel login): once: ```sh cloudflared tunnel create studio ``` the hostname you will type in the app: ```sh cloudflared tunnel route dns studio ssh.example.com ``` ~/.cloudflared/config.yml: ``` tunnel: credentials-file: /home/you/.cloudflared/.json ingress: - hostname: ssh.example.com service: ssh://localhost:22 - service: http_status:404 ``` or install it as a service: ```sh cloudflared tunnel run studio ``` ### One sshd setting for OpenSSH 9.8 and later Every connection through the tunnel reaches sshd from cloudflared on the same machine, so to sshd they all come from one address. OpenSSH 9.8 and later penalize an address after repeated failed or dropped connections, and once that happens every new connection through the tunnel is refused, while the session you already have keeps working. Exempt the loopback addresses: /etc/ssh/sshd_config: ``` PerSourcePenaltyExemptList 127.0.0.1,::1 ``` Debian and Ubuntu: ```sh sudo systemctl reload ssh ``` ### Cloudflare Access If the hostname is behind Cloudflare Access, the app opens the sign-in page in the browser when Access asks for it. For a hostname protected by a service token, enter the token's client ID and secret in the host's settings. ### Backup route, jump hosts and keys - Keep the host's normal address and add the tunnel hostname as a backup. The tunnel is used only when the direct address can't be reached, for example away from home. - Connect through another saved host first, as a jump host. SSH agent forwarding is a per-host switch. - On iPhone and iPad, an SSH key can live on a YubiKey (PIV). - Host keys are trusted on first use, and a changed key stops the connection until you decide. On a network that allows UDP, connect directly with Mosh instead. ### Do I need cloudflared on my phone? No. moshterm connects to the tunnel's public hostname itself. cloudflared only runs on the computer you connect to. ### Does Mosh work through a Cloudflare Tunnel? No. Mosh needs UDP and the tunnel carries TCP, so sessions through a tunnel use SSH. On networks that allow UDP, connect to the host directly with Mosh. ### Why are new connections through the tunnel refused after a while? OpenSSH 9.8 and later penalize an address after repeated failed or dropped connections, and every tunnel connection comes from cloudflared's loopback address. Add PerSourcePenaltyExemptList 127.0.0.1,::1 to sshd_config and reload sshd. ## The companion https://moshterm.com/companion moshterm-hook is a small program that runs on the computer your agents use. It is what turns a terminal into something that knows an agent is waiting. Agents with managed hooks: Claude Code, Codex, OpenCode, Cursor, Grok Build, Kimi Code, Hermes, Pi and OMP. moshterm-hook uninstall removes only what install wrote.