The Universal Multiplexer Engine. English · Français · 简体中文 · 日本語 [!NOTE] RMUX now has an E2E web multiplexing feature. Learn more in the docs. RMUX now provides Python and TypeScript SDKs: librmux, @rmux/sdk. If you have a feature request or want to report anything, please file an issue. 🧭 What is RMUX? RMUX is an async, typed terminal multiplexer engine written in Rust. It implements 90+ tmux commands and runs…
RMUX now provides Python and TypeScript SDKs: librmux, @rmux/sdk.
If you have a feature request or want to report anything, please file an issue.
🧭 What is RMUX?
RMUX is an async, typed terminal multiplexer engine written in Rust. It implements 90+ tmux commands and runs natively on Linux, macOS, and Windows with no WSL required.
Use it as a standalone CLI, embed it in Rust terminal apps, or drive it through typed SDKs for Rust, Python, and TypeScript.
✨ Features
Universal engine: typed SDKs for Rust, Python, and TypeScript.
Native cross-platform runtime: Linux, macOS, and Windows backends.
tmux-compatible command surface: 90+ commands covered by focused compatibility tests.
Engineered and optimized for speed: see Benchmarks.
Web Share: browser-shared sessions with hybrid post-quantum end-to-end encryption.
Ratatui widget: render live RMUX panes inside Rust terminal applications.
Local daemon architecture: shells, panes, windows, sessions, and scrollback stay on your machine.
Direct downloads (.tar.gz, .deb, .rpm, .zip) are available from the v0.10.0 GitHub Release.
Package managers can lag while registries review new releases; use the versioned
GitHub Release download when a manager has not caught up yet.
On Windows, extract the complete .zip and add the extracted package root to
PATH. Keep rmux.exe, rmux-daemon.exe, and libexec/rmux/rmux.exe
together; copying only the public executable is not a valid installation.
For Unix .tar.gz downloads, run ./install.sh --prefix ~/.local from the
extracted archive. The installer preserves the required bin/ and libexec/
layout so the tiny public CLI can always reach its full helper.
Release packages may use a tiny public CLI for hot detached commands and a
private full CLI helper for complex tmux-compatible command forms. Windows
packages ship rmux.exe as the tiny dispatcher and keep the full CLI under
libexec/rmux/rmux.exe. Set RMUX_DISABLE_TINY_CLI=1 to force the full helper
while diagnosing CLI compatibility issues.
🤝 Claude Teammate Mode
Run Claude Code inside a local RMUX workspace with
tmux teammate mode enabled.
rmux claude [args]
# e.g., rmux claude --dangerously-skip-permissions
RMUX opens an attached session and automatically passes --teammate-mode tmux
along with your [args] straight to Claude.
How it works under the hood: to route commands properly, RMUX prepends a
private tmux shim to Claude’s PATH. This is strictly scoped to the Claude
process and will not conflict with your system tmux installation.
Install RMUX’s user-level Claude Code skill when you want Claude to remember
the RMUX CLI, SDK, web-share, and automation patterns outside this repository:
rmux claude install-skill
The skill is installed under your Claude profile (~/.claude/skills/rmux on
Linux/macOS, %USERPROFILE%\.claude\skills\rmux on Windows). The repository
keeps the source copy at resources/claude/skills/rmux/SKILL.md so the project
can package and install it without a hidden .claude source-tree directory.
Note: Requires claude to be installed on your machine.
⚙️ Configuration
RMUX reads .rmux.conf from standard system and user locations.
If no RMUX config is found, RMUX can parse standard tmux.conf paths on a best-effort basis. Unsupported plugin lines are reported without aborting startup. Disable this fallback with RMUX_DISABLE_TMUX_FALLBACK=1.
🌐 Web Sharing
Share a pane or session in a browser while terminal execution remains local.
rmux web-share
rmux new-session -d -s work
rmux web-share -t work
rmux web-share --tunnel-provider localhost-run
Web Share uses hybrid post-quantum end-to-end encryption and can run over loopback, a tunnel provider, or your own ingress.
RMUX keeps shells, sessions, windows, panes, and PTY processes inside the local daemon. Local clients attach via IPC. Web Share exposes only the selected pane or session through an end-to-end encrypted WebSocket.
🧪 Verification
The workspace is designed to be checked from source with locked dependencies:
评论