Remux

A native iOS client for remote tmux workspaces.

https://github.com/user-attachments/assets/e7482322-15f8-4f7d-aca4-83368fddd07c

Join the beta on TestFlight

About

Remux is a native iOS client for remote tmux workspaces, built on Ghostty. It brings tmux's session, window, and pane model into a mobile-first interface. It previews files and running dev servers straight from the terminal, and uploads photos and files, with markup for images.

Features

• tmux sessions: Attach to running sessions or start new ones.
• Windows and panes: Swipe between windows, pick panes from a bottom sheet with live previews, and split, zoom, or close them.
• Shortcut palette: Run saved commands with a tap. Starter sets cover shell, Claude Code, and Codex, and you can add your own commands and groups.
• Voice dictation: Dictate text in the composer using on-device speech recognition.
• Attachments: Upload photos and files to the server, with markup for images. The remote path is typed at the prompt.
• File preview: Long-press a path in terminal output to preview it: code, images, PDFs, or HTML pages.
• Localhost preview: Long-press a localhost URL to open the dev server running on the remote machine, hot reload and WebSockets included.
• Cursor control: Hold the space bar or long-press in the terminal, then drag to place the cursor.
• Direct SSH: Remux connects straight to the server, with no relay and no account. Passwords and private keys are stored in the iOS Keychain, and trusted host keys are remembered. Supports Secure Enclave keys, which are created on the device and can't be copied or exported.
• Themes: Ghostty default, Catppuccin Mocha, and Catppuccin Latte, with adjustable font size.

Installation

Remux is available as a public beta on TestFlight: testflight.apple.com/join/fHqG1ruE. You can also build from source.

Building from Source

Requirements:

• Xcode with iOS 18 SDK support
• XcodeGen

Fetch the prebuilt GhosttyKit framework:

scripts/fetch_ghosttykit.sh

Generate the Xcode project and build:

xcodegen generate

xcodebuild build \
  -project Remux.xcodeproj \
  -scheme Remux \
  -destination 'generic/platform=iOS Simulator'

Run the tests:

xcodebuild test \
  -project Remux.xcodeproj \
  -scheme Remux \
  -destination 'platform=iOS Simulator,name=iPhone 17,OS=latest'

To build GhosttyKit yourself instead of fetching it, see remux-ghostty and scripts/build_release_ghosttykit.sh.

Acknowledgments

Remux is built on Ghostty's terminal core and uses Citadel for SSH.