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 pytest --watch  # or any command

gmux                 # open the dashboard

gmux auto-starts the daemon (gmuxd) on first run. Running gmux with no arguments opens the dashboard in a dedicated browser window (Chrome/Chromium --app mode when available, otherwise your default browser).

The first time, the sidebar will be empty. Click Add project to pick which project directories appear. Once added, sessions in those directories show up automatically. Click a session to attach a live terminal.

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.