Terminal macOS oparty na Ghostty z pionowymi kartami i powiadomieniami dla agentów kodowania AI
English | 日本語 | Tiếng Việt | 简体中文 | 繁體中文 | 한국어 | Deutsch | Español | Français | Italiano | Dansk | Polski | Русский | Bosanski | العربية | Norsk | Português (Brasil) | ไทย | Türkçe | ភាសាខ្មែរ | Українська
▶ Film demonstracyjny · The Zen of cmux
## Funkcje
Pierścienie powiadomieńPanele otrzymują niebieski pierścień, a karty podświetlają się, gdy agenci kodowania potrzebują Twojej uwagi |
|
Panel powiadomieńZobacz wszystkie oczekujące powiadomienia w jednym miejscu, przeskocz do najnowszego nieprzeczytanego |
|
Wbudowana przeglądarkaPodziel przeglądarkę obok terminala ze skryptowalnym API przeniesionym z agent-browser |
|
Pionowe + poziome kartyPasek boczny pokazuje gałąź git, status/numer powiązanego PR, katalog roboczy, nasłuchujące porty i tekst ostatniego powiadomienia. Podziały poziome i pionowe. |
|
SSHcmux ssh user@remote tworzy przestrzeń roboczą dla zdalnej maszyny. Panele przeglądarki kierowane są przez zdalną sieć, więc localhost po prostu działa. Przeciągnij obraz do sesji zdalnej, aby przesłać go przez scp.
|
|
Claude Code Teamscmux claude-teams uruchamia tryb współpracy Claude Code jednym poleceniem. Współpracownicy pojawiają się jako natywne podziały z metadanymi w pasku bocznym i powiadomieniami. Nie wymaga tmux.
|
|
Otwórz plik `.dmg` i przeciągnij cmux do folderu Aplikacje. cmux aktualizuje się automatycznie przez Sparkle, więc musisz pobrać go tylko raz.
### Homebrew
```bash
brew tap manaflow-ai/cmux
brew install --cask cmux
```
Aby zaktualizować później:
```bash
brew upgrade --cask cmux
```
Przy pierwszym uruchomieniu macOS może poprosić o potwierdzenie otwarcia aplikacji od zidentyfikowanego dewelopera. Kliknij **Otwórz**, aby kontynuować.
## Dlaczego cmux?
Uruchamiam wiele sesji Claude Code i Codex równolegle. Używałem Ghostty z masą podzielonych paneli i polegałem na natywnych powiadomieniach macOS, żeby wiedzieć, kiedy agent mnie potrzebuje. Ale treść powiadomienia Claude Code to zawsze tylko „Claude is waiting for your input" bez kontekstu, a przy wystarczającej liczbie otwartych kart nie mogłem nawet przeczytać tytułów.
Wypróbowałem kilka orkiestratorów kodowania, ale większość z nich to aplikacje Electron/Tauri, a ich wydajność mi przeszkadzała. Po prostu wolę też terminal, ponieważ orkiestratory GUI zamykają cię w swoim przepływie pracy. Dlatego zbudowałem cmux jako natywną aplikację macOS w Swift/AppKit. Używa libghostty do renderowania terminala i odczytuje istniejącą konfigurację Ghostty dla motywów, czcionek i kolorów.
Główne dodatki to pasek boczny i system powiadomień. Pasek boczny ma pionowe karty pokazujące gałąź git, status/numer powiązanego PR, katalog roboczy, nasłuchujące porty i tekst ostatniego powiadomienia dla każdej przestrzeni roboczej. System powiadomień przechwytuje sekwencje terminala (OSC 9/99/777) i ma CLI (`cmux notify`), który można podpiąć do hooków agentów dla Claude Code, OpenCode itp. Gdy agent czeka, jego panel otrzymuje niebieski pierścień, a karta podświetla się w pasku bocznym, więc mogę powiedzieć, który mnie potrzebuje, niezależnie od podziałów i kart. Cmd+Shift+U przeskakuje do najnowszego nieprzeczytanego.
Wbudowana przeglądarka ma skryptowalny API przeniesiony z [agent-browser](https://github.com/vercel-labs/agent-browser). Agenci mogą wykonać migawkę drzewa dostępności, uzyskać referencje elementów, klikać, wypełniać formularze i ewaluować JS. Możesz podzielić panel przeglądarki obok terminala i pozwolić Claude Code bezpośrednio komunikować się z Twoim serwerem deweloperskim.
Wszystko jest skryptowalne przez CLI i socket API — tworzenie przestrzeni roboczych/kart, dzielenie paneli, wysyłanie naciśnięć klawiszy, otwieranie URL-ów w przeglądarce.
## The Zen of cmux
cmux nie narzuca programistom sposobu korzystania z narzędzi. To terminal i przeglądarka z CLI, a reszta zależy od Ciebie.
cmux jest prymitywem, nie rozwiązaniem. Daje Ci terminal, przeglądarkę, powiadomienia, przestrzenie robocze, podziały, karty i CLI do kontrolowania tego wszystkiego. cmux nie zmusza Cię do określonego sposobu korzystania z agentów kodowania. To, co zbudujesz z tych prymitywów, jest Twoje.
Najlepsi programiści zawsze budowali własne narzędzia. Nikt jeszcze nie wymyślił najlepszego sposobu pracy z agentami, a zespoły budujące zamknięte produkty też tego nie odkryły. Programiści najbliżej swoich własnych baz kodu wymyślą to pierwsi.
Daj milionowi programistów kompozycyjne prymitywy, a wspólnie znajdą najefektywniejsze przepływy pracy szybciej, niż jakikolwiek zespół produktowy mógłby zaprojektować odgórnie.
## Dokumentacja
Więcej informacji o konfiguracji cmux znajdziesz w [naszej dokumentacji](https://cmux.com/docs/getting-started?utm_source=readme).
## Skróty Klawiszowe
### Przestrzenie robocze
| Skrót | Akcja |
|----------|--------|
| ⌘ N | Nowa przestrzeń robocza |
| ⌘ 1–8 | Przejdź do przestrzeni roboczej 1–8 |
| ⌘ 9 | Przejdź do ostatniej przestrzeni roboczej |
| ⌃ ⌘ ] | Następna przestrzeń robocza |
| ⌃ ⌘ [ | Poprzednia przestrzeń robocza |
| ⌘ ⇧ W | Zamknij przestrzeń roboczą |
| ⌘ ⇧ R | Zmień nazwę przestrzeni roboczej |
| ⌥ ⌘ E | Edytuj opis przestrzeni roboczej |
| ⌘ B | Przełącz pasek boczny |
| ⌥ ⌘ B | Przełącz prawy pasek boczny |
| ⌘ ⇧ E | Przełącz fokus prawego paska bocznego |
### Powierzchnie
| Skrót | Akcja |
|----------|--------|
| ⌘ T | Nowa powierzchnia |
| ⌘ ⇧ ] | Następna powierzchnia |
| ⌘ ⇧ [ | Poprzednia powierzchnia |
| ⌃ Tab | Następna powierzchnia |
| ⌃ ⇧ Tab | Poprzednia powierzchnia |
| ⌃ 1–8 | Przejdź do powierzchni 1–8 |
| ⌃ 9 | Przejdź do ostatniej powierzchni |
| ⌘ W | Zamknij powierzchnię |
### Podzielone Panele
| Skrót | Akcja |
|----------|--------|
| ⌘ D | Podziel w prawo |
| ⌘ ⇧ D | Podziel w dół |
| ⌥ ⌘ ← → ↑ ↓ | Fokus panelu kierunkowo |
| ⌘ ⇧ H | Mignij fokusowanym panelem |
### Przeglądarka
Skróty narzędzi deweloperskich przeglądarki odpowiadają domyślnym ustawieniom Safari i można je dostosować w `Ustawienia → Skróty klawiszowe`.
Skróty nawigacji w palecie poleceń, w tym ⌃ P, również można dostosować i wyczyścić, aby naciśnięcie klawisza dotarło do aktywnego terminala.
| Skrót | Akcja |
|----------|--------|
| ⌘ ⇧ L | Otwórz przeglądarkę w podziale |
| ⌘ L | Fokus na pasku adresu |
| ⌘ [ | Wstecz |
| ⌘ ] | Do przodu |
| ⌘ R | Przeładuj stronę |
| ⌥ ⌘ I | Przełącz Narzędzia Deweloperskie (domyślne Safari) |
| ⌥ ⌘ C | Pokaż Konsolę JavaScript (domyślne Safari) |
### Powiadomienia
| Skrót | Akcja |
|----------|--------|
| ⌘ I | Pokaż panel powiadomień |
| ⌘ ⇧ U | Przejdź do najnowszego nieprzeczytanego |
| ⌥ ⌘ U | Przełącz stan przeczytania bieżącego elementu |
| ⌃ ⌘ U | Oznacz bieżący element jako najstarszy nieprzeczytany i przejdź do następnego najnowszego nieprzeczytanego |
### Szukaj
| Skrót | Akcja |
|----------|--------|
| ⌘ F | Szukaj |
| ⌘ ⇧ F | Szukaj w katalogu |
| ⌘ G / ⌥ ⌘ G | Znajdź następny / poprzedni |
| ⌥ ⌘ ⇧ F | Ukryj pasek wyszukiwania |
| ⌘ E | Użyj zaznaczenia do wyszukiwania |
### Terminal
| Skrót | Akcja |
|----------|--------|
| ⌘ K | Wyczyść scrollback |
| ⌘ C | Kopiuj (z zaznaczeniem) |
| ⌘ V | Wklej |
| ⌘ + / ⌘ - | Zwiększ / zmniejsz rozmiar czcionki |
| ⌘ 0 | Resetuj rozmiar czcionki |
### Okno
| Skrót | Akcja |
|----------|--------|
| ⌘ ⇧ N | Nowe okno |
| ⌘ ⇧ O | Ponownie otwórz poprzednią sesję |
| ⌘ , | Ustawienia |
| ⌘ ⇧ , | Przeładuj konfigurację |
| ⌘ Q | Zakończ |
## Wersje Nightly
[Pobierz cmux NIGHTLY](https://github.com/manaflow-ai/cmux/releases/download/nightly/cmux-nightly-macos.dmg)
cmux NIGHTLY to osobna aplikacja z własnym identyfikatorem pakietu, więc działa obok wersji stabilnej. Budowana automatycznie z najnowszego commitu `main` i aktualizuje się automatycznie przez własny kanał Sparkle.
Zgłaszaj błędy wersji nightly w [GitHub Issues](https://github.com/manaflow-ai/cmux/issues) lub na [#nightly-bugs na Discordzie](https://discord.gg/xsgFEVrWCZ).
## Przywracanie sesji
Po zamknięciu cmux zapisuje bieżącą sesję. Po ponownym uruchomieniu cmux przywraca stan należący do aplikacji:
- Układ okien/przestrzeni roboczych/paneli
- Katalogi robocze
- Scrollback terminala (najlepsza próba)
- URL przeglądarki i historia nawigacji
cmux nie tworzy checkpointów dowolnego stanu działających procesów. tmux, vim, powłoki i nieobsługiwane aplikacje terminalowe otwierają się ponownie jako zwykłe terminale.
Obsługiwane sesje agentów mogą zostać wznowione, gdy hooks zapiszą natywny ID sesji. Zainstaluj hooks po zainstalowaniu CLI agenta, aby jego plik binarny znalazł się w `PATH`:
```bash
cmux hooks setup
cmux hooks setup codex
cmux hooks setup --agent opencode
```
`cmux hooks setup` instaluje obsługiwanych agentów, których może znaleźć, i wypisuje podsumowanie dla pominiętych agentów. Obsługiwane integracje wznawiania obejmują Claude Code, Codex, Grok, OpenCode, Pi, Amp, Cursor CLI, Gemini, Rovo Dev, Copilot, CodeBuddy, Factory i Qoder. Claude Code jest obsługiwany przez wrapper Claude cmux, gdy integracja Claude jest włączona w Ustawieniach.
Zaawansowani użytkownicy i integracje mogą przypiąć własne polecenie wznowienia do bieżącej terminal surface. Przydaje się to narzędziom z własnym trwałym stanem, takim jak sesje tmux lub niestandardowe agent CLI:
```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 pozostaje powiązany z cmux surface. Bindingi utworzone przez publiczny CLI lub socket są zapisywane do inspekcji i ręcznego wznowienia, chyba że zatwierdzisz podpisany prefiks polecenia do automatycznego wznawiania. Zatwierdzone prefiksy są również powiązane z katalogiem roboczym i dokładnymi wartościami środowiska, gdy są obecne. Przeglądaj lub edytuj zatwierdzenia w **Ustawienia > Terminal > Resume Commands**. cmux automatycznie uruchamia tylko bindingi wznowienia oznaczone jako zaufane, na przykład bindingi tmux wykryte z działających procesów lub prefiksy zatwierdzone przez użytkownika. Wrażliwe klucze środowiska, takie jak tokeny, hasła, sekrety i klucze API, są odrzucane przed zapisaniem bindingu wznowienia.
Aby przywrócone terminale agentów pozostawały bezczynne zamiast automatycznie uruchamiać swoje polecenia wznowienia, wyłącz **Ustawienia > Terminal > Resume Agent Sessions on Reopen** lub ustaw to w `~/.config/cmux/cmux.json`:
```json
{
"terminal": {
"autoResumeAgentSessions": false
}
}
```
To wyłącza tylko automatyczne polecenia wznowienia agentów. cmux nadal przywraca zapisany układ, katalogi robocze, scrollback i historię przeglądarki.
Jeśli chcesz ręcznie ponownie zastosować ostatnią zapisaną migawkę, użyj:
- `File > Reopen Previous Session`
- `⌘ ⇧ O`
- `cmux restore-session`
Pod maską cmux zapisuje wersjonowaną migawkę w `~/Library/Application Support/cmux/`, a hooks agentów zapisują mapowania sesji w `~/.cmuxterm/`. Przy przywracaniu cmux najpierw odbudowuje układ, a następnie uruchamia natywne polecenie wznowienia obsługiwanego agenta, gdy automatyczne wznawianie agentów jest włączone.
Przeczytaj pełny przewodnik na
WeChat: Zeskanuj kod QR, aby dołączyć do społeczności.
