macOS companion app

Ponte Peekaboo

OmeniaClaw può ospitare PeekabooBridge come broker locale di automazione dell'interfaccia utente, consapevole dei permessi. Questo permette alla CLI peekaboo di pilotare l'automazione dell'interfaccia utente riutilizzando i permessi TCC dell'app macOS.

Che cos'è (e che cosa non è)

Host: OmeniaClaw.app può fungere da host PeekabooBridge.
Client: usa la CLI peekaboo (nessuna superficie OmeniaClaw ui ... separata).
UI: gli overlay visivi restano in Peekaboo.app; OmeniaClaw è un host broker sottile.

Relazione con Computer Use

OmeniaClaw ha tre percorsi di controllo desktop, e restano intenzionalmente separati:

Host PeekabooBridge: OmeniaClaw.app può ospitare il socket locale PeekabooBridge. La CLI peekaboo resta il client e usa i permessi macOS di OmeniaClaw.app per le primitive di automazione Peekaboo come screenshot, clic, menu, finestre di dialogo, azioni del Dock e gestione delle finestre.
Codex Computer Use: il Plugin codex incluso prepara il server dell'app Codex, verifica che il server MCP computer-use di Codex sia disponibile, e quindi consente a Codex di possedere le chiamate agli strumenti nativi di controllo desktop durante i turni in modalità Codex. OmeniaClaw non inoltra tali azioni tramite PeekabooBridge.
MCP cua-driver diretto: OmeniaClaw può registrare il server cua-driver mcp upstream di TryCua come normale server MCP. Questo fornisce agli agenti gli schemi propri del driver CUA e il flusso di lavoro pid/finestra/indice-elemento senza instradare tramite il marketplace Codex o il socket PeekabooBridge.

Usa Peekaboo quando vuoi l'ampia superficie di automazione macOS e l'host bridge di OmeniaClaw.app consapevole dei permessi. Usa Codex Computer Use quando un agente in modalità Codex deve affidarsi al Plugin nativo di Codex per computer-use. Usa cua-driver mcp diretto quando vuoi esporre il driver CUA a qualsiasi runtime gestito da OmeniaClaw come normale server MCP.

Abilitare il bridge

Nell'app macOS:

Impostazioni → Abilita Peekaboo Bridge

Quando è abilitato, OmeniaClaw avvia un server socket UNIX locale. Se è disabilitato, l'host viene arrestato e peekaboo ripiegherà su altri host disponibili.

Ordine di rilevamento dei client

I client Peekaboo in genere provano gli host in questo ordine:

Peekaboo.app (UX completa)
Claude.app (se installata)
OmeniaClaw.app (broker sottile)

Usa peekaboo bridge status --verbose per vedere quale host è attivo e quale percorso del socket è in uso. Puoi eseguire l'override con:

bash

export PEEKABOO_BRIDGE_SOCKET=/path/to/bridge.sock

Sicurezza e permessi

Il bridge convalida le firme del codice del chiamante; viene applicata una allowlist di TeamID (TeamID dell'host Peekaboo + TeamID dell'app OmeniaClaw).
Le richieste scadono dopo circa 10 secondi.
Se mancano i permessi richiesti, il bridge restituisce un messaggio di errore chiaro invece di avviare Impostazioni di Sistema.

Comportamento degli snapshot (automazione)

Gli snapshot sono archiviati in memoria e scadono automaticamente dopo una breve finestra. Se hai bisogno di una conservazione più lunga, acquisiscili di nuovo dal client.

Risoluzione dei problemi

Se peekaboo segnala "bridge client is not authorized", assicurati che il client sia firmato correttamente oppure esegui l'host con PEEKABOO_ALLOW_UNSIGNED_SOCKET_CLIENTS=1 solo in modalità debug.
Se non vengono trovati host, apri una delle app host (Peekaboo.app o OmeniaClaw.app) e conferma che i permessi siano concessi.

Correlati

Was this useful?