TermOnMac
Vibe code from your iPhone and iPad.
Run Claude Code, Codex, or any AI agent on your Mac — control it from your phone or tablet. E2E encrypted, zero setup.
Download on the App StoreCompatibility
Your Mac runs the terminal. Your iPhone or iPad controls it — from anywhere.
One app replaces three tools
No more juggling Tailscale + tmux + Termius just to reach your Mac.
TermOnMac Built on Cloudflare's global network
Your relay runs on Cloudflare — 300+ cities worldwide. Each connection gets a dedicated server created near your Mac for lowest latency. Auto-scaling, automatic failover, built-in DDoS protection. No self-hosted infrastructure to maintain.
Curve25519 key exchange, AES-256-GCM encryption, Cloudflare's global edge network. No custom crypto, no self-hosted servers — every layer is an industry standard.
Everything you need to work remotely
Remote Terminal
Full terminal access from your iPhone or iPad. 256-color support, scrollback buffer, and responsive touch input.
How the iOS terminal is built →QR Code Pairing
Scan and connect instantly. No SSH keys, no port forwarding, no complex network setup required.
How QR pairing works →End-to-End Encrypted
Curve25519 key exchange + AES-256-GCM encryption. Zero-knowledge relay — we never see your data.
Inside the key exchange →Xcode Build & Deploy
Build, archive, and upload to App Store Connect — all from your iPhone, anywhere.
Session Handoff
Start on iPhone, continue on Mac. Detach and it flows back. One session, seamless between devices.
The attach/detach model →Terminal Keyboard
Touch toolbar with Ctrl, Esc, Tab, and modifier toggles. 16 hardware keyboard shortcuts on iPad.
Full shortcut reference →Always Connected
Auto-reconnect through network switches, device sleep, and tunnels. 256KB ring buffer replays missed output instantly.
How the replay buffer works →Want the full picture? See how it all fits together or browse the engineering notes.
Built for Parallel Workflows
Run multiple tasks in isolated branches, merge results, and ship — all from your iPhone or iPad.
Shortkey Sync
Save key combos or frequent commands as one-tap shortcuts on your iPhone. Build your own mobile developer toolbar.
Worktree Spawn
Spin up isolated git worktrees on the fly. Run parallel tasks in separate branches without conflicts.
Quick Merge
Review diffs and merge worktree branches back to main, all from your phone. No context switching needed.
Multi-Tab Sessions
Open multiple terminal tabs simultaneously. Monitor builds, test runs, and long-running processes at a glance.
Engineering Notes
Built in the open, documented in depth
Every claim on this page has a grounded write-up behind it. 33+ technical articles, each tied to real source code in the shipping app.
How TermOnMac Works: A Zero-Knowledge Mac Terminal Relay
How an iPhone controls a Mac terminal over the internet — iOS app, Mac CLI daemon, Cloudflare Workers relay. End-to-end encrypted; the relay forwards ciphertext it cannot read.
Read note → CryptographyX25519 Key Exchange Without a Central Key Server: How QR Pairing Works
QR pairing, persistent identity keys, and per-connection ephemeral keys. How two devices derive a shared AES-256-GCM session key without a central key server.
Read note → Relay & Durable ObjectsSurviving Cloudflare DO Hibernation Without Dropping WebSocket Connections
Cloudflare Durable Objects hibernate when idle, losing in-memory state. How TermOnMac rebuilds WebSocket role mappings from storage-backed UUID tags on every wake.
Read note →Get started in 3 steps
Install CLI on your Mac
One command to get started:
brew install termonmac/tap/termonmac Scan QR code with iPhone
Open the app and scan the QR code displayed in your terminal. Secure pairing is instant.
You're connected
Start typing. Your Mac terminal is now in your pocket — fully encrypted, fully responsive.
See it in action
How to Initialize (on Mac)
How to Connect to Mac (on iPhone)
Curious what's happening under the hood? Read the architecture overview →
Choose your plan
Free
- ✓ 4 Mac connections
- ✓ Full terminal with scrollback
- ✓ QR code pairing
- ✓ End-to-end encryption
- ✓ Relay server (1,000 tokens/5h)
- ✓ Xcode build
- — Shortcut sync
- ✓ Parallel multi-session
Pro
- ✓ 32 Mac connections
- ✓ Full terminal with scrollback
- ✓ QR code pairing
- ✓ End-to-end encryption
- ✓ Relay server (10,000 tokens/5h)
- ✓ Xcode build
- ✓ Shortcut sync
- ✓ Parallel multi-session
Premium
- ✓ 32 Mac connections
- ✓ Full terminal with scrollback
- ✓ QR code pairing
- ✓ End-to-end encryption
- ✓ Relay server (50,000 tokens/5h)
- ✓ Xcode build
- ✓ Shortcut sync
- ✓ Parallel multi-session