Bu çeviri Claude tarafından oluşturulmuştur. İyileştirme önerileriniz varsa lütfen bir PR açın.

AI kodlama ajanları için dikey sekmeler ve bildirimler içeren Ghostty tabanlı macOS terminali

English | 日本語 | Tiếng Việt | 简体中文 | 繁體中文 | 한국어 | Deutsch | Español | Français | Italiano | Dansk | Polski | Русский | Bosanski | العربية | Norsk | Português (Brasil) | ไทย | Türkçe | ភាសាខ្មែរ | Українська

▶ Demo videosu · The Zen of cmux

Bildirim halkaları Kodlama ajanları dikkatinizi istediğinde paneller mavi bir halka alır ve sekmeler yanar
Bildirim paneli Bekleyen tüm bildirimleri tek bir yerden görün, en son okunmamışa atlayın
Uygulama içi tarayıcı agent-browser'dan aktarılmış betiklenebilir bir API ile terminalinizin yanında bir tarayıcı bölün
Dikey + yatay sekmeler Kenar çubuğu git dalını, bağlantılı PR durumunu/numarasını, çalışma dizinini, dinlenen portları ve en son bildirim metnini gösterir. Yatay ve dikey bölmeler.
SSH cmux ssh user@remote uzak bir makine için çalışma alanı oluşturur. İlk uzak terminalinde bir kez başlangıç komutu çalıştırmak için --command 'omp "investigate auth"' parametresini geçin. Tarayıcı panelleri uzak ağ üzerinden yönlendirilir, böylece localhost sorunsuz çalışır. Uzak oturuma bir görsel sürükleyerek scp ile yükleyin.
Claude Code Teams cmux claude-teams Claude Code'un takım arkadaşı modunu tek bir komutla çalıştırır. Takım arkadaşları, kenar çubuğu meta verileri ve bildirimlerle yerel bölmeler olarak oluşturulur. tmux gerekmez.

• Tarayıcı içe aktarma — Chrome, Firefox, Arc ve 20'den fazla tarayıcıdan çerezleri, geçmişi ve oturumları içe aktararak tarayıcı panellerinin oturum açmış şekilde başlamasını sağlayın
• Özel komutlar — Komut paletinden başlatılan projeye özel eylemleri cmux.json dosyasında tanımlayın
• Betiklenebilir — Çalışma alanları oluşturmak, panelleri bölmek, tuş vuruşları göndermek ve tarayıcıyı otomatikleştirmek için CLI ve socket API
• Yerel macOS uygulaması — Swift ve AppKit ile yapılmıştır, Electron değil. Hızlı başlangıç, düşük bellek kullanımı.
• Ghostty uyumlu — Temalar, yazı tipleri ve renkler için mevcut ~/.config/ghostty/config dosyanızı okur
• GPU hızlandırmalı — Akıcı görüntüleme için libghostty tarafından desteklenir
• Klavye kısayolları — Çalışma alanları, bölmeler, tarayıcı ve daha fazlası için kapsamlı kısayollar
• Açık kaynak — Ücretsiz ve GPL lisanslı

.dmg dosyasını açın ve cmux'u Uygulamalar klasörüne sürükleyin. cmux Sparkle aracılığıyla otomatik güncellenir, bu yüzden yalnızca bir kez indirmeniz yeterlidir.

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

Daha sonra güncellemek için:

brew upgrade --cask cmux

İlk açılışta macOS, tanımlanmış bir geliştiriciden gelen bir uygulamayı açmayı onaylamanızı isteyebilir. Devam etmek için Aç'a tıklayın.

