cmuxcmux/docs

入門指南

cmux 是一個基於 Ghostty 的輕量原生 macOS 終端機，用於管理多個 AI 程式碼代理。它具備垂直分頁、通知面板和基於 socket 的控制 API。

安裝

DMG（推薦）

下載 Mac 版

開啟 .dmg 並將 cmux 拖曳到「應用程式」資料夾。cmux 透過 Sparkle 自動更新，所以你只需要下載一次。

Homebrew

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

之後更新：

brew upgrade --cask cmux
首次啟動時，macOS 可能會要求你確認開啟來自已識別開發者的應用程式。點擊打開以繼續。

驗證安裝

開啟 cmux，你應該會看到：

  • 一個帶有左側垂直分頁側邊欄的終端機視窗
  • 一個已開啟的初始工作區
  • 已準備好接受輸入的 Ghostty 驅動終端機

CLI 設定

cmux 包含一個用於自動化的命令列工具。在 cmux 終端機內會自動運作。若要在 cmux 外部使用 CLI，請建立符號連結：

sudo ln -sf "/Applications/cmux.app/Contents/Resources/bin/cmux" /usr/local/bin/cmux

然後你可以執行以下指令：

cmux list-workspaces
cmux notify --title "Build Complete" --body "Your build finished"

自動更新

cmux 透過 Sparkle 自動檢查更新。當有可用更新時，你會在標題列看到一個更新提示。你也可以透過選單列的 cmux > 檢查更新手動檢查。

工作階段還原（目前行為）

重新啟動後，cmux 僅還原佈局和中繼資料：

  • 視窗、工作區和窗格佈局
  • 工作目錄
  • 終端機捲動回看（盡力而為）
  • 瀏覽器 URL 和瀏覽歷史
cmux 尚不支援還原即時程序狀態。活躍的終端機應用程式工作階段（如 Claude Code、tmux 和 vim）在應用程式重啟後不會恢復。

系統需求

  • macOS 14.0 或更新版本
  • Apple Silicon 或 Intel Mac