> To tłumaczenie zostało wygenerowane przez Claude. Jeśli masz sugestie dotyczące poprawek, otwórz PR.

<p align="center">
  <a href="README.md">English</a> | <a href="README.zh-CN.md">简体中文</a> | <a href="README.zh-TW.md">繁體中文</a> | <a href="README.ko.md">한국어</a> | <a href="README.de.md">Deutsch</a> | <a href="README.es.md">Español</a> | <a href="README.fr.md">Français</a> | <a href="README.it.md">Italiano</a> | <a href="README.da.md">Dansk</a> | <a href="README.ja.md">日本語</a> | Polski | <a href="README.ru.md">Русский</a> | <a href="README.bs.md">Bosanski</a> | <a href="README.ar.md">العربية</a> | <a href="README.no.md">Norsk</a> | <a href="README.pt-BR.md">Português (Brasil)</a> | <a href="README.th.md">ไทย</a> | <a href="README.tr.md">Türkçe</a>
</p>

<h1 align="center">cmux</h1>
<p align="center">Terminal macOS oparty na Ghostty z pionowymi kartami i powiadomieniami dla agentów kodowania AI</p>

<p align="center">
  <a href="https://github.com/manaflow-ai/cmux/releases/latest/download/cmux-macos.dmg">
    <img src="./docs/assets/macos-badge.png" alt="Pobierz cmux dla macOS" width="180" />
  </a>
</p>

<p align="center">
  <img src="./docs/assets/screenshot.png" alt="Zrzut ekranu cmux" width="900" />
</p>

## Funkcje

- **Pionowe karty** — Pasek boczny pokazuje gałąź git, katalog roboczy, nasłuchujące porty i tekst ostatniego powiadomienia
- **Pierścienie powiadomień** — Panele otrzymują niebieski pierścień, a karty podświetlają się, gdy agenci AI (Claude Code, OpenCode) potrzebują Twojej uwagi
- **Panel powiadomień** — Zobacz wszystkie oczekujące powiadomienia w jednym miejscu, przeskocz do najnowszego nieprzeczytanego
- **Podzielone panele** — Podziały poziome i pionowe
- **Wbudowana przeglądarka** — Podziel przeglądarkę obok terminala ze skryptowalnym API przeniesionym z [agent-browser](https://github.com/vercel-labs/agent-browser)
- **Skryptowalny** — CLI i socket API do tworzenia przestrzeni roboczych, dzielenia paneli, wysyłania naciśnięć klawiszy i automatyzacji przeglądarki
- **Natywna aplikacja macOS** — Zbudowana w Swift i AppKit, nie Electron. Szybki start, niskie zużycie pamięci.
- **Kompatybilny z Ghostty** — Odczytuje istniejącą konfigurację `~/.config/ghostty/config` dla motywów, czcionek i kolorów
- **Akceleracja GPU** — Napędzany przez libghostty dla płynnego renderowania

## Instalacja

### DMG (zalecane)

<a href="https://github.com/manaflow-ai/cmux/releases/latest/download/cmux-macos.dmg">
  <img src="./docs/assets/macos-badge.png" alt="Pobierz cmux dla macOS" width="180" />
</a>

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, 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.

## 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ą |
| ⌘ B | Przełącz pasek boczny |

### 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ót | Akcja |
|----------|--------|
| ⌘ ⇧ L | Otwórz przeglądarkę w podziale |
| ⌘ L | Fokus na pasku adresu |
| ⌘ [ | Wstecz |
| ⌘ ] | Do przodu |
| ⌘ R | Przeładuj stronę |
| ⌥ ⌘ I | Otwórz Narzędzia Deweloperskie |

### Powiadomienia

| Skrót | Akcja |
|----------|--------|
| ⌘ I | Pokaż panel powiadomień |
| ⌘ ⇧ U | Przejdź do najnowszego nieprzeczytanego |

### Szukaj

| Skrót | Akcja |
|----------|--------|
| ⌘ F | Szukaj |
| ⌘ 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 |
| ⌘ , | Ustawienia |
| ⌘ ⇧ , | Przeładuj konfigurację |
| ⌘ Q | Zakończ |

## Licencja

Ten projekt jest licencjonowany na warunkach GNU Affero General Public License v3.0 lub nowszej (`AGPL-3.0-or-later`).

Pełny tekst znajduje się w pliku `LICENSE`.
