macOS companion app

Most Peekaboo

OmeniaClaw może hostować PeekabooBridge jako lokalnego, świadomego uprawnień brokera automatyzacji UI. Dzięki temu CLI peekaboo może sterować automatyzacją UI, ponownie wykorzystując uprawnienia TCC aplikacji macOS.

Czym to jest (a czym nie jest)

Host: OmeniaClaw.app może działać jako host PeekabooBridge.
Klient: użyj CLI peekaboo (bez osobnej powierzchni OmeniaClaw ui ...).
UI: wizualne nakładki pozostają w Peekaboo.app; OmeniaClaw jest lekkim hostem brokera.

Relacja do Computer Use

OmeniaClaw ma trzy ścieżki sterowania pulpitem i celowo pozostają one oddzielne:

Host PeekabooBridge: OmeniaClaw.app może hostować lokalny socket PeekabooBridge. CLI peekaboo pozostaje klientem i używa uprawnień macOS aplikacji OmeniaClaw.app dla prymitywów automatyzacji Peekaboo, takich jak zrzuty ekranu, kliknięcia, menu, okna dialogowe, akcje Docka i zarządzanie oknami.
Codex Computer Use: dołączony Plugin codex przygotowuje serwer aplikacji Codex, weryfikuje, że serwer MCP computer-use Codex jest dostępny, a następnie pozwala Codex przejąć natywne wywołania narzędzi sterowania pulpitem podczas tur w trybie Codex. OmeniaClaw nie pośredniczy w tych akcjach przez PeekabooBridge.
Bezpośredni MCP cua-driver: OmeniaClaw może zarejestrować nadrzędny serwer cua-driver mcp TryCua jako zwykły serwer MCP. Daje to agentom własne schematy sterownika CUA oraz przepływ pracy pid/okno/indeks-elementu bez routingu przez marketplace Codex ani socket PeekabooBridge.

Użyj Peekaboo, gdy chcesz mieć szeroką powierzchnię automatyzacji macOS oraz świadomy uprawnień host mostu OmeniaClaw.app. Użyj Codex Computer Use, gdy agent w trybie Codex powinien polegać na natywnym Plugin do computer-use Codex. Użyj bezpośredniego cua-driver mcp, gdy chcesz udostępnić sterownik CUA dowolnemu środowisku uruchomieniowemu zarządzanemu przez OmeniaClaw jako zwykły serwer MCP.

Włącz most

W aplikacji macOS:

Ustawienia → Włącz Peekaboo Bridge

Po włączeniu OmeniaClaw uruchamia lokalny serwer socketu UNIX. Jeśli jest wyłączony, host zostaje zatrzymany, a peekaboo przełączy się na inne dostępne hosty.

Kolejność wykrywania klienta

Klienci Peekaboo zwykle próbują hostów w tej kolejności:

Peekaboo.app (pełny UX)
Claude.app (jeśli zainstalowana)
OmeniaClaw.app (lekki broker)

Użyj peekaboo bridge status --verbose, aby zobaczyć, który host jest aktywny i która ścieżka socketu jest używana. Możesz nadpisać to za pomocą:

bash

export PEEKABOO_BRIDGE_SOCKET=/path/to/bridge.sock

Bezpieczeństwo i uprawnienia

Most weryfikuje podpisy kodu wywołującego; wymuszana jest lista dozwolonych TeamID (TeamID hosta Peekaboo + TeamID aplikacji OmeniaClaw).
Żądania wygasają po około 10 sekundach.
Jeśli brakuje wymaganych uprawnień, most zwraca jasny komunikat o błędzie zamiast uruchamiać Ustawienia systemowe.

Zachowanie migawek (automatyzacja)

Migawki są przechowywane w pamięci i wygasają automatycznie po krótkim czasie. Jeśli potrzebujesz dłuższego przechowywania, przechwyć je ponownie z klienta.

Rozwiązywanie problemów

Jeśli peekaboo zgłasza „bridge client is not authorized”, upewnij się, że klient jest prawidłowo podpisany, albo uruchom host z PEEKABOO_ALLOW_UNSIGNED_SOCKET_CLIENTS=1 wyłącznie w trybie debug.
Jeśli nie znaleziono żadnych hostów, otwórz jedną z aplikacji hosta (Peekaboo.app lub OmeniaClaw.app) i potwierdź, że uprawnienia zostały przyznane.

Powiązane

Was this useful?