cmux/README.md
Lawrence Chen 7d6f33c143
Sidebar status as text + detect git HEAD changes instantly (#30)
* Sidebar status as text + detect git HEAD changes instantly

- Replace sidebar status pills with plain text + show more/less toggle
  for a cleaner, more readable sidebar layout
- Watch .git/HEAD mtime in zsh precmd to detect branch changes from
  aliases (gco), tools (gh pr checkout), etc. without waiting for the
  3s polling interval
- Fix NSImage shared instance mutation in DraggableFolderNSView by
  copying before resizing to prevent layout side-effects
- Fix set_status --tab flag being swallowed by -- stop token via
  new parseOptionsNoStop parser
- Update sidebar test to cover alias-based branch switching

* Append status text to notification body automatically

When creating notifications, include the tab's current status entries
in the notification body so users see context (e.g. git branch, ports)
alongside the notification message.

* Add screenshot to README
2026-02-09 14:18:33 -08:00

1.4 KiB

cmuxterm

A lightweight native macOS terminal with vertical tabs and notifications for AI coding agents

Download cmuxterm for macOS

cmuxterm screenshot

Features

  • Native macOS app — Built with Swift and AppKit, not Electron. Fast startup, low memory.
  • Vertical tabs — See all your terminals at a glance in a sidebar
  • Notification panel — Tabs flash when AI agents (Claude Code, Codex) need your attention
  • Lightweight — Small binary, minimal resource footprint. No bundled browser engine.
  • GPU-accelerated — Powered by libghostty for smooth rendering

Install

Homebrew:

brew tap manaflow-ai/cmuxterm
brew install --cask cmuxterm

Or download the DMG directly.

Why cmuxterm?

Running multiple AI coding agents? cmuxterm helps you manage them. Instead of losing track of which terminal needs input, the notification panel shows you exactly where to look.

A native macOS app means it launches instantly, uses minimal RAM, and feels right at home on your Mac.