explaingit

helvesec/rmux

Analysis updated 2026-06-24

391RustAudience · developerComplexity · 4/5LicenseSetup · moderate

TLDR

Rust rewrite of tmux with a typed SDK so programs and AI agents can spawn sessions, send keys and watch panes on Linux, macOS and native Windows.

Mindmap

mindmap
  root((rmux))
    Inputs
      tmux style commands
      SDK calls
      SSH sessions
    Outputs
      Persistent sessions
      Pane snapshots
      Wait for text events
    Use Cases
      Persistent terminals
      Driving AI agents
      Embedding panes in Ratatui
      Browser test orchestration
    Tech Stack
      Rust
      Tokio
      Ratatui
      Named Pipes
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Run a tmux compatible session manager natively on Windows without WSL

USE CASE 2

Drive long lived AI agent terminals from Rust code with a typed SDK

USE CASE 3

Embed a live RMUX pane inside a Ratatui terminal UI

USE CASE 4

Mirror a terminal session to a browser or to Playwright tests

What is it built with?

RustTokioRatatui

How does it compare?

helvesec/rmuxqewer33/ratscadl0ng-ai/papr
Stars3919888
LanguageRustRustRust
Setup difficultymoderatemoderateeasy
Complexity4/53/52/5
Audiencedeveloperdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

At 0.2.0 the author warns bugs are expected, and the SDK use cases need a Rust toolchain to build against the typed crates.

Dual licensed under MIT or Apache 2.0, so you can pick either for commercial or open source use.

In plain English

RMUX is a Rust rewrite of tmux, the long-running Unix tool that lets you keep terminal sessions alive in the background and switch between them. The author's stated goal is to support a new use case: running AI agents and other long-lived programs over SSH or locally, without losing their terminals, while also letting code inspect and drive those terminals. It is published under MIT or Apache 2.0 and is at version 0.2.0 as of May 2026. The project keeps tmux's command-line surface, with all 90 tmux-compatible commands implemented, so a tmux user can largely continue working the same way. What is new is a typed SDK in Rust that talks to the RMUX daemon over a local protocol, so a program can create sessions, send keystrokes, take snapshots of what is on screen, and wait for specific text to appear in a pane. There is also a widget for Ratatui, a Rust terminal UI library, which lets you embed a live RMUX pane inside another terminal UI. Unlike tmux, RMUX runs natively on Linux, macOS, and Windows. The Windows support uses Named Pipes and does not require WSL. Install is a one-line curl script on Linux and macOS, an iwr command on Windows PowerShell, or cargo install for Rust users. The SDK is added with cargo add rmux-sdk and cargo add ratatui-rmux. The README links to five example demos in a sibling repository: orchestrating multiple agents, broadcasting commands to many panes, a small Zellij-like multi-pane UI, mirroring a terminal to a browser, and driving Playwright browser tests from a terminal session. Internally the project is split into many crates: shared types, IPC protocol, OS helpers, the SDK, the Ratatui widget, plus support crates for PTY handling, sessions and layouts, and the Tokio daemon itself. The author notes that bugs are expected at this stage and asks users to file issues.

Copy-paste prompts

Prompt 1
Install rmux on Windows via the iwr one liner and start a session that survives a PowerShell restart
Prompt 2
Write a Rust program using rmux-sdk that spawns a pane, runs an agent and waits for a specific prompt to appear
Prompt 3
Add the ratatui-rmux widget to a small TUI and show a live RMUX pane next to a log view
Prompt 4
Compare rmux SDK calls to the tmux control mode API and list which workflows are easier in rmux

Frequently asked questions

What is rmux?

Rust rewrite of tmux with a typed SDK so programs and AI agents can spawn sessions, send keys and watch panes on Linux, macOS and native Windows.

What language is rmux written in?

Mainly Rust. The stack also includes Rust, Tokio, Ratatui.

What license does rmux use?

Dual licensed under MIT or Apache 2.0, so you can pick either for commercial or open source use.

How hard is rmux to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is rmux for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.