Referans

CLI referansı

purplemux ve pmux ikili dosyalarının her alt komutu ve bayrağı.

purplemux, ikili dosyayı kullanmanın iki yolunu sunar: bir sunucu başlatıcısı olarak (purplemux / purplemux start) ve çalışan bir sunucuyla konuşan bir HTTP API sarmalayıcısı olarak (purplemux <subcommand>). Kısa kısayol pmux aynıdır.

İki rol, tek ikili

Form Yaptığı
purplemux Sunucuyu başlat. purplemux start ile aynı.
purplemux <subcommand> Çalışan bir sunucunun CLI HTTP API'siyle konuş.
pmux ... purplemux ... için kısayol.

bin/purplemux.js'deki dağıtıcı ilk argümanı ayırır: bilinen alt komutlar bin/cli.js'e gider, başka her şey (veya argüman yok) sunucuyu başlatır.

Sunucuyu başlatma

purplemux              # varsayılan
purplemux start        # aynı şey, açık
PORT=9000 purplemux    # özel port
HOST=all purplemux     # her yere bağla

Tam env yüzeyi için Portlar & ortam değişkenleri sayfasına bakın.

Sunucu bağlandığı URL'leri, modu ve auth durumunu yazdırır:

  ⚡ purplemux  v0.x.x
  ➜  Available on:
       http://127.0.0.1:8022
       http://192.168.1.42:8022
  ➜  Mode:   production
  ➜  Auth:   configured

8022 zaten kullanımdaysa sunucu uyarır ve rastgele bir boş porta bağlanır.

Alt komutlar

Tüm alt komutlar çalışan bir sunucu gerektirir. Portu ~/.purplemux/port'tan ve auth tokenini ~/.purplemux/cli-token'dan okurlar; ikisi de sunucu başlangıcında otomatik yazılır.

Komut Amaç
purplemux workspaces Çalışma alanlarını listele
purplemux tab list [-w WS] Sekmeleri listele (isteğe bağlı bir çalışma alanı kapsamına alınmış)
purplemux tab create -w WS [-n NAME] [-t TYPE] Yeni bir sekme oluştur
purplemux tab send -w WS TAB_ID CONTENT... Bir sekmeye girdi gönder
purplemux tab status -w WS TAB_ID Bir sekmenin durumunu incele
purplemux tab result -w WS TAB_ID Sekme panelinin geçerli içeriğini yakala
purplemux tab close -w WS TAB_ID Sekmeyi kapat
purplemux tab browser ... Bir web-browser sekmesini sür (yalnızca Electron)
purplemux api-guide Tam HTTP API referansını yazdır
purplemux help Kullanımı göster

Belirtilmedikçe çıktı JSON'dur. --workspace ve -w birbirinin yerine kullanılabilir.

tab create panel türleri

-t / --type bayrağı panel türünü seçer. Geçerli değerler:

Değer Panel
terminal Düz shell
claude-code claude zaten çalışıyor olan shell
web-browser Gömülü tarayıcı (yalnızca Electron)
diff Git diff paneli

-t olmadan, düz bir terminal alırsınız.

tab browser alt komutları

Bunlar yalnızca sekmenin panel türü web-browser olduğunda ve yalnızca macOS Electron uygulamasında çalışır — köprü aksi halde 503 döndürür.

Alt komut Döndürdüğü
purplemux tab browser url -w WS TAB_ID Geçerli URL + sayfa başlığı
purplemux tab browser screenshot -w WS TAB_ID [-o FILE] [--full] PNG. -o ile diske kaydeder; onsuz base64 döner. --full tam sayfayı yakalar.
purplemux tab browser console -w WS TAB_ID [--since MS] [--level LEVEL] Son console girişleri (halka tampon, 500 girdi)
purplemux tab browser network -w WS TAB_ID [--since MS] [--method M] [--url SUBSTR] [--status CODE] [--request ID] Son network girişleri; --request ID bir gövde alır
purplemux tab browser eval -w WS TAB_ID EXPR Bir JS ifadesi değerlendir ve sonucu serileştir

Örnekler

# Çalışma alanınızı bulun
purplemux workspaces

# ws-MMKl07 çalışma alanında bir Claude sekmesi oluşturun
purplemux tab create -w ws-MMKl07 -t claude-code -n "refactor auth"

# Ona bir prompt gönderin (TAB_ID `tab list`'ten gelir)
purplemux tab send -w ws-MMKl07 tb-abc "Refactor src/lib/auth.ts to remove the cookie path"

# Durumunu izleyin
purplemux tab status -w ws-MMKl07 tb-abc

# Paneli yakalayın
purplemux tab result -w ws-MMKl07 tb-abc

# Bir web-browser sekmesini tam sayfa ekran görüntüsü
purplemux tab browser screenshot -w ws-MMKl07 tb-xyz -o page.png --full

Kimlik doğrulama

Her alt komut x-pmux-token: $(cat ~/.purplemux/cli-token) gönderir ve sunucu tarafında timingSafeEqual ile doğrulanır. ~/.purplemux/cli-token dosyası ilk sunucu başlangıcında randomBytes(32) ile üretilir ve 0600 modunda saklanır.

CLI'yı ~/.purplemux/'u göremeyen başka bir shell veya betikten sürmeniz gerekirse, env değişkenlerini kullanın:

Değişken Varsayılan Etki
PMUX_PORT ~/.purplemux/port'un içeriği CLI'nın konuştuğu port
PMUX_TOKEN ~/.purplemux/cli-token'ın içeriği x-pmux-token olarak gönderilen Bearer token 
PMUX_PORT=8022 PMUX_TOKEN=$(cat ~/.purplemux/cli-token) purplemux workspaces
CLI tokeni tam sunucu erişimi verir. Onu bir parola gibi ele alın. Sohbete yapıştırmayın, commit etmeyin veya bir build env değişkeni olarak açmayın. `~/.purplemux/cli-token`'ı silip sunucuyu yeniden başlatarak döndürün.

update-notifier

purplemux her açılışta npm'i daha yeni bir sürüm için kontrol eder (update-notifier ile) ve varsa bir banner yazdırır. NO_UPDATE_NOTIFIER=1 veya standart update-notifier opt-out'larından herhangi biri ile devre dışı bırakın.

Tam HTTP API

purplemux api-guide, her /api/cli/* uç noktası için istek gövdeleri ve yanıt biçimleri dahil tam HTTP API referansını yazdırır — purplemux'ı doğrudan curl veya başka bir runtime'dan sürmek istediğinizde yararlıdır.

Sıradaki adımlar