Repolode
Submit
manaflow-ai

manaflow-ai/cmux

A native macOS terminal built on libghostty, with vertical tabs, agent-aware notifications and a scriptable CLI for running AI coding agents in parallel.

Open-source alternative to:tmuxiTerm2

View on GitHubWebsite
Stars
28,279
Forks
2,542
Open issues
3,386
Last commit
20 hours ago

What is it?

cmux is a macOS terminal app for developers who run several AI coding agents such as Claude Code or Codex at once. It is built with Swift and AppKit rather than Electron, uses libghostty for rendering, and reads an existing Ghostty config for themes, fonts and colors.

The sidebar uses vertical tabs that show each workspace's git branch, linked PR status, working directory, listening ports and latest notification text. When an agent needs input, its pane gets a blue ring and the matching tab lights up. Terminal notification sequences (OSC 9/99/777) and a `cmux notify` command can be wired into agent hooks.

A split-pane in-app browser has a scriptable API ported from agent-browser, so agents can inspect pages, click and fill forms. The CLI and Unix socket expose workspaces, panes, keystrokes and browser actions. The app runs on macOS only.

Key features

  • 01Vertical tabs show git branch, PR status, working directory and listening ports per workspace.
  • 02Panes and tabs highlight when a coding agent needs attention.
  • 03Split-pane browser with a scriptable API for agent-driven web testing.
  • 04CLI and socket API for creating workspaces, splitting panes and sending keystrokes.
  • 05Session restore for window layout, working directories and browser history.
  • 06Reads existing Ghostty config for themes, fonts and colors.

Use cases

  • Running several Claude Code or Codex sessions in parallel and seeing which one is waiting.
  • Letting an agent open a dev server in a split browser pane and verify its own web changes.
  • Connecting to remote machines over SSH with workspaces that keep the sidebar metadata.

Quick start

  1. 1

    Download the DMG from the releases page and drag cmux to Applications

  2. 2

    Add the Homebrew tap

    brew tap manaflow-ai/cmux
  3. 3

    Install the cmux cask with Homebrew

    brew install --cask cmux

Things to know

  • macOS only: cmux is a native macOS app built with Swift and AppKit.
  • Licensed under GPL, a copyleft license, though the repository metadata reports no clear license.

Topics

#terminal#coding-agents#macos#ai-agents#multiplexer#swift#ghostty#developer-tools#amp#claude-code

FAQ

What is cmux?
A native macOS terminal built on libghostty, with vertical tabs, agent-aware notifications and a scriptable CLI for running AI coding agents in parallel. cmux is a macOS terminal app for developers who run several AI coding agents such as Claude Code or Codex at once. It is built with Swift and AppKit rather than Electron, uses libghostty for rendering, and reads an existing Ghostty config for themes, fonts and colors.
Is cmux free to use? What license does it have?
cmux is open source under the Other license. Check the license terms before using it in commercial products.
Is cmux still maintained?
Actively maintained. The last commit to cmux was on Oct 19, 2026.
What can I use cmux for?
Running several Claude Code or Codex sessions in parallel and seeing which one is waiting. Letting an agent open a dev server in a split browser pane and verify its own web changes. Connecting to remote machines over SSH with workspaces that keep the sidebar metadata.
How do I install cmux?
Download the DMG from the releases page and drag cmux to Applications Add the Homebrew tap: brew tap manaflow-ai/cmux Install the cmux cask with Homebrew: brew install --cask cmux
Where can I get cmux?
The source code and installation instructions are on GitHub: https://github.com/manaflow-ai/cmux

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects