Getting Started

SSH lets you remotely control a computer from your iPhone. Enable it on the computer you want to connect to.

# Method 1: System Settings (recommended)
# System Settings > General > Sharing > Remote Login → ON

# Method 2: Command line
sudo systemsetup -setremotelogin on

# Verify SSH is running
sudo launchctl list | grep ssh

# PowerShell (Run as Administrator)

# Install OpenSSH Server
Add-WindowsCapability -Online -Name OpenSSH.Server~~~~0.0.1.0

# Start the SSH service
Start-Service sshd

# Enable SSH to start automatically on boot
Set-Service -Name sshd -StartupType 'Automatic'

# PowerShell (Run as Administrator)

# Check for existing SSH rules
Get-NetFirewallRule -Name *ssh* -ErrorAction SilentlyContinue

# If no rule exists, create one
New-NetFirewallRule -Name sshd -DisplayName 'OpenSSH Server (sshd)' `
  -Enabled True -Direction Inbound -Protocol TCP `
  -Action Allow -LocalPort 22

# Test on the same PC
ssh localhost

# Or from another PC
ssh username@192.168.x.x

# Ubuntu/Debian — usually pre-installed
sudo systemctl enable ssh
sudo systemctl start ssh

# CentOS/RHEL
sudo systemctl enable sshd
sudo systemctl start sshd

Normally, connecting from outside your home network requires complex router settings. Tailscale skips all of that — just install it on both devices, sign in with the same account, and they can talk to each other from anywhere.

# Method 1: Mac App Store — search "Tailscale" (recommended)

# Method 2: Homebrew
brew install --cask tailscale

# 1. Download from tailscale.com/download
# 2. Run the installer
# 3. Sign in via the taskbar icon

curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up

# Check your Tailscale IP on the server
tailscale status

# Example output:
# 100.64.0.2   my-server   linux   -
# → Use 100.64.0.2 as hostname in MT

SSH keys are like a digital key pair — a private key on your iPhone (kept secret) and a public key on your computer (like a lock). This lets you log in without typing a password every time.

Step 1: Generate SSH Keys

# Generate SSH key (you'll be prompted for a passphrase)
ssh-keygen -t ed25519 -C "your-email@example.com"

# Copy public key to clipboard
cat ~/.ssh/id_ed25519.pub | pbcopy

# Check OpenSSH client (usually pre-installed)
ssh -V

# Generate SSH key
ssh-keygen -t ed25519 -C "your-email@example.com"

# Display public key to copy
Get-Content $env:USERPROFILE\.ssh\id_ed25519.pub

Step 2: Register Public Key on Your Server

# Connect via SSH (password auth) and add public key
ssh user@your-server "mkdir -p ~/.ssh && chmod 700 ~/.ssh"

# Append your public key
ssh user@your-server "echo 'PASTE_YOUR_PUBLIC_KEY_HERE' >> ~/.ssh/authorized_keys && chmod 600 ~/.ssh/authorized_keys"

# On the Windows server — PowerShell (Run as Administrator)

# For standard users:
New-Item -Force -ItemType Directory -Path $env:USERPROFILE\.ssh
Add-Content -Path $env:USERPROFILE\.ssh\authorized_keys -Value "PASTE_YOUR_PUBLIC_KEY_HERE"

# For admin users:
Add-Content -Path $env:ProgramData\ssh\administrators_authorized_keys -Value "PASTE_YOUR_PUBLIC_KEY_HERE"
icacls $env:ProgramData\ssh\administrators_authorized_keys /inheritance:r /grant "Administrators:F" /grant "SYSTEM:F"

Step 3: Test Connection

# Verify passwordless login
ssh user@your-server

Mosh keeps your connection alive even when your iPhone switches between Wi-Fi and cellular. tmux lets you split your screen and keep work running even after you disconnect. Install both on the computer you connect to.

# Install Homebrew if not already installed
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Install Mosh and tmux
brew install mosh tmux

# Verify
mosh --version
tmux -V

# PowerShell (Run as Administrator)
wsl --install
# Restart, then set up Ubuntu username and password

# Inside WSL Ubuntu terminal
sudo apt update
sudo apt install openssh-server mosh tmux

# Start SSH server
sudo service ssh start

# Verify
mosh --version
tmux -V

# With Tailscale: install Tailscale inside WSL
curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up

# Ubuntu/Debian
sudo apt update
sudo apt install mosh tmux

# CentOS/RHEL
sudo yum install epel-release
sudo yum install mosh tmux

