# Show HN: Remux – an open-source tmux workspace designed for iPhone

> Source: <https://github.com/h3nock/remux>
> Published: 2026-07-23 14:31:26+00:00

A native iOS client for remote tmux workspaces.

## remux-readme.mp4

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.

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

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.

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](/h3nock/remux/blob/main/scripts/build_release_ghosttykit.sh).

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.