macOS companion app
Ce-ee köprüsü
OmeniaClaw, PeekabooBridge'i yerel, izin duyarlı bir UI otomasyon aracısı olarak barındırabilir. Bu, peekaboo CLI'nin macOS uygulamasının TCC izinlerini yeniden kullanırken UI otomasyonunu yürütmesini sağlar.
Bu nedir (ve ne değildir)
- Ana makine: OmeniaClaw.app bir PeekabooBridge ana makinesi olarak davranabilir.
- İstemci:
peekabooCLI'yi kullanın (ayrı birOmeniaClaw ui ...yüzeyi yoktur). - UI: görsel katmanlar Peekaboo.app içinde kalır; OmeniaClaw ince bir aracı ana makinedir.
Computer Use ile ilişkisi
OmeniaClaw'ın üç masaüstü denetim yolu vardır ve bunlar bilinçli olarak ayrı tutulur:
- PeekabooBridge ana makinesi: OmeniaClaw.app yerel PeekabooBridge soketini barındırabilir.
peekabooCLI istemci olarak kalır ve ekran görüntüleri, tıklamalar, menüler, iletişim kutuları, Dock eylemleri ve pencere yönetimi gibi Peekaboo otomasyon temel öğeleri için OmeniaClaw.app'in macOS izinlerini kullanır. - Codex Computer Use: birlikte gelen
codexPlugin'i Codex uygulama sunucusunu hazırlar, Codex'incomputer-useMCP sunucusunun kullanılabilir olduğunu doğrular ve ardından Codex modundaki turlarda yerel masaüstü denetim aracı çağrılarını Codex'in sahiplenmesini sağlar. OmeniaClaw bu eylemleri PeekabooBridge üzerinden vekillemez. - Doğrudan
cua-driverMCP: OmeniaClaw, TryCua'nın yukarı akışcua-driver mcpsunucusunu normal bir MCP sunucusu olarak kaydedebilir. Bu, aracılara Codex marketplace veya PeekabooBridge soketi üzerinden yönlendirme yapmadan CUA sürücüsünün kendi şemalarını ve pid/pencere/öğe-dizini iş akışını verir.
Geniş macOS otomasyon yüzeyini ve OmeniaClaw.app'in izin duyarlı köprü ana makinesini istediğinizde Peekaboo'yu kullanın. Codex modundaki bir aracının Codex'in yerel computer-use Plugin'ine dayanması gerektiğinde Codex Computer Use'ı kullanın. CUA sürücüsünü normal bir MCP sunucusu olarak OmeniaClaw tarafından yönetilen herhangi bir çalışma zamanına açmak istediğinizde doğrudan cua-driver mcp kullanın.
Köprüyü etkinleştirme
macOS uygulamasında:
- Ayarlar → Peekaboo Bridge'i Etkinleştir
Etkinleştirildiğinde OmeniaClaw yerel bir UNIX soket sunucusu başlatır. Devre dışı bırakılırsa ana makine durdurulur ve peekaboo diğer kullanılabilir ana makinelere geri döner.
İstemci keşif sırası
Peekaboo istemcileri genellikle ana makineleri şu sırayla dener:
- Peekaboo.app (tam UX)
- Claude.app (yüklüyse)
- OmeniaClaw.app (ince aracı)
Hangi ana makinenin etkin olduğunu ve hangi soket yolunun kullanıldığını görmek için peekaboo bridge status --verbose kullanın. Şununla geçersiz kılabilirsiniz:
export PEEKABOO_BRIDGE_SOCKET=/path/to/bridge.sockGüvenlik ve izinler
- Köprü çağıran kod imzalarını doğrular; TeamID'lerden oluşan bir izin listesi uygulanır (Peekaboo ana makine TeamID'si + OmeniaClaw uygulama TeamID'si).
- İstekler yaklaşık 10 saniye sonra zaman aşımına uğrar.
- Gerekli izinler eksikse köprü, Sistem Ayarları'nı başlatmak yerine açık bir hata mesajı döndürür.
Anlık görüntü davranışı (otomasyon)
Anlık görüntüler bellekte saklanır ve kısa bir sürenin ardından otomatik olarak sona erer. Daha uzun saklama gerekiyorsa istemciden yeniden yakalayın.
Sorun giderme
peekaboo"bridge client is not authorized" bildirirse istemcinin düzgün şekilde imzalandığından emin olun veya ana makineyi yalnızca hata ayıklama modundaPEEKABOO_ALLOW_UNSIGNED_SOCKET_CLIENTS=1ile çalıştırın.- Hiçbir ana makine bulunamazsa ana makine uygulamalarından birini açın (Peekaboo.app veya OmeniaClaw.app) ve izinlerin verildiğini doğrulayın.