Kurulum

Hızlı başlangıç'ta npx purplemux çalıştırdıysanız ve bu yeterli olduysa işiniz bitti. Bu sayfa kalıcı bir kurulum, masaüstü uygulaması veya kaynaktan çalıştırma isteyenler için.

Gereksinimler

• macOS 13+ veya Linux — Windows desteklenmez. WSL2 genelde çalışır ama test matrisimizin dışındadır.
• Node.js 20 veya üstü — node -v ile kontrol edin.
• tmux — 3.0+ herhangi bir sürüm.

Kurulum yöntemleri

npx (kurulumsuz)

npx purplemux

İlk çalıştırmada purplemux'ı indirir ve ~/.npm/_npx/ altına önbelleğe alır. Hızlıca denemek veya uzak bir makinede ad-hoc çalıştırmak için en uygunu. Her çalıştırmada en güncel sürüm kullanılır.

Global kurulum

npm install -g purplemux
purplemux

pnpm ve yarn da aynı şekilde çalışır (pnpm add -g purplemux / yarn global add purplemux). Sonraki çalıştırmalar daha hızlı başlar çünkü çözümlemeye gerek kalmaz. Güncelleme: npm update -g purplemux.

İkili dosya kısa olsun diye pmux adıyla da kullanılabilir.

macOS yerel uygulaması

Releases sayfasından en son .dmg'yi indirin — Apple Silicon ve Intel yapıları sağlanır. Otomatik güncelleme yerleşik.

Uygulama Node, tmux ve purplemux sunucusunu içerir; ayrıca şunları sağlar:

• Sunucu durumunu gösteren menü çubuğu simgesi
• Yerel bildirimler (Web Push'tan ayrı)
• Oturum açıldığında otomatik başlatma (Ayarlar → Genel içinden açılır)

Kaynaktan çalıştırma

git clone https://github.com/subicura/purplemux.git
cd purplemux
pnpm install
pnpm start

Geliştirme için (sıcak yeniden yükleme):

pnpm dev

Port ve ortam değişkenleri

purplemux 8022 portunda dinler (mizah olsun diye web + ssh). PORT ile değiştirin:

PORT=9000 purplemux

Loglama LOG_LEVEL (varsayılan info) ve modül başına geçersiz kılma için LOG_LEVELS ile kontrol edilir:

LOG_LEVEL=debug purplemux
# yalnızca Claude hook modülünü debug et
LOG_LEVELS=hooks=debug purplemux
# birden fazla modülü aynı anda
LOG_LEVELS=hooks=debug,status=warn purplemux

Mevcut seviyeler: trace · debug · info · warn · error · fatal. LOG_LEVELS'ta listelenmeyen modüller LOG_LEVEL'a düşer.

Tam liste için Portlar & ortam değişkenleri sayfasına bakın.

Açılışta başlatma

CLI kurulumu için launchd (macOS) veya systemd (Linux) ile sarmalayın. Asgari bir systemd birimi şöyle görünür:

# ~/.config/systemd/user/purplemux.service
[Unit]
Description=purplemux

[Service]
ExecStart=/usr/local/bin/purplemux
Restart=on-failure

[Install]
WantedBy=default.target

systemctl --user enable --now purplemux

Güncelleme

Kaldırma

npm uninstall -g purplemux          # veya pnpm remove -g / yarn global remove
rm -rf ~/.purplemux                 # ayarları ve oturum verisini siler

Yerel uygulama olağan şekilde Çöp Kutusu'na sürüklenir. ~/.purplemux/ altında tam olarak ne saklandığı için Veri dizini sayfasına bakın.