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.
Metal Terminal & libghostty-vt: Truecolor rendering, Nerd Font + CJK fallback cascade, multi-tab session bar, and touch accessory strip.
Every layer of GhostTerm is purpose-built in Swift, C, and Metal for low-latency remote work over cellular, Wi-Fi, and private tailnets.
tmux -CC Control ModeEnable 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.
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.
CSI u)
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.
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.
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.
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.
Platform-neutral Swift packages for terminal state, SSH transport, and tmux control—backed by 177 unit tests and zero legacy terminal bloat.
SO_KEEPALIVE and 15-second keepalive@openssh.com probes that automatically re-establish port forwards and tmux -CC sessions.http, https, and mailto schemes; multi-line pastes warn before execution.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.
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/tmux.md • docs/tailscale.md • docs/keyboard.md • docs/ipad.md