Một terminal macOS dựa trên Ghostty với tab dọc và thông báo cho các agent lập trình AI
English | 日本語 | Tiếng Việt | 简体中文 | 繁體中文 | 한국어 | Deutsch | Español | Français | Italiano | Dansk | Polski | Русский | Bosanski | العربية | Norsk | Português (Brasil) | ไทย | Türkçe | ភាសាខ្មែរ | Українська
Vòng thông báoCác pane có vòng xanh và tab sáng lên khi agent lập trình cần bạn chú ý |
|
Bảng thông báoXem tất cả thông báo đang chờ ở một nơi, nhảy đến thông báo chưa đọc mới nhất |
|
Trình duyệt trong appChia đôi một trình duyệt cạnh terminal với API có thể script, chuyển từ agent-browser |
|
Tab dọc + ngangSidebar hiển thị nhánh git, trạng thái/số PR liên kết, thư mục làm việc, các cổng đang lắng nghe, và dòng thông báo mới nhất. Chia đôi ngang và dọc. |
|
SSHcmux ssh user@remote tạo workspace cho máy từ xa. Các pane trình duyệt định tuyến qua mạng từ xa nên localhost hoạt động bình thường. Kéo ảnh vào phiên từ xa để upload qua scp.
|
|
Claude Code Teamscmux claude-teams chạy chế độ teammate của Claude Code chỉ với một lệnh. Các teammate sinh ra dưới dạng split gốc với metadata sidebar và thông báo. Không cần tmux.
|
|
Mở file `.dmg` và kéo cmux vào thư mục Applications. cmux tự cập nhật qua Sparkle, nên bạn chỉ cần tải một lần.
### Homebrew
```bash
brew tap manaflow-ai/cmux
brew install --cask cmux
```
Cập nhật sau này:
```bash
brew upgrade --cask cmux
```
Lần mở đầu tiên, macOS có thể yêu cầu bạn xác nhận mở app từ nhà phát triển được xác định. Nhấn **Open** để tiếp tục.
## Vì sao cmux?
Tôi chạy rất nhiều phiên Claude Code và Codex song song. Tôi từng dùng Ghostty với nhiều pane chia, và dựa vào thông báo macOS gốc để biết khi nào một agent cần tôi. Nhưng nội dung thông báo của Claude Code luôn chỉ là "Claude is waiting for your input" mà không có ngữ cảnh, và khi mở đủ nhiều tab thì tôi thậm chí không đọc được tiêu đề nữa.
Tôi đã thử vài trình điều phối lập trình nhưng phần lớn là app Electron/Tauri và hiệu năng làm tôi khó chịu. Tôi cũng thích terminal hơn vì các trình điều phối GUI buộc bạn theo workflow của họ. Vì vậy tôi xây cmux như một app macOS gốc bằng Swift/AppKit. Nó dùng libghostty để render terminal và đọc cấu hình Ghostty hiện có của bạn cho theme, font, và màu sắc.
Những bổ sung chính là sidebar và hệ thống thông báo. Sidebar có các tab dọc hiển thị nhánh git, trạng thái/số PR liên kết, thư mục làm việc, các cổng đang lắng nghe, và dòng thông báo mới nhất cho từng workspace. Hệ thống thông báo bắt các chuỗi terminal (OSC 9/99/777) và có CLI (`cmux notify`) để bạn nối vào hook của agent cho Claude Code, OpenCode, v.v. Khi một agent đang chờ, pane của nó có vòng xanh và tab sáng lên ở sidebar, nên tôi có thể biết cái nào cần tôi giữa các split và tab. Cmd+Shift+U nhảy đến thông báo chưa đọc mới nhất.
Trình duyệt trong app có API script được chuyển từ [agent-browser](https://github.com/vercel-labs/agent-browser). Agent có thể chụp cây accessibility, lấy tham chiếu phần tử, click, điền form, và chạy JS. Bạn có thể chia một pane trình duyệt cạnh terminal và để Claude Code tương tác trực tiếp với dev server của bạn.
Mọi thứ đều có thể script thông qua CLI và socket API — tạo workspace/tab, chia pane, gửi phím, mở URL trong trình duyệt.
## Thiền của cmux
cmux không áp đặt cách developer sử dụng công cụ. Nó là một terminal và trình duyệt có CLI, và phần còn lại là do bạn quyết định.
cmux là một nguyên thủy, không phải giải pháp. Nó cung cấp terminal, trình duyệt, thông báo, workspace, split, tab, và một CLI để điều khiển tất cả. cmux không ép bạn theo một cách dùng agent lập trình đầy định kiến. Bạn xây gì từ những nguyên thủy đó là của bạn.
Những developer giỏi nhất luôn tự xây công cụ của mình. Chưa ai tìm ra cách tốt nhất để làm việc với agent, và các đội ngũ xây sản phẩm đóng chắc chắn cũng chưa. Những developer gần codebase của họ nhất sẽ tìm ra trước.
Trao cho một triệu developer những nguyên thủy có thể ghép, và họ sẽ cùng nhau tìm ra workflow hiệu quả nhất nhanh hơn bất kỳ đội sản phẩm nào có thể thiết kế theo hướng top-down.
## Tài liệu
Để biết thêm về cách cấu hình cmux, [xem tài liệu của chúng tôi](https://cmux.com/docs/getting-started?utm_source=readme).
## Phím tắt
### Workspace
| Phím tắt | Hành động |
|----------|--------|
| ⌘ N | Workspace mới |
| ⌘ 1–8 | Nhảy đến workspace 1–8 |
| ⌘ 9 | Nhảy đến workspace cuối |
| ⌃ ⌘ ] | Workspace tiếp theo |
| ⌃ ⌘ [ | Workspace trước |
| ⌘ ⇧ W | Đóng workspace |
| ⌘ ⇧ R | Đổi tên workspace |
| ⌥ ⌘ E | Sửa mô tả workspace |
| ⌘ B | Bật/tắt sidebar |
| ⌥ ⌘ B | Bật/tắt sidebar bên phải |
| ⌘ ⇧ E | Bật/tắt focus sidebar bên phải |
### Surface
| Phím tắt | Hành động |
|----------|--------|
| ⌘ T | Surface mới |
| ⌘ ⇧ ] | Surface tiếp theo |
| ⌘ ⇧ [ | Surface trước |
| ⌃ Tab | Surface tiếp theo |
| ⌃ ⇧ Tab | Surface trước |
| ⌃ 1–8 | Nhảy đến surface 1–8 |
| ⌃ 9 | Nhảy đến surface cuối |
| ⌘ W | Đóng surface |
### Chia pane
| Phím tắt | Hành động |
|----------|--------|
| ⌘ D | Chia sang phải |
| ⌘ ⇧ D | Chia xuống dưới |
| ⌥ ⌘ ← → ↑ ↓ | Đổi focus pane theo hướng |
| ⌘ ⇧ H | Nhấp nháy panel đang focus |
### Trình duyệt
Phím tắt công cụ developer của trình duyệt theo mặc định Safari và có thể tùy chỉnh trong `Settings → Keyboard Shortcuts`.
Các phím tắt điều hướng bảng lệnh, bao gồm ⌃ P, cũng có thể tùy chỉnh và xóa đi để phím được gửi tới terminal đang hoạt động.
| Phím tắt | Hành động |
|----------|--------|
| ⌘ ⇧ L | Mở trình duyệt trong pane chia |
| ⌘ L | Focus thanh địa chỉ |
| ⌘ [ | Quay lại |
| ⌘ ] | Tiến tới |
| ⌘ R | Tải lại trang |
| ⌥ ⌘ I | Bật/tắt Developer Tools (mặc định Safari) |
| ⌥ ⌘ C | Hiện JavaScript Console (mặc định Safari) |
### Thông báo
| Phím tắt | Hành động |
|----------|--------|
| ⌘ I | Hiện bảng thông báo |
| ⌘ ⇧ U | Nhảy đến thông báo chưa đọc mới nhất |
| ⌥ ⌘ U | Bật/tắt trạng thái chưa đọc của mục hiện tại |
| ⌃ ⌘ U | Đánh dấu mục hiện tại là chưa đọc cũ nhất và nhảy đến mục chưa đọc mới nhất tiếp theo |
### Tìm kiếm
| Phím tắt | Hành động |
|----------|--------|
| ⌘ F | Tìm |
| ⌘ ⇧ F | Tìm trong thư mục |
| ⌘ G / ⌥ ⌘ G | Tìm tiếp / tìm trước |
| ⌥ ⌘ ⇧ F | Ẩn thanh tìm |
| ⌘ E | Dùng vùng chọn để tìm |
### Terminal
| Phím tắt | Hành động |
|----------|--------|
| ⌘ K | Xóa scrollback |
| ⌘ C | Sao chép (khi có chọn) |
| ⌘ V | Dán |
| ⌘ + / ⌘ - | Tăng / giảm cỡ chữ |
| ⌘ 0 | Đặt lại cỡ chữ |
### Cửa sổ
| Phím tắt | Hành động |
|----------|--------|
| ⌘ ⇧ N | Cửa sổ mới |
| ⌘ ⇧ O | Mở lại phiên trước |
| ⌘ , | Cài đặt |
| ⌘ ⇧ , | Tải lại cấu hình |
| ⌘ Q | Thoát |
## Bản dựng Nightly
[Tải cmux NIGHTLY](https://github.com/manaflow-ai/cmux/releases/download/nightly/cmux-nightly-macos.dmg)
cmux NIGHTLY là một app riêng với bundle ID riêng, nên có thể chạy song song với bản ổn định. Được build tự động từ commit `main` mới nhất và tự cập nhật qua feed Sparkle riêng.
Báo lỗi nightly trên [GitHub Issues](https://github.com/manaflow-ai/cmux/issues) hoặc trong [#nightly-bugs trên Discord](https://discord.gg/xsgFEVrWCZ).
## Khôi phục phiên
Khi thoát, cmux lưu phiên hiện tại. Khi mở lại, cmux khôi phục trạng thái thuộc về app:
- Bố cục cửa sổ/workspace/pane
- Thư mục làm việc
- Scrollback của terminal (cố gắng hết mức)
- URL và lịch sử điều hướng của trình duyệt
cmux không checkpoint trạng thái tiến trình đang chạy bất kỳ. tmux, vim, shell và app terminal chưa hỗ trợ sẽ mở lại như terminal bình thường.
Các phiên agent được hỗ trợ có thể tiếp tục khi hooks đã lưu ID phiên gốc. Cài hooks sau khi cài CLI của agent để binary của nó nằm trên `PATH`:
```bash
cmux hooks setup
cmux hooks setup codex
cmux hooks setup --agent opencode
```
`cmux hooks setup` cài các agent được hỗ trợ mà nó tìm thấy và in bản tóm tắt cho các agent bị bỏ qua. Các tích hợp resume được hỗ trợ gồm Claude Code, Codex, Grok, OpenCode, Pi, Amp, Cursor CLI, Gemini, Rovo Dev, Copilot, CodeBuddy, Factory, và Qoder. Claude Code được xử lý bởi wrapper Claude của cmux khi tích hợp Claude được bật trong Settings.
Người dùng nâng cao và tích hợp có thể gắn lệnh khôi phục tùy chỉnh vào surface terminal hiện tại. Điều này hữu ích cho công cụ có trạng thái bền riêng, như phiên tmux hoặc CLI agent tùy chỉnh:
```bash
cmux surface resume set --kind tmux --checkpoint work --shell "tmux attach -t work"
cmux surface resume show --json
cmux surface resume clear --checkpoint work
```
Binding này vẫn gắn với surface của cmux. Binding tạo qua CLI công khai hoặc socket được lưu để kiểm tra và resume thủ công trừ khi bạn phê duyệt một tiền tố lệnh đã ký để tự động resume. Các tiền tố được phê duyệt cũng gắn với thư mục làm việc và giá trị môi trường chính xác, khi có. Xem hoặc sửa phê duyệt trong **Settings > Terminal > Resume Commands**. cmux chỉ tự động chạy những resume binding được đánh dấu là đáng tin cậy, ví dụ binding tmux phát hiện từ process đang chạy hoặc tiền tố được người dùng phê duyệt. Các khóa môi trường nhạy cảm như token, mật khẩu, secret và API key sẽ bị loại bỏ trước khi lưu resume binding.
Để giữ các terminal agent đã khôi phục ở trạng thái nhàn rỗi thay vì tự động chạy lệnh resume của chúng, hãy tắt **Settings > Terminal > Resume Agent Sessions on Reopen** hoặc đặt thiết lập này trong `~/.config/cmux/cmux.json`:
```json
{
"terminal": {
"autoResumeAgentSessions": false
}
}
```
Điều này chỉ tắt lệnh resume tự động của agent. cmux vẫn khôi phục bố cục, thư mục làm việc, scrollback, và lịch sử trình duyệt đã lưu.
Nếu bạn cần áp dụng lại bản snapshot đã lưu gần nhất theo cách thủ công, hãy dùng:
- `File > Reopen Previous Session`
- `⌘ ⇧ O`
- `cmux restore-session`
Bên trong, cmux ghi một snapshot có phiên bản tại `~/Library/Application Support/cmux/` và các agent hook ghi ánh xạ phiên tại `~/.cmuxterm/`. Khi khôi phục, cmux dựng lại bố cục trước, rồi chạy lệnh resume gốc của agent được hỗ trợ khi resume agent tự động được bật.
Đọc hướng dẫn đầy đủ tại
WeChat: Quét mã QR để tham gia cộng đồng.
