explaingit

zolrath/wemux

Analysis updated 2026-07-03

3,672ShellAudience · ops devopsComplexity · 2/5Setup · easy

TLDR

wemux adds shared terminal sessions to tmux, letting multiple people work together over SSH, one person watches in read-only, both share control, or each browses independently in the same session.

Mindmap

mindmap
  root((repo))
    What It Does
      Multi-user tmux
      SSH collaboration
    Share Modes
      Mirror read-only
      Pair shared cursor
      Rogue independent
    Setup
      Homebrew install
      Manual clone
      Config file
    Management
      Host controls
      User list display
      Multiple servers
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

Host a live coding session where a teammate watches your terminal in read-only mode without interrupting your work.

USE CASE 2

Pair program with a remote developer sharing the same terminal cursor over SSH.

USE CASE 3

Let a junior developer shadow your work safely while you debug a production issue.

What is it built with?

Shelltmux

How does it compare?

zolrath/wemuxxtls/xray-examplesandrew-d/static-binaries
Stars3,6723,6733,687
LanguageShellShellShell
Setup difficultyeasyhardeasy
Complexity2/53/52/5
Audienceops devopsops devopsops devops

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

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires tmux version 1.6 or higher already installed on the host system.

License not mentioned in the explanation.

In plain English

wemux is a shell script that adds multi-user collaboration features on top of tmux. Tmux is a tool that lets you keep a terminal session running on a server and reconnect to it later, or split your terminal into multiple panes. wemux takes that further by letting multiple people share the same session over SSH, each with a different level of control. There are three ways a second person (the client) can join: Mirror Mode gives them a read-only view so they can watch the host work, Pair Mode gives them a shared cursor so both people control the same terminal together, and Rogue Mode lets the client move around to different windows independently while still being in the same tmux session. The host can kick users, see who is connected, and run multiple independent servers on the same machine if needed. Installation is straightforward. On macOS it can be installed through Homebrew or MacPorts with one command. On other systems you clone the repository, put the script somewhere on your path, copy the example config file, and add your username to the host list. Anyone in the host list can start servers, everyone else automatically becomes a client when they run wemux. The config file controls optional features like whether clients can switch between servers, whether the user list is shown, and what mode clients land in by default. The user list can also appear in your tmux status bar so the host always sees who is connected. wemux passes any commands it does not recognize directly to tmux with the right socket settings, so you can use it as a drop-in wrapper for tmux commands. The project is a single Shell script and requires tmux version 1.6 or higher.

Copy-paste prompts

Prompt 1
I want to set up wemux on my Linux server so two people can pair program in the same terminal. Walk me through installing wemux and starting a shared tmux session.
Prompt 2
Using wemux, how do I configure Mirror Mode so my team can watch my terminal but not type? Show me the config file settings.
Prompt 3
Help me set up wemux so multiple users SSH into my server and automatically land in a shared tmux session in Pair Mode.
Prompt 4
Show me how to see who is currently connected to my wemux session and how to remove a user from the session.

Frequently asked questions

What is wemux?

wemux adds shared terminal sessions to tmux, letting multiple people work together over SSH, one person watches in read-only, both share control, or each browses independently in the same session.

What language is wemux written in?

Mainly Shell. The stack also includes Shell, tmux.

What license does wemux use?

License not mentioned in the explanation.

How hard is wemux to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is wemux for?

Mainly ops devops.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub zolrath on gitmyhub

Verify against the repo before relying on details.