# Verify
mosh --version
tmux -V

# Enable mouse/touch scroll support
set -g mouse on

# Enable clipboard sharing (copy from terminal → iPhone)
set -s set-clipboard on
set -as terminal-features ',xterm-256color:clipboard'

# Allow escape sequence passthrough (e.g. image display, notifications)
# Requires tmux 3.3a+ — "half" restricts to active pane only (safer)
set -g allow-passthrough half

# Enable synchronized output (smooth screen redraws)
# Requires tmux 3.3a+ — check with: tmux -V
set -as terminal-features ',xterm-256color:sync'

# Clipboard fix for Mosh connections
set -as terminal-overrides ',xterm-256color:Ms=\E]52;c;%p2%s\007'

# Increase scrollback buffer (default: 2000)
set -g history-limit 100000

tmux source-file ~/.tmux.conf

Open MT on your iPhone. You'll see the session list — tap the "+" button in the top right to add a new connection.

• Hostname: Enter your computer's IP address (e.g. 192.168.1.10) or Tailscale IP (e.g. 100.64.0.2)
• Port: Leave as 22 (the default)
• Username: The login name on your computer (e.g. "john" or "admin")
• Authentication: Choose SSH key (recommended) or password. You can import the key from Step 4, or generate a new one in the app

Tap your saved connection to connect. If this is your first time, you may see a host key confirmation — tap "Trust" to continue. Once connected, you'll see a terminal just like on your PC.

Troubleshooting

• Can't connect? Check SSH is enabled and hostname/port are correct.
• Key auth failed? Verify ~/.ssh/authorized_keys permissions (chmod 600).
• Using Tailscale? Run "tailscale status" to verify both devices are connected.
• Windows Defender? Ensure port 22 is allowed in the firewall.

tmux is a powerful tool, but you don't need to memorize any commands. In MT, swipe up from the bottom bar to open the tmux action menu. From there, you can split your screen, switch windows, and manage sessions — all with one tap.

Basic tmux Commands (Reference)

# Start a new session
tmux new -s mysession

# Detach from session (it keeps running)
# Ctrl+B → D (or tap the action bar)

# Reattach to existing session
tmux attach -t mysession

# List sessions
tmux ls

Connect a Bluetooth or USB keyboard for a desktop-class terminal experience. MT fully supports keyboard-only operation.

Connecting Your Keyboard

• Bluetooth: Go to iOS Settings > Bluetooth, put your keyboard in pairing mode, and select it.
• USB-C: Simply plug in your keyboard via USB-C (iPad) or Lightning adapter (iPhone).
• MT automatically detects the external keyboard and minimizes the software key bar.

Keyboard Shortcuts

# Terminal shortcuts (same as desktop)
Ctrl+C    — Interrupt current command
Ctrl+Z    — Suspend current process
Ctrl+D    — End of input / logout
Ctrl+L    — Clear screen
Ctrl+R    — Reverse search history

# tmux shortcuts (with default prefix Ctrl+B)
Ctrl+B → %    — Split pane vertically
Ctrl+B → "    — Split pane horizontally
Ctrl+B → o    — Switch to next pane
Ctrl+B → d    — Detach from session

# Special
Shift+Tab     — Reverse tab (unavailable on software keyboard)

Get push notifications showing what Claude actually did — not just "Task complete". Delivered to your iPhone and Apple Watch via Claude Code's Hooks integration.

Step 1: Enable in MT

Open MT → Settings → Push Notifications → turn on the toggle. Copy the Device Secret shown on screen.

Step 2: Run Setup Command

Run this command in your terminal. It installs a notification script and adds hooks to your ~/.claude/settings.json automatically. Works on macOS, Linux, and Windows (WSL):

curl -sL https://raw.githubusercontent.com/Jaga-Studio/mt-push-hooks/main/setup-hooks.sh | sh -s YOUR-DEVICE-SECRET

Replace YOUR-DEVICE-SECRET with the value from Step 1. Then restart Claude Code.

What You'll Receive

Notifications include the actual content of what Claude was doing:

// Task completion — Claude's last response (first 200 chars)
"Edited 3 files and verified the build passes. All tests green."

// Permission request — the actual prompt
"Claude needs your permission to run: git push origin main"

Manual Setup (Alternative)

If you prefer to configure manually, download mt-push-notify.sh to ~/.claude/hooks/, replace __MT_DEVICE_SECRET__ with your secret, then merge hooks-template.json into your settings.json. See GitHub for details.