MT MT - Mosh Terminal

Support

How can we help you?

About MT

MT is an SSH and Mosh terminal client for iOS. Connect to remote servers, manage tmux sessions, and code on the go — with full Japanese IME support, customizable key bars, and a powerful terminal experience optimized for mobile.

SSH & Mosh

Stable connections with SSH fallback and Mosh reconnection on unstable networks.

tmux Integration

One-tap tmux actions: split panes, navigate windows, and manage sessions effortlessly.

CJK Input

Full Japanese, Chinese, and Korean IME support with pre-edit composition and commit feedback.

Keyboard Operation

Full keyboard-only operation with Magic Keyboard, split keyboards, and custom ZMK builds.

iPad + Stage Manager

Multi-window support with Stage Manager. External keyboard, mouse, and trackpad.

iCloud Sync

Sync connection profiles across devices with end-to-end encryption.

General

What protocols does MT support?

MT supports SSH (TCP) for secure shell connections and Mosh (UDP) for mobile-optimized sessions that survive network changes and sleep/wake cycles.

What devices are supported?

MT runs on iPhone and iPad with iOS 18 or later. iPad supports external keyboard and mouse input for a desktop-like experience.

Does the app collect any data?

No. MT does not use any analytics, tracking, or advertising services. All data remains on your device. See our Privacy Policy for details.

How do I get started?

See our Getting Started guide for step-by-step instructions on setting up SSH, Tailscale, SSH keys, Mosh, tmux, and your first connection.

SSH & Connection

Where are my SSH keys stored?

SSH private keys and passwords are stored in the iOS Keychain, which is protected by the device's Secure Enclave hardware. If you enable iCloud Keychain, your keys can sync securely across your Apple devices.

Should I use password or key authentication?

SSH key authentication is strongly recommended. It is more secure than passwords (resistant to brute-force attacks), more convenient (no password typing), and required by some servers. See our Getting Started guide for key setup instructions.

I can't connect to my server. What should I check?

1) Verify SSH is enabled on your server. 2) Check the hostname/IP address and port number (default: 22). 3) Make sure your username is correct. 4) If using key auth, confirm the public key is in ~/.ssh/authorized_keys with correct permissions (chmod 600). 5) Check firewall settings — port 22 must be open. 6) If using Tailscale, run 'tailscale status' to verify both devices are connected.

Mosh

What is the difference between SSH and Mosh? Which should I use?

SSH uses TCP and requires a constant connection — if your network drops, the session ends. Mosh uses UDP and syncs terminal state, so your session survives Wi-Fi switches, cellular handoffs, and even putting your device to sleep. Use SSH for quick tasks or when Mosh is unavailable. Use Mosh when working on the go or on unstable networks.

Does Mosh work on all networks?

Mosh uses UDP ports 60000-61000, which may be blocked on some corporate or hotel Wi-Fi networks. In those cases, the app will automatically suggest falling back to SSH. Using Tailscale can bypass these restrictions since it tunnels all traffic through its own network.

My Mosh connection is slow or keeps disconnecting

Check that UDP ports 60000-61000 are open on your server's firewall. If you're behind a restrictive network, try using Tailscale — it tunnels Mosh's UDP traffic and eliminates port-forwarding issues. Also ensure mosh-server is up to date on your server (version 1.3.2 or later recommended).

Do I need to install mosh-server on my server?

Yes. To use Mosh connections, mosh-server must be installed on the remote machine. MT handles the client side. See the Getting Started guide (Step 5) for installation instructions on macOS, Linux, and Windows (WSL).

tmux

What is tmux and why should I use it?

tmux is a terminal multiplexer that runs on your server. It lets you split your terminal into multiple panes, switch between windows, and keep sessions running even after you disconnect. If your SSH connection drops, your work continues in the tmux session — just reconnect and reattach. MT provides a one-tap interface for all tmux actions from the bottom bar.

I can't find my tmux session / how do I reattach?

