這是一款基於 Ghostty 的 macOS 終端機,具備垂直分頁與 AI 編碼代理通知功能。
將 .dmg 檔案打開並將 cmux 拖曳至「應用程式」檔案夾。cmux 透過 Sparkle 自動更新,因此您只需下載一次。
首次啟動時,macOS 可能會要求您確認開啟由已識別開發者提供的應用程式。點選「打開」繼續。
我同時運行許多 Claude Code 和 Codex 工作階段。我曾使用 Ghostty 並搭配許多分割畫面,並依賴 macOS 原生通知來得知代理程式何時需要我。但 Claude Code 的通知內文總是只有「Claude 正在等待您的輸入」,沒有任何上下文,而且當開啟足夠多的分頁時,我甚至無法再讀取標題。
我嘗試了幾個程式碼編排工具,但大多數都是 Electron/Tauri 應用程式,其效能讓我感到困擾。我也比較偏好終端機,因為圖形介面的編排工具會將您鎖定在其工作流程中。因此,我用 Swift/AppKit 以原生 macOS 應用程式的方式建構了 cmux。它使用 libghostty 進行終端機渲染,並讀取您現有的 Ghostty 設定檔以獲取佈景主題、字型和顏色。
主要的增添功能是側邊欄和通知系統。側邊欄具有垂直分頁,可顯示 git 分支、連結的 PR 狀態/編號、工作目錄、監聽的連接埠,以及每個工作區的最新通知文字。通知系統會接收終端機序列 (OSC 9/99/777),並提供一個 CLI (cmux notify),您可以將其連結到 Claude Code、OpenCode 等代理程式的掛鉤。當代理程式正在等待時,其窗格會出現藍色光環,側邊欄中的分頁也會亮起,讓我在分割畫面和分頁之間能分辨出哪個需要我。Cmd+Shift+U 可跳至最近未讀的通知。
內建瀏覽器具有一個可透過腳本控制的 API,該 API 是從 agent-browser 移植而來的。代理程式可以擷取輔助功能樹的快照、取得元素參考、點擊、填寫表單以及執行 JavaScript。您可以將瀏覽器窗格分割在終端機旁邊,讓 Claude Code 直接與您的開發伺服器互動。
一切都可以透過 CLI 和 socket API 進行腳本化 — 建立工作區/分頁、分割窗格、傳送按鍵、開啟 URL 到瀏覽器。
cmux 並不預設開發者應如何管理他們的工具。它是一個終端機和瀏覽器,帶有一個 CLI,其餘的由您決定。
cmux 是一個基礎元件,而非解決方案。它提供您終端機、瀏覽器、通知、工作區、分割畫面、分頁,以及一個控制所有這些功能的 CLI。cmux 不會強迫您採用特定的使用 AI 編碼代理程式的方式。您用這些基礎元件建構的內容屬於您。
最優秀的開發者一直以來都在建構自己的工具。目前還沒有人找到與代理程式協作的最佳方法,而那些建構封閉產品的團隊也肯定沒有。最接近自身程式碼庫的開發者將會最先找到方法。
給予百萬名開發者可組合的基礎元件,他們將能比任何頂層設計的產品團隊更快地共同找出最高效的工作流程。
如需更多關於如何設定 cmux 的資訊,請前往我們的文件。
瀏覽器開發者工具的快捷鍵遵循 Safari 的預設設定,並可在「設定」→「鍵盤快捷鍵」中自訂。指令盤導覽快捷鍵,包括 ⌃ P,也可自訂,並可清除,以便按鍵能傳遞至作用中的終端機。
cmux NIGHTLY 是一個獨立的應用程式,擁有自己的套件 ID,因此可以與穩定版本並存。它會從最新的 main commit 自動建置,並透過其自身的 Sparkle feed 自動更新。
請在 GitHub Issues 或 Discord 的 #nightly-bugs 頻道回報 nightly 版本錯誤。
關閉 cmux 會儲存目前的會話。重新啟動時,cmux 會恢復應用程式擁有的狀態:
cmux 不會檢查點任意的即時程序狀態。tmux、vim、shell 和不支援的終端機應用程式會像正常終端機一樣重新開啟。
支援的代理程式會話可以在掛鉤已儲存原生會話 ID 時恢復。請在安裝代理程式 CLI 後安裝掛鉤,以便其二進位檔位於 PATH 上:
cmux hooks setup 會安裝它能找到的支援代理程式,並列印被略過的代理程式摘要。支援的恢復整合包括 Claude Code、Codex、Grok、OpenCode、Pi、Amp、Cursor CLI、Gemini、Rovo Dev、Copilot、CodeBuddy、Factory 和 Qoder。Claude Code 由 cmux Claude 包裝器處理,當在「設定」中啟用 Claude 整合時。
進階使用者和整合可以將自訂恢復命令附加到目前的終端機介面上。這對於擁有自身持久狀態的工具很有用,例如 tmux 會話或自訂代理程式 CLI:
綁定會附加到 cmux 介面上。公開的 CLI 或 socket 建立的綁定會被儲存以供檢查和手動恢復,除非您批准簽署的命令前綴以進行自動恢復。批准的前綴也會綁定到工作目錄和確切的環境值(如果存在)。請在「設定」>「終端機」>「恢復命令」中審查或編輯批准。
cmux 只會自動運行它標記為信任的恢復綁定,例如即時程序偵測到的 tmux 綁定或使用者批准的前綴。敏感的環境金鑰,如令牌、密碼、秘密和 API 金鑰,會在儲存恢復綁定之前被刪除。
若要在恢復代理程式終端機時使其保持閒置,而不是自動運行其恢復命令,請關閉「設定」>「終端機」>「重新開啟時恢復代理程式會話」,或在 ~/.config/cmux/cmux.json 中設定:
這只會停用自動代理程式恢復命令。cmux 仍會恢復儲存的佈局、工作目錄、捲動緩衝區和瀏覽器歷史記錄。
如果您需要手動重新套用最後儲存的快照,請使用:
在底層,cmux 會在 ~/Library/Application Support/cmux/ 下寫入一個版本化的快照,而代理程式掛鉤會在 ~/.cmuxterm/ 下寫入會話映射。恢復時,cmux 會先重建佈局,然後在啟用自動代理程式恢復時運行支援代理程式的原生恢復命令。
請參閱完整指南:https://cmux.com/docs/session-restore 。
cmux 並非 Ghostty 的分支。它使用 libghostty 作為終端機渲染的函式庫,就像應用程式使用 WebKit 來顯示網頁一樣。Ghostty 是一個獨立的終端機;cmux 是一個建立在其渲染引擎之上的不同應用程式。
目前僅支援 macOS。
是的,處於測試階段。從「行動裝置連接」視窗配對您的 iPhone 與 Mac,並從手機連接到您的終端機,可選擇性地轉發終端機通知。它透過 TestFlight 以 cmux BETA 的形式發佈。早期存取包含在 cmux Founders Edition 中。請參閱 iOS 文件。
所有代理程式。cmux 是一個終端機,因此任何在終端機中運行的代理程式都可以開箱即用:Claude Code、Codex、OpenCode、Gemini CLI、Kiro、Aider、Goose、Amp、Cline、Cursor Agent,以及任何您可以從命令列啟動的其他代理程式。
是的。當代理程式產生子代理程式或團隊成員時,cmux 會將它們轉換為原生窗格和分割畫面,而不是隱藏的背景程序。它支援 Claude Code 團隊和 oh-my-opencode 多模型協調,因此運行中的每個代理程式都可見且可控。
是的。透過 SSH 開啟工作區並連接到遠端 tmux 會話,以便代理程式可以在遠端主機上運行,而您可以從 cmux 操作它們。請參閱 SSH 和遠端。
當程序需要注意時,cmux 會在窗格周圍顯示通知環、側邊欄中的未讀徽章、通知彈出視窗和 macOS 桌面通知。這些會透過標準終端機轉義序列 (OSC 9/99/777) 自動觸發,或者您可以使用 cmux CLI 和代理程式掛鉤來觸發。任何支援掛鉤或 OSC 的代理程式都可以工作,包括 Claude Code、Codex、OpenCode 和 pi。
是的。每個動作都可透過 cmux CLI 和 Unix socket 進行:建立工作區、開啟分割窗格、傳送輸入、讀取螢幕內容、擷取螢幕截圖,以及操作內建瀏覽器。請參閱 CLI 參考和瀏覽器自動化文件。
cmux 可以將真實的瀏覽器窗格分割在您的終端機旁邊,並且是完全可程式化的:透過相同的 socket API 進行導覽、擷取 DOM 快照、點擊、輸入、執行 JavaScript,以及讀取主控台和網路活動。代理程式使用它來驗證自身的網頁變更,而無需離開 cmux。請參閱瀏覽器自動化。
是的。技能是可重複使用的工作流程,您可以提供給任何在 cmux 中運行的代理程式,用於 CLI 控制、工作區自動化、設定和瀏覽器介面等用途。請瀏覽 cmux-skills 的開放收藏集,或閱讀技能文件。
終端機按鍵綁定是從您的 Ghostty 設定檔(~/.config/ghostty/config)讀取的。cmux 特定的快捷鍵(工作區、分割畫面、瀏覽器、通知)可在「設定」中自訂。請參閱預設快捷鍵以取得完整列表。
是的。終端機渲染使用您的 Ghostty 設定檔,因此佈景主題、字型、顏色和游標會直接沿用。cmux 本身的設定(位於 ~/.config/cmux/cmux.json)控制側邊欄、分頁列、分割窗格和行為,並且每個鍵盤快捷鍵都可編輯。請參閱設定。
是的。重新啟動時,cmux 會恢復您的視窗、工作區、窗格、工作目錄和捲動緩衝區,並且狀態會在電腦完全重新啟動後仍然保留,而不僅僅是關閉應用程式。Claude Code、Codex 和 OpenCode 等代理程式會話也會恢復。請參閱會話恢復。
tmux 是一個在任何終端機中運行的終端機多工處理器。cmux 是一個具有圖形介面的原生 macOS 應用程式:垂直分頁、分割窗格、嵌入式瀏覽器和 socket API,所有功能都內建,無需設定檔或前綴鍵。也就是說,許多人樂於將 cmux 與 SSH 和 tmux 一起使用,而且 cmux 可以原生連接到您的遠端 tmux 會話(測試版)。
是的,cmux 可免費使用。原始碼可在 GitHub 上取得。
cmux 是免費且開源的,未來也將始終如此。如果您想支持開發並提前獲得接下來的內容,包括 cmux AI、iOS 應用程式和 Cloud VM,請查看 cmux Founders Edition。
我們很樂意聽取您的意見。請在 GitHub 上開啟 issue 或 pull request,或發送電子郵件給我們。
WeChat:掃描 QR 碼加入社群。
cmux 是免費、開源且將永遠如此。如果您想支持開發並提前獲得即將推出的內容:
cmux 採用 GPL-3.0-or-later 授權開源。
基於 Ghostty 的開源 macOS 終端機,具備垂直分頁與 AI 編碼代理通知功能。專為多工處理、組織與程式設計而建。