Homebrew cask'i zsh, bash ve fish için tamamlamayı kurar. Kurulumdan sonra yeni bir kabuk başlatın. Yüklenmezse, Homebrew'un tamamlama dizinlerinin kabuğunuza bağlı olduğundan emin olun (Homebrew'un kabuk tamamlama belgelerine bakın).

cmux'u başka bir yolla kurduysanız, ilgili satırı kabuğunuzun başlangıç dosyasına ekleyin ve yeni bir kabuk başlatın:

autoload -Uz compinit && compinit
eval "$(cmux completion zsh)"

eval "$(cmux completion bash)"

cmux completion fish | source

Birçok Claude Code ve Codex oturumunu paralel olarak çalıştırıyorum. Ghostty'yi bir sürü bölünmüş panelle kullanıyor ve bir ajanın bana ne zaman ihtiyacı olduğunu anlamak için yerel macOS bildirimlerine güveniyordum. Ancak Claude Code'un bildirim metni her zaman sadece "Claude is waiting for your input" oluyor, hiçbir bağlam yok ve yeterince sekme açıkken başlıkları bile okuyamıyordum artık.

Birkaç kodlama orkestratörü denedim ama çoğu Electron/Tauri uygulamasıydı ve performansları beni rahatsız ediyordu. Ayrıca terminali tercih ediyorum çünkü GUI orkestratörleri sizi kendi iş akışlarına kilitliyor. Bu yüzden cmux'u Swift/AppKit'te yerel bir macOS uygulaması olarak geliştirdim. Terminal görüntüleme için libghostty kullanıyor ve temalar, yazı tipleri ve renkler için mevcut Ghostty yapılandırmanızı okuyor.

Ana eklemeler kenar çubuğu ve bildirim sistemi. Kenar çubuğunda her çalışma alanı için git dalını, bağlantılı PR durumunu/numarasını, çalışma dizinini, dinlenen portları ve en son bildirim metnini gösteren dikey sekmeler var. Bildirim sistemi terminal dizilerini (OSC 9/99/777) yakalıyor ve Claude Code, OpenCode vb. için ajan kancalarına bağlayabileceğiniz bir CLI'ye (cmux notify) sahip. Bir ajan beklerken paneli mavi bir halka alıyor ve sekme kenar çubuğunda yanıyor, böylece bölmeler ve sekmeler arasında hangisinin bana ihtiyacı olduğunu görebiliyorum. Cmd+Shift+U en son okunmamışa atlıyor.

Uygulama içi tarayıcının agent-browser'dan aktarılmış betiklenebilir bir API'si var. Ajanlar erişilebilirlik ağacının anlık görüntüsünü alabilir, öğe referansları elde edebilir, tıklayabilir, formları doldurabilir ve JS çalıştırabilir. Terminalinizin yanında bir tarayıcı paneli bölebilir ve Claude Code'un geliştirme sunucunuzla doğrudan etkileşime girmesini sağlayabilirsiniz.

Her şey CLI ve socket API aracılığıyla betiklenebilir — çalışma alanları/sekmeler oluşturun, panelleri bölün, tuş vuruşları gönderin, tarayıcıda URL'ler açın.

cmux, geliştiricilerin araçlarını nasıl kullandığını dikte etmez. Bir terminal ve tarayıcı ile CLI'dir, geri kalanı size kalmış.

cmux bir ilkel yapıdır, hazır bir çözüm değil. Size bir terminal, bir tarayıcı, bildirimler, çalışma alanları, bölmeler, sekmeler ve hepsini kontrol etmek için bir CLI verir. cmux sizi kodlama ajanlarını belirli bir şekilde kullanmaya zorlamaz. İlkel yapılarla ne inşa edeceğiniz tamamen size aittir.

En iyi geliştiriciler her zaman kendi araçlarını yapmıştır. Ajanlarla çalışmanın en iyi yolunu henüz kimse bulamadı ve kapalı ürünler geliştiren ekipler de kesinlikle bulamadı. Kendi kod tabanlarına en yakın olan geliştiriciler bunu ilk keşfedenler olacak.

Bir milyon geliştiriciye birleştirilebilir ilkel yapılar verin, en verimli iş akışlarını herhangi bir ürün ekibinin yukarıdan aşağıya tasarlayabileceğinden daha hızlı bulacaklardır.

cmux'u nasıl yapılandıracağınız hakkında daha fazla bilgi için, dokümantasyonumuza gidin.

Tarayıcı geliştirici araçları kısayolları Safari varsayılanlarını takip eder ve Settings → Keyboard Shortcuts bölümünden özelleştirilebilir. ⌃ P dahil komut paleti gezinme kısayolları da özelleştirilebilir ve tuş vuruşu aktif terminale ulaşacak şekilde temizlenebilir.

cmux NIGHTLY'i indir

cmux NIGHTLY, kendi bundle ID'sine sahip ayrı bir uygulamadır, bu yüzden kararlı sürümle yan yana çalışır. En son main commit'inden otomatik olarak derlenir ve kendi Sparkle akışı aracılığıyla otomatik güncellenir.

Nightly hatalarını GitHub Issues üzerinde veya Discord'daki #nightly-bugs kanalında bildirin.

cmux'tan çıktığınızda mevcut oturum kaydedilir. Yeniden başlatıldığında cmux uygulamaya ait durumu geri yükler:

• Pencere/çalışma alanı/panel düzeni
• Çalışma dizinleri
• Terminal kaydırma geçmişi (en iyi çaba)
• Tarayıcı URL'si ve gezinme geçmişi

cmux rastgele canlı işlem durumunu checkpoint etmez. tmux, vim, shell'ler ve desteklenmeyen terminal uygulamaları normal terminaller olarak yeniden açılır.

Desteklenen agent oturumları, hooks yerel bir oturum ID'si kaydettiğinde sürdürülebilir. Binary dosyasının PATH üzerinde olması için hooks'u agent CLI'sini kurduktan sonra kurun:

cmux hooks setup
cmux hooks setup codex
cmux hooks setup --agent opencode

cmux hooks setup bulabildiği desteklenen agentleri kurar ve atlanan agentler için bir özet yazdırır. Desteklenen resume entegrasyonları arasında Claude Code, Codex, Grok, OpenCode, Pi, Amp, Cursor CLI, Gemini, Rovo Dev, Copilot, CodeBuddy, Factory ve Qoder bulunur. Claude entegrasyonu Ayarlar'da etkinleştirildiğinde Claude Code, cmux Claude wrapper tarafından işlenir.

Gelişmiş kullanıcılar ve entegrasyonlar mevcut terminal surface'ine özel bir resume komutu bağlayabilir. Bu, tmux oturumları veya özel agent CLI'ları gibi kendi kalıcı durumuna sahip araçlar için kullanışlıdır:

cmux surface resume set --kind tmux --checkpoint work --shell "tmux attach -t work"
cmux surface resume show --json
cmux surface resume clear --checkpoint work

Bu binding cmux surface'ine bağlı kalır. Genel CLI veya socket ile oluşturulan bindingler, otomatik resume için imzalı bir komut öneki onaylamadığınız sürece inceleme ve manuel resume için saklanır. Onaylanan önekler ayrıca, mevcut olduğunda, çalışma dizinine ve tam ortam değerlerine de bağlanır. Onayları Settings > Terminal > Resume Commands bölümünde gözden geçirin veya düzenleyin. cmux yalnızca güvenilir olarak işaretlediği resume bindinglerini otomatik çalıştırır, örneğin canlı processlerden algılanan tmux bindingleri veya kullanıcı tarafından onaylanan önekler. Token, parola, gizli değer ve API anahtarı gibi hassas ortam anahtarları resume binding kaydedilmeden önce atılır.

Geri yüklenen agent terminallerinin resume komutlarını otomatik çalıştırmak yerine boşta kalmasını sağlamak için Settings > Terminal > Resume Agent Sessions on Reopen seçeneğini kapatın veya bunu ~/.config/cmux/cmux.json dosyasında ayarlayın:

{
  "terminal": {
    "autoResumeAgentSessions": false
  }
}

Bu yalnızca otomatik agent resume komutlarını devre dışı bırakır. cmux yine de kaydedilmiş düzeni, çalışma dizinlerini, kaydırma geçmişini ve tarayıcı geçmişini geri yükler.

Son kaydedilen anlık görüntüyü manuel olarak yeniden uygulamanız gerekirse, şunu kullanın:

• File > Reopen Previous Session
• ⌘ ⇧ O
• cmux restore-session

Arka planda cmux, ~/Library/Application Support/cmux/ altında sürümlenmiş bir anlık görüntü yazar ve agent hooks oturum eşlemelerini ~/.cmuxterm/ altında yazar. Geri yükleme sırasında cmux önce düzeni yeniden oluşturur, ardından otomatik agent resume etkinleştirildiğinde desteklenen agentin yerel resume komutunu çalıştırır.

Tam kılavuzu https://cmux.com/docs/session-restore adresinde okuyun.

cmux, Ghostty'nin bir fork'u değildir. Uygulamaların web görünümleri için WebKit kullanması gibi, terminal görüntüleme için libghostty'yi bir kütüphane olarak kullanır. Ghostty bağımsız bir terminaldir; cmux, onun görüntüleme motoru üzerine inşa edilmiş farklı bir uygulamadır.

Şimdilik yalnızca macOS. cmux, yerel bir Swift + AppKit uygulamasıdır.

Evet, betada. iPhone'unuzu Mobile Connect penceresinden Mac'inizle eşleştirin ve telefonunuzdan terminallerinize bağlanın, isteğe bağlı terminal bildirimi iletmeyle birlikte. TestFlight'ta cmux BETA olarak sunulur. iOS dokümantasyonuna bakın.

Hepsiyle. cmux bir terminaldir, bu yüzden bir terminalde çalışan herhangi bir ajan kutudan çıktığı gibi çalışır: Claude Code, Codex, OpenCode, Gemini CLI, Kiro, Aider, Goose, Amp, Cline, Cursor Agent ve komut satırından başlatabileceğiniz başka her şey.

Evet. Bir ajan alt ajanlar veya takım arkadaşları oluşturduğunda, cmux bunları gizli arka plan işlemleri yerine yerel panellere ve bölmelere dönüştürür. Claude Code teams ve oh-my-opencode çoklu model orkestrasyonunu destekler, böylece bir çalıştırmadaki her ajan görünür ve kontrol edilebilir.

Evet. SSH üzerinden çalışma alanları açın ve uzak tmux oturumlarına bağlanın, böylece ajanlar uzak bir hostta çalışırken siz onları cmux'tan yönetebilirsiniz. SSH ve uzaktan bölümüne bakın.

Bir işlem dikkat istediğinde, cmux panellerin etrafında bildirim halkaları, kenar çubuğunda okunmamış rozetleri, bir bildirim popover'ı ve bir macOS masaüstü bildirimi gösterir. Bunlar standart terminal escape dizileri (OSC 9/99/777) aracılığıyla otomatik olarak tetiklenir veya cmux CLI ve agent hooks ile tetikleyebilirsiniz. Hooks veya OSC destekleyen herhangi bir ajan çalışır, buna Claude Code, Codex, OpenCode ve pi dahildir.

Evet. Her eylem cmux CLI ve bir Unix socket aracılığıyla kullanılabilir: çalışma alanları oluşturun, bölünmüş paneller açın, girdi gönderin, ekran içeriğini okuyun, ekran görüntüleri alın ve uygulama içi tarayıcıyı yönetin. CLI referansı ve tarayıcı otomasyonu dokümanlarına bakın.

cmux, terminalinizin yanında gerçek bir tarayıcı paneli bölebilir ve tamamen programlanabilir: gezinin, DOM'un anlık görüntüsünü alın, tıklayın, yazın, JavaScript çalıştırın ve aynı socket API üzerinden konsol ile ağ aktivitesini okuyun. Ajanlar bunu, cmux'tan ayrılmadan kendi web değişikliklerini doğrulamak için kullanır. Tarayıcı otomasyonuna bakın.

Evet. Yetenekler, cmux'ta çalışan herhangi bir ajana verebileceğiniz, CLI kontrolü, çalışma alanı otomasyonu, ayarlar ve tarayıcı yüzeyleri gibi şeyler için yeniden kullanılabilir iş akışlarıdır. Açık koleksiyona cmux-skills adresinden göz atın veya yetenekler dokümanlarını okuyun.

Terminal tuş atamaları Ghostty yapılandırma dosyanızdan (~/.config/ghostty/config) okunur. cmux'a özgü kısayollar (çalışma alanları, bölmeler, tarayıcı, bildirimler) Ayarlar'da özelleştirilebilir. Tam liste için varsayılan kısayollara bakın.

Evet. Terminal görüntüleme Ghostty yapılandırmanızı kullanır, böylece temalar, yazı tipleri, renkler ve imleç doğrudan taşınır. cmux'un kendi ~/.config/cmux/cmux.json dosyasındaki ayarları kenar çubuğunu, sekme çubuğunu, bölünmüş panelleri ve davranışı kontrol eder ve her klavye kısayolu düzenlenebilir. Yapılandırmaya bakın.

Evet. cmux, yeniden başlattığınızda pencerelerinizi, çalışma alanlarınızı, panellerinizi, çalışma dizinlerinizi ve kaydırma geçmişinizi geri yükler ve bu durum yalnızca uygulamadan çıkmaktan değil, tam bir bilgisayar yeniden başlatmasından da kurtulur. Claude Code, Codex ve OpenCode gibi agent oturumları da geri gelir. Oturum geri yüklemeye bakın.

tmux, herhangi bir terminalin içinde çalışan bir terminal çoklayıcısıdır. cmux, bir GUI'ye sahip yerel bir macOS uygulamasıdır: dikey sekmeler, bölünmüş paneller, gömülü bir tarayıcı ve bir socket API, hepsi yerleşik, yapılandırma dosyası veya önek tuşu gerekmez. Bununla birlikte, birçok kişi cmux'u SSH ve tmux ile birlikte mutlu bir şekilde çalıştırır ve cmux, uzak tmux oturumlarınıza yerel olarak bağlanabilir (beta).

Evet, cmux ücretsiz kullanılır. Kaynak kodu GitHub'ta mevcuttur.

cmux ücretsiz ve açık kaynaktır ve her zaman öyle kalacaktır. Geliştirmeyi desteklemek ve cmux AI, iOS uygulaması ve Cloud VMs dahil olmak üzere sırada ne olduğuna erken erişim almak isterseniz, cmux Founders Edition'a göz atın.

Bunu duymak istiyoruz. GitHub'da bir issue veya pull request açın ya da bize e-posta gönderin.

Katılım yolları:

• Güncellemeler için bizi X'te takip edin @manaflowai, @lawrencecchen ve @austinywang
• Discord'da sohbete katılın
• GitHub issues ve discussions oluşturun ve katılın
• cmux ile ne inşa ettiğinizi bize bildirin

• Discord
• WhatsApp
• GitHub
• X / Twitter
• YouTube
• LinkedIn
• Reddit

WeChat: Topluluğa katılmak için QR kodunu tarayın.

cmux ücretsiz, açık kaynak ve her zaman öyle olacak. Geliştirmeyi desteklemek ve sırada ne olduğuna erken erişim almak isterseniz:

Founder's Edition'ı Edinin

• Öncelikli özellik istekleri/hata düzeltmeleri
• Erken erişim: Her çalışma alanı, sekme ve panel hakkında bağlam sağlayan cmux AI
• Erken erişim: Masaüstü ve telefon arasında senkronize terminallere sahip iOS uygulaması
• Erken erişim: Bulut VM'ler
• Erken erişim: Sesli mod
• Kişisel iMessage/WhatsApp'ım

cmux, GPL-3.0-or-later kapsamında açık kaynaklıdır. cmux sunucu yazılımı (web/, Cloudflare worker'ları ve LICENSE içinde listelenen relay servisleri) bunun yerine Business Source License 1.1 kullanır: üretim dışı kullanım için okuyabilir, değiştirebilir ve çalıştırabilirsiniz; üretim kullanımı veya kendi sunucunuzda barındırma ticari lisans gerektirir.

Kuruluşunuz GPL'ye uyum sağlayamıyorsa, ticari lisans mevcuttur. Ayrıntılar için founders@cmux.com ile iletişime geçin.