Run 'tmux ls' to list all active sessions. Then run 'tmux attach -t session-name' to reattach. In MT, existing tmux sessions are automatically detected when you connect — you can select one from the session picker. If a session is already in use by another tab, it will be shown as unavailable.

Customization

How do I change the color theme?

Go to Settings > Theme and choose from built-in themes including Dracula, Tokyo Night, Gruvbox, Catppuccin, Solarized, and more. The theme applies immediately to all sessions.

How do I import custom fonts?

Go to Settings > Font and tap 'Import Font'. Select a .ttf or .otf file from the Files app, iCloud Drive, or any file provider. The font will be available immediately. Built-in fonts include Menlo, JetBrains Mono, and Courier New.

iPad

How do I use an external keyboard and mouse on iPad?

Connect a Bluetooth or USB keyboard/mouse to your iPad via Settings > Bluetooth or via USB-C. MT automatically supports keyboard input and mouse events including scrolling and clicking. Standard terminal keyboard shortcuts (Ctrl+C, Ctrl+Z, etc.) work as expected.

How do I use Stage Manager with MT?

On supported iPads, enable Stage Manager in Settings > Home Screen & Multitasking. You can then resize MT windows and run multiple instances side by side. Each window maintains its own independent terminal session.

Does mouse scroll wheel work for terminal scrollback?

Yes. Bluetooth mouse scroll wheel and trackpad two-finger scrolling are fully supported for navigating terminal scrollback history. Mouse button events are also captured for applications that use mouse input (e.g., vim with 'set mouse=a', tmux mouse mode).

External Keyboard

Which external keyboards are supported?

Any Bluetooth or USB keyboard that works with iOS is supported, including Apple Magic Keyboard, split ergonomic keyboards (Corne, Lily58, etc.), and custom ZMK/QMK builds. The app automatically detects external keyboard connection and minimizes the software key bar.

How do I use Shift+Tab?

With an external keyboard connected, simply press Shift+Tab as you would on a desktop. This is not possible with the iOS software keyboard. Shift+Tab is essential for navigating Claude Code plans, reverse tab completion, and other tab-enabled interfaces.

My JIS keyboard's ¥ key doesn't produce a backslash

MT automatically detects JIS keyboard layout and converts ¥ to \\ (backslash). If this is not working, check that your iOS keyboard settings correctly identify the keyboard layout: Settings > General > Keyboard > Hardware Keyboard.

How do Sticky Modifiers work?

When using the on-screen soft key bar, Ctrl and Shift buttons work as single-tap toggles: tap once to activate, press any key to apply the modifier, and it auto-deactivates after 5 seconds. This eliminates the need to hold two keys simultaneously on a touchscreen.

iCloud Sync

How do I enable iCloud Sync?

Go to Settings > iCloud Sync and toggle it on. Profile settings sync via CloudKit, while SSH keys and passwords sync via iCloud Keychain with end-to-end encryption. iCloud Sync is off by default.

What data is synced?

Connection profiles (hostnames, ports, usernames, display preferences) and SSH credentials (keys and passwords). Credentials are always end-to-end encrypted via iCloud Keychain — not even Apple can read them.

How do I delete synced data?

Deleted profiles are moved to a 30-day soft-delete (trash) period, during which they can be restored. After 30 days, they are permanently removed from all synced devices. To immediately remove all synced data, disable iCloud Sync in Settings.

Accessibility

Is VoiceOver supported?

Yes. All non-terminal screens (session list, settings, connection dialogs, soft key bar buttons) are fully accessible with VoiceOver. Terminal screen VoiceOver support is planned for a future update.

Does the app support Dynamic Type?

Yes. UI elements scale with the system Dynamic Type setting, supporting up to 1.5x enlargement for accessibility sizes. Terminal font size can be adjusted independently via pinch-to-zoom or in Settings.

Support

How do I report a bug or request a feature?

Please email us at support@jaga-farm.com with a description of the issue or your feature idea. Include your iOS version and device model if reporting a bug.

Still need help?

We're here to help. Send us an email and we'll get back to you.

support@jaga-farm.com