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.
• 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.