GitHub - h3nock/remux: Native iOS tmux client with a mobile-first UI for persistent terminal sessions. · GitHub
/" data-turbo-transient="true" />
Skip to content
Search or jump to...
Search code, repositories, users, issues, pull requests...
-->
Search
Clear
Search syntax tips
Provide feedback
--><br>We read every piece of feedback, and take your input very seriously.
Include my email address so I can be contacted
Cancel
Submit feedback
Saved searches
Use saved searches to filter your results more quickly
-->
Name
Query
To see all available qualifiers, see our documentation.
Cancel
Create saved search
Sign in
/;ref_cta:Sign up;ref_loc:header logged out"}"<br>Sign up
Appearance settings
Resetting focus
You signed in with another tab or window. Reload to refresh your session.<br>You signed out in another tab or window. Reload to refresh your session.<br>You switched accounts on another tab or window. Reload to refresh your session.
Dismiss alert
{{ message }}
h3nock
remux
Public
Notifications<br>You must be signed in to change notification settings
Fork
Star
main
BranchesTags
Go to file
CodeOpen more actions menu
Folders and files<br>NameNameLast commit message<br>Last commit date<br>Latest commit
History<br>799 Commits<br>799 Commits
.github/workflows
.github/workflows
Remux.xcodeproj
Remux.xcodeproj
RemuxApp
RemuxApp
RemuxAppTests
RemuxAppTests
RemuxAppUITests
RemuxAppUITests
docs
docs
remux-site
remux-site
scripts
scripts
.gitignore
.gitignore
LICENSE
LICENSE
PRIVACY.md
PRIVACY.md
README.md
README.md
project.yml
project.yml
View all files
Repository files navigation
Remux
A native iOS client for remote tmux workspaces.
remux-readme.mp4
Join the beta on TestFlight
About
Remux is a native iOS client for remote tmux workspaces, built on Ghostty.<br>It brings tmux's session, window, and pane model into a mobile-first<br>interface. It previews files and running dev servers straight from the<br>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<br>sheet with live previews, and split, zoom, or close them.
Shortcut palette : Run saved commands with a tap. Starter sets cover<br>shell, Claude Code, and Codex, and you can add your own commands and<br>groups.
Attachments : Upload photos and files to the server, with markup for<br>images. The remote path is typed at the prompt.
File preview : Long-press a path in terminal output to preview it:<br>code, images, PDFs, or HTML pages.
Localhost preview : Long-press a localhost URL to open the dev server<br>running on the remote machine, hot reload and WebSockets included.
Cursor control : Hold the space bar or long-press in the terminal,<br>then drag to place the cursor.
Direct SSH : Remux connects straight to the server, with no relay and<br>no account. Passwords and private keys are stored in the iOS Keychain,<br>and trusted host keys are remembered.
Themes : Ghostty default, Catppuccin Mocha, and Catppuccin Latte,<br>with adjustable font size.
Installation
Remux is available as a public beta on TestFlight:<br>testflight.apple.com/join/fHqG1ruE.<br>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 \<br>-project Remux.xcodeproj \<br>-scheme Remux \<br>-destination 'generic/platform=iOS Simulator'
Run the tests:
xcodebuild test \<br>-project Remux.xcodeproj \<br>-scheme Remux \<br>-destination 'platform=iOS Simulator,name=iPhone 17,OS=latest'
To build GhosttyKit yourself instead of fetching it, see<br>remux-ghostty and<br>scripts/build_release_ghosttykit.sh.
Acknowledgments
Remux is built on Ghostty's<br>terminal core and uses Citadel<br>for SSH.
About
Native iOS tmux client with a mobile-first UI for persistent terminal sessions.
getremux.app/
Topics
tmux
ssh
ios
terminal
swiftui
mobile-terminal
libghostty
Resources
Readme
License
MIT license
Uh oh!
There was an error while loading. Please reload this page.
Activity
Stars
stars
Watchers
watching
Forks
fork
Report repository
Releases
No releases published
Packages
Uh oh!
There was an error while loading. Please reload this page.
Contributors
Uh oh!
There was an error while loading. Please reload this page.
Languages
Swift<br>91.9%
Python<br>4.7%
Shell<br>1.7%
Other<br>1.7%
You can’t perform that action at this time.