GhostTerm App Icon
Built on Ghostty’s libghostty-vt • iOS & iPadOS

Desktop-grade SSH, tmux & Tailscale.
Engineered for iPhone & iPad.

GhostTerm pairs Ghostty’s authentic VT parser (libghostty-vt) with a custom Metal glyph renderer, native tmux -CC splits, embedded userspace Tailscale, and Face ID Keychain security.

App Store & TestFlight Explore Features →
Metal + CoreText Atlas tmux -CC Native Tabs & Splits Userspace Tailscale (tsnet) ControlMaster SSH Sharing Keychain + Face ID Kitty Keyboard Protocol (CSI u)
GhostTerm screenshot preview

Metal Terminal & libghostty-vt: Truecolor rendering, Nerd Font + CJK fallback cascade, multi-tab session bar, and touch accessory strip.

No WebViews. No compromises.

Every layer of GhostTerm is purpose-built in Swift, C, and Metal for low-latency remote work over cellular, Wi-Fi, and private tailnets.

>_

First-Class tmux -CC Control Mode

Enable tmux -CC on any saved host to turn remote tmux windows into native iOS/iPadOS tabs and remote tmux panes into native hardware-accelerated split views. Drag split dividers to resize remote panes in real time, zoom panes in place, and detach cleanly without losing state.

# Automatic session attach on connect or reconnect
$ tmux -CC new-session -A -s main
%begin 1730419200 1 0 • Window strip + recursive split layout synced
VT

Ghostty VT + Metal Atlas

Powered by Ghostty’s libghostty-vt C library with a custom Metal renderer and CoreText glyph atlas. Supports 24-bit truecolor, optional ligature shaping, OSC 8 hyperlinks, bracketed paste with multi-line confirmation, and inertial CADisplayLink scrollback.

✓ Kitty Keyboard (CSI u)
✓ Nerd Font + CJK Cascade
TS

Embedded Userspace Tailscale

Built-in libtailscale (tsnet) node lets GhostTerm dial private tailnet IPs (100.x.y.z) and MagicDNS names directly over userspace TCP—supports standard Tailscale OAuth or self-hosted Headscale control planes and auth keys.

tailnet: acme-prod.ts.net
route: userspace tsnet (no VPN required)
SSH

ControlMaster Multiplexing, Port Forwarding & Agent

Built on swift-nio-ssh with automatic connection pooling: opening multiple tabs or splits to the same server reuses a single authenticated TCP/SSH connection—one handshake and one Face ID prompt. Configure local (-L) port forwards, a dynamic SOCKS5 proxy (-D) with IPv4/IPv6/domain resolution, and SSH agent forwarding (-A) with per-signature confirmation.

-L 127.0.0.1:5432 → db.internal:5432  |  -D 127.0.0.1:1080 (SOCKS5)  |  -A Keychain Agent (Allow/Deny)
🔑

Keychain + Face ID Security

Generate Ed25519 keys or import encrypted OpenSSH Ed25519 and ECDSA (P-256/384/521, bcrypt-pbkdf) keys. Private keys live exclusively in the iOS Keychain (ThisDeviceOnly) with optional Face ID / Passcode presence.

Strict known_hosts: Changed host keys trigger a hard full-screen warning.
⌘

Designed for iPadOS, Hardware Keyboards & Full CJK IME

Full iPadOS Stage Manager multi-window support with state restoration, External Display mirror/dedicated terminal mode, and discoverable Cmd shortcuts. Remap Caps Lock or ` to Escape or Control, use Left/Right Option as Meta, and type seamlessly in Chinese, Japanese, and Korean with native inline UITextInput marked-text composition.

⌘T New Tab  •  ⌘D / ⇧⌘D Split Pane  •  ⌘1..9 Switch Tab  •  ⌘+ / ⌘- / ⌘0 Font Size

Clean, modular native architecture

Platform-neutral Swift packages for terminal state, SSH transport, and tmux control—backed by 177 unit tests and zero legacy terminal bloat.

TerminalUI & SwiftUI App
Metal glyph atlas, CoreText shaping, UITextInput IME, Stage Manager scenes
Metal + UIKit
TerminalCore & TmuxControl
libghostty-vt Swift bridge, DCS 1000p parser, layout tree & resize sync
libghostty-vt
SSHTransport & SSHKeys
ControlMaster pool, OpenSSH key parser (bcrypt-pbkdf), -L/-D/-A forwards
swift-nio-ssh
TailscaleKit & KeychainSecretStore
Userspace tsnet dialer, LAContext Face ID presence, strict known_hosts
libtailscale

Built for daily production engineering

  • 01
    6 Curated Color Themes: Ghostty Default, Catppuccin Mocha & Latte, Dracula, and Solarized Dark & Light—with per-host overrides.
  • 02
    Resilient Reconnect: Automatic exponential backoff with SO_KEEPALIVE and 15-second keepalive@openssh.com probes that automatically re-establish port forwards and tmux -CC sessions.
  • 03
    Safe Hyperlinks & Paste: OSC 8 and detected URLs are restricted to http, https, and mailto schemes; multi-line pastes warn before execution.
  • 04
    Localized UI: Available in English, Simplified Chinese (简体中文), Traditional Chinese (繁體中文), Japanese (日本語), and French (Français).
🛡️

Privacy Policy

GhostTerm collects zero personal data, zero analytics, and zero telemetry.

All saved host configurations, known_hosts fingerprints, and preferences are stored locally on your device. Private SSH keys and saved passwords are stored exclusively in the iOS/iPadOS Keychain with kSecAttrAccessibleWhenUnlockedThisDeviceOnly protection and never leave your device. Face ID authentication is evaluated locally by iOS via LocalAuthentication.

Read full Privacy Policy →
💬

Support & Documentation

Need help configuring tmux -CC, importing encrypted OpenSSH keys, or connecting GhostTerm to a Tailscale or Headscale tailnet?

Check out the built-in documentation guides in the repository covering keyboard shortcuts, iPadOS multitasking, CJK IME input, tmux -CC control mode, and Tailscale setup.

Docs: docs/tmux.md • docs/tailscale.md • docs/keyboard.md • docs/ipad.md