基礎

入門指南

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

安裝

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

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

之後更新：

brew upgrade --cask cmux

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

開啟 cmux，你應該會看到：

cmux 包含一個用於自動化的命令列工具。在 cmux 終端機內會自動運作。若要在其他終端機中使用，請開啟指令面板（⌘⇧P）並執行Shell 指令：將「cmux」安裝至 PATH。它會把內建的 CLI 連結到 /usr/local/bin，若該資料夾需要權限，會要求輸入管理員密碼。

也可以自行建立符號連結：

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"

若要讓從 Finder 開啟的 ssh:// 連結和 shell 腳本在 cmux 而非「終端機」中開啟，請在選單列選擇cmux > 將 cmux 設為預設終端機，或在指令面板中執行將 cmux 設為預設終端機。

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

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

cmux 尚不支援還原即時程序狀態。活躍的終端機應用程式工作階段（如 Claude Code、tmux 和 vim）在應用程式重啟後不會恢復。

See the session restore guide for agent hook setup and the supported resume matrix.

這個頁面對你有幫助嗎？