Remux: A Mobile-First tmux Experience for iOS

Remux is a native iOS application designed to bring the power of remote tmux workspaces to the iPhone. By leveraging the Ghostty terminal core, it transforms the traditional terminal experience into a mobile-optimized interface.

Visualizing the persistent terminal session on iOS.

🚀 Core Philosophy

~~Traditional SSH clients are clunky on mobile.~~ Remux reimagines the tmux session, window, and pane model specifically for touch screens. It removes the need for intermediaries, providing a direct connection to your server.

System Architecture

✨ Key Features

🛠 Terminal & Workspace Management

Session Handling: Effortlessly attach to existing tmux sessions or initialize new ones.
Intuitive Navigation:
- Windows: Navigate via simple swipes.
- Panes: Utilize a bottom sheet with live previews to select panes.
- Controls: Easily split, zoom, or terminate panes.
Starter Sets: Pre-configured groups for shell, Claude Code, and Codex, with full support for custom command groups.

📂 Integrated Previews & Attachments

Feature	Trigger	Supported Formats/Capabilities
File Preview	Long-press path	Code, Images, PDFs, HTML
Localhost	Long-press URL	Remote dev servers, WebSockets, Hot Reload
Attachments	Upload action	Photos and files $\rightarrow$ Server (includes image markup)

⌨️ Enhanced UX & Security

Precision Cursor: Move the cursor by holding the space bar or long-pressing the terminal and dragging.
Privacy First:
- No relay servers or mandatory accounts.
- Private keys and passwords are secured within the iOS Keychain.
- Trusted host keys are cached for seamless reconnection.
Aesthetics:
- Themes: Ghostty Default, Catppuccin Mocha, and Catppuccin Latte.
- Customization: Fully adjustable font sizes.

📦 Installation & Setup

Public Beta

You can join the beta via TestFlight: testflight.apple.com/join/fHqG1ruE

Building from Source

Prerequisites:

Xcode (supporting iOS 18 SDK)
XcodeGen

Build Workflow:

Step 1: Fetch Framework
```
scripts/fetch_ghosttykit.sh
```

Step 2: Generate & Build Project

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

Step 3: Execute Tests

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

[!TIP] If you prefer to compile GhosttyKit manually rather than fetching the prebuilt version, refer to the remux-ghostty repository and the scripts/build_release_ghosttykit.sh script.

📊 Project Metadata

Technical Foundation:

Terminal Core: Ghostty
SSH Layer: Citadel
License: MIT

Language Distribution: The codebase composition can be represented as: $\text{Total} \approx 91.9\% \text{ Swift} + 4.7\% \text{ Python} + 1.7\% \text{ Shell} + 1.7\% \text{ Other}$

Repository Quick-Links:

h3nock/remux
Website: getremux.app
Topics: #tmux, #ssh, #ios, #terminal, #swiftui