Getting Started

gmux is a browser-based session manager for AI agents, test runners, and long-running processes. Long-running command-line work is easy to start and annoying to supervise: agents, watchers, builds, and shells end up buried in tabs or tmux panes. gmux gives you a live sidebar of everything running across a machine, visible from any browser.

Install

macOS (Homebrew)

brew install gmuxapp/tap/gmux

Linux

curl -sSfL https://gmux.app/install.sh | sh

What does this script do?

Or download both binaries (gmuxd + gmux) from GitHub Releases. On Windows, the Linux instructions work inside WSL.

Run

gmux -- pi              # launch a coding agent
gmux -- npm run dev     # or any long-running command

gmux open               # open the dashboard

Running a command uses the -- separator: everything after it is your command, verbatim. gmux auto-starts the daemon (gmuxd) on first run. gmux open launches the dashboard in a dedicated browser window (Chrome/Chromium app mode when available, otherwise your default browser); bare gmux prints help. If you run commands often, alias gm='gmux --' lets you type gm pi.

Sessions appear in the sidebar grouped by project. The first time, open Settings (sliders icon) → Projects and add your project directory — gmux suggests the directories it discovered from your sessions, so this is one click. Click a session to attach a live terminal.

gmux is also a full CLI: gmux ls, gmux attach <id>, gmux send <id> …, gmux wait <id>, gmux edit <file> — see the CLI reference.

See Using the UI for a full walkthrough.

Join the community

gmux Discord Share your setup, ask questions, report bugs, or just say hi.

Next steps

Using the UI What you see and how to work with it.

Devcontainers One line in devcontainer.json, sessions appear on your host.

Remote Access Access gmux from your phone or another machine.

Configuration Config files, CLI commands, environment variables.

Troubleshooting Dashboard not opening, sessions not appearing, updating.