qmux

Free plan Mac

What qmux is

qmux is a macOS desktop terminal multiplexer for launching and managing coding agents. Its interface brings agent launches, queued follow-ups, and status tracking together, with each pane hosting a Metal-rendered Ghostty terminal. Included adapters support Claude Code, Codex, OpenCode, Grok, Muse, Pi, Cursor Agent, and Devin CLI. The follow-up composer can send, queue, steer, edit, and reorder turns, and handle permission prompts where the agent supports it. qmux stores pane, group, agent, transcript, and queued-turn metadata locally for best-effort recovery after a restart; sessions do not synchronize. Users must install and authenticate their own agent CLI tools. The Markdown prompt library supports global and project scopes, placeholders, and a Cmd-K command palette. Terminal groups can connect to another machine over SSH where supported agents and shells run alongside the code they edit. Git worktree creation and the tab-bound browser panel are experimental. The app is free under the MIT license and requires macOS 13 Ventura or later. Linux desktop support is planned.

Who it suits

qmux suits macOS users who want to coordinate coding agents in terminal panes and manage follow-up turns from one interface. It also supports users connecting terminal groups to remote machines over SSH.

What it does well

Adapters for eight named coding agents
Queue, edit, reorder, and steer follow-ups
Local session metadata supports restart recovery
Markdown prompt library has global and project scopes
Free under the MIT license

What to know first

Requires macOS 13 Ventura or later
Linux desktop support is planned
Users install and authenticate agent CLIs themselves
Worktree creation and browser panel are experimental

Limits

qmux is macOS-only for its desktop app, and Linux desktop support is planned. Session data is local, with no session synchronization or collaboration features; Git worktree creation and the browser panel are experimental.

Getting started

Use macOS 13 Ventura or later
Download the universal DMG for Apple Silicon or Intel
Install and authenticate your chosen agent CLI tools
Launch qmux and create terminal panes or groups
Add Markdown prompts to the global or project library
Connect a terminal group over SSH when needed

Verdict

qmux combines agent sessions, terminal panes, follow-up queues, and local recovery in a macOS app. It is a fit for users comfortable setting up their own agent CLIs and working within its platform limits.

Questions

Is qmux free?

Yes. The repository identifies qmux as MIT licensed.

Which operating systems does qmux support?

The desktop app requires macOS 13 Ventura or later. Linux desktop support is planned; selected CLI functions can use remote Linux hosts.

Do I need to install agent tools separately?

Yes. You must install and authenticate your own agent CLI; qmux does not install agents or copy credentials.

Which coding agents have adapters?

Adapters support Claude Code, Codex, OpenCode, Grok, Muse, Pi, Cursor Agent, and Devin CLI.

Can qmux connect to remote machines?

Terminal groups can bind to another machine over SSH, running supported agents and shells beside the code they edit.

Facts from qmux's own pages

Agent integrations: Built-in adapters include Claude Code, Codex, OpenCode, Grok, Muse, Pi, Cursor Agent, and Devin CLI. · github.com, 8 Oct 2026
Browser panel: The experimental browser panel is tab-bound and resizable; token-gated local files are shown in a sandboxed preview. · github.com, 7 Oct 2026
Experimental features: The README describes experimental Git worktree creation for launched agents and an experimental tab-bound browser panel. · github.com, 8 Oct 2026
Follow-up queue: Its follow-up composer can send, queue, steer, edit or reorder queued turns, and approve or deny permission prompts where supported. · github.com, 8 Oct 2026
Follow-ups: The follow-up composer can send, queue, steer, edit, and reorder queued turns, and approve or deny permission prompts where supported. · github.com, 7 Oct 2026
License: The repository lists the project under the MIT license. · github.com, 8 Oct 2026
Platform limitation: The README describes qmux as macOS-only and says Linux support is planned for the future. · github.com, 7 Oct 2026
Prompts: Its prompt library supports Markdown prompts with global and per-project scopes, placeholders, and a Cmd-K command palette. · github.com, 7 Oct 2026
Prompt tools: The prompt library supports Markdown prompts with global and per-project scopes, placeholders, and a Cmd-K command palette. · github.com, 8 Oct 2026
Provider setup: Users must install and authenticate their own agent CLI; qmux says it does not install agents or copy their credentials. · github.com, 8 Oct 2026
Publishing security: For hosted Gist comments, viewer access tokens are stored in encrypted HTTP-only session cookies and used only to create GitHub Gist comments. · github.com, 8 Oct 2026
Purpose: qmux is a desktop terminal multiplexer for coding agents, with a native UI for launching agents, queueing follow-ups, tracking agent status, and driving terminal-based agents. · github.com, 8 Oct 2026
Recovery: qmux persists pane, group, agent, transcript, and queued-turn metadata and offers best-effort recovery after restart. · github.com, 7 Oct 2026
Remote machines: Terminal groups can bind to another machine over SSH, where supported agents and shells run alongside the code they edit. · github.com, 8 Oct 2026
Requirements: The app requires macOS 13 Ventura or later and its DMG is a universal binary for Apple Silicon and Intel Macs. · github.com, 7 Oct 2026
Requirements and limits: The app requires macOS 13 or later; the README says Linux desktop support is planned, while remote Linux hosts are supported for specified qmux CLI functions. · github.com, 8 Oct 2026
Research mode: The v0.2.0 release notes describe Research mode as a way to create a personal knowledge base. · github.com, 8 Oct 2026
Security: The maker says viewer access tokens for hosted Gist comments are stored in encrypted, HTTP-only session cookies and used only to create GitHub Gist comments. · github.com, 7 Oct 2026
Security details: For remote groups, the README says the remote control socket is an owner-only Unix socket forwarded through SSH, with no network TCP listener or bearer token exposed. · github.com, 8 Oct 2026
Session management: qmux supports session and transcript recovery, and can fork supported agent sessions from inside the app or through its CLI. · github.com, 8 Oct 2026
Terminal: On macOS, each pane hosts a Metal-rendered Ghostty terminal surface. · github.com, 7 Oct 2026
Terminal rendering: On macOS, each pane hosts a Metal-rendered Ghostty terminal surface. · github.com, 8 Oct 2026
Worktrees: Git worktree creation for launched agents is experimental and includes dirty-worktree checks and a delete-or-keep prompt when closing worktree-backed panes. · github.com, 7 Oct 2026

Where qmux stands on Freedom251

Terminal Multiplexers#25 of 29