# GitHub - h3nock/remux: A native iOS client for remote tmux workspaces, designed to feel natural on iPhone.

> A native iOS client for remote tmux workspaces.

remux-readme.mp4

[Join the beta on TestFlight](https://testflight.apple.com/join/fHqG1ruE)

## About

[](#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

[](#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.
- **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

[](#installation)

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

## Building 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](https://github.com/h3nock/remux-ghostty) and [scripts/build\_release\_ghosttykit.sh](https://github.com/h3nock/remux/blob/main/scripts/build_release_ghosttykit.sh).

## Acknowledgments

[](#acknowledgments)

Remux is built on [Ghostty](https://github.com/ghostty-org/ghostty)'s terminal core and uses [Citadel](https://github.com/orlandos-nl/Citadel) for SSH.