TAU-HOME.COM
LOADING

cmux: Ghostty-Based Native macOS Terminal for AI Coding Agent Multitasking

An open-source Swift and Ghostty-based macOS terminal optimized for parallel AI coding agents like Claude Code and Codex, featuring vertical workspace tabs, age

tau · October 7, 2026

#cmux #terminal #ghostty #ai-agent #claude-code #macos #developer-tools

cmux: Ghostty-Based Native macOS Terminal for AI Coding Agent Multitasking

Open-source development team manaflow-ai has unveiled 'cmux', an open-source native macOS terminal purpose-built for managing parallel execution and multitasking workflows across AI coding agents. Combining a Swift and AppKit native user interface with the high-performance libghostty rendering engine, cmux is tailored to monitor and orchestrate long-running autonomous coding agents such as Claude Code and Codex.

cmux native macOS terminal interface featuring vertical workspace tabs with Git metadata and blue notification rings for AI coding agents

Image source: manaflow-ai/cmux

In standard terminal emulators, tracking the operational state of multiple concurrent AI coding agents is notoriously challenging. When an agent pauses to request permission or await human feedback, the blocked state often goes unnoticed. Developers must constantly cycle through open windows and tabs to check current Git branches, local server ports, and active working directories, incurring heavy context-switching overhead. cmux addresses these friction points by consolidating agent attention states, workspace metadata, and an in-app browser into a single coherent workspace.

libghostty GPU Acceleration and Native Swift/AppKit Architecture

The rendering pipeline in cmux is powered directly by libghostty, the core library behind the modern Ghostty terminal emulator.

  • GPU-Accelerated Terminal Rendering: Provides fluid, high-refresh-rate text output without lag, even under heavy log streaming and rapid agent output generation.
  • Ghostty Configuration Compatibility: Natively recognizes and applies existing ~/.config/ghostty/config files, allowing current Ghostty users to retain fonts, themes, and keybindings without manual reconfiguration.
  • Lightweight Native Implementation: Built with Swift and AppKit rather than an Electron wrapper, maintaining low macOS memory usage and instant UI responsiveness.

AI Agent Attention Rings and Vertical Workspace Tabs

cmux identifies when agents require human intervention using both visual cues and terminal protocol hooks.

  • Blue Notification Rings: When an AI coding agent like Claude Code or Codex halts for user confirmation or command approval, a blue ring highlights the corresponding terminal panel while the sidebar tab lights up, prompting immediate operator attention.
  • Escape Sequence and CLI Integration: Supports terminal standards including OSC 9, OSC 99, and OSC 777 notification sequences, alongside a CLI mechanism for triggering alerts from custom scripts and autonomous agent workflows.
  • Vertical Sidebar Workspace Metadata: The vertical tab strip on the left displays real-time workspace context, including active Git branches, linked Pull Request (PR) numbers and statuses, working directories, active local network ports, and the most recent alert messages. Developers can assess project health at a glance without navigating between tabs.

Scriptable In-App Browser Powered by agent-browser

cmux incorporates a scriptable in-app browser split view powered by agent-browser.

  • Direct Web DOM Interaction: Allows AI agents to interact directly with the DOM tree of local development servers and inspect live rendered output within the application.
  • Automated Testing and Feedback Loops: Following code changes, agents can verify UI adjustments and complete automated E2E tests inside the split-pane browser without launching an external browser window.
  • Programmable Split Panes: Terminal panes and browser views can be dynamically split and reorganized via keyboard shortcuts or CLI commands, establishing flexible multitasking layouts.

Installation Methods and Practical Considerations

cmux offers two official installation channels for macOS users:

  • Homebrew Cask: Install via the terminal command brew install --cask cmux.
  • Direct DMG Package: Download the official DMG image, which includes embedded Sparkle support for seamless in-app updates.

Key environment constraints and operating considerations include:

  • macOS Exclusive: Built entirely on Swift and AppKit, cmux currently runs only on macOS, with no support for Windows or Linux.
  • Monorepos and Managed Mac Environments: In massive repositories or corporate-managed Macs running heavy background security tooling, setting the environment variable CMUX_NO_GIT_WATCH=1 is recommended to mitigate file watcher overhead and minimize Git monitor resource consumption.

Sources