Chrome Actuator

Inoffizieller Begleiter: Steuern Sie das bereits geöffnete Chrome-Fenster über einen Agenten (getestet mit Grok Build). Neue Arbeiten landen in einer pinken Actuator-Tabgruppe in der aktuellen Sitzung, nicht in einem neuen Chrome-Fenster.

tabs_create → snapshot → press @e12 / fill @e5 "text" → settle

Version 1 ist ein Aktuator, kein Side-Panel-Chatbot. Der Agent bleibt im Terminal. Die Erweiterung sieht die Seite, weist @eN-Referenzen zu und klickt/tippt. Ihre Cookies und Anmeldungen bleiben in Chrome.

Nicht verbunden mit, unterstützt oder gesponsert von xAI. „Grok“ und „Grok Build“ sind Marken von xAI, die hier nur zur Beschreibung der Kompatibilität verwendet werden. Siehe HINWEIS.

Status

Die Phasen 0–3 sind abgeschlossen. pnpm gauntlet deckt Unit-Tests, den Inhaltsskript-Aktuator und einen Live-Chromium-Tab ab, der über native Nachrichtenübermittlung gesteuert wird.

Related MCP server: monkeysee

Erweiterung laden

cd /path/to/chrome-actuator
pnpm install
pnpm --filter @chrome-actuator/extension build

1. Öffnen Sie chrome://extensions

2. Aktivieren Sie den Entwicklermodus

3. Entpackte Erweiterung laden → packages/extension/dist

4. Heften Sie die Erweiterung an und klicken Sie darauf (oder Cmd+Shift+G)

Registrieren Sie dann den nativen Host (einmalig) und beenden Sie Chrome vollständig:

node packages/host/dist/install.js

--trust bei der Plugin-Installation ermöglicht es dem Agenten, dieses Chrome-Profil zu bedienen. Tun Sie dies nur, wenn Sie dem Agenten vertrauen.

grok plugin install ./packages/plugin --trust

Die Seitenleiste sollte connected anzeigen, sobald der MCP-Host läuft.

pnpm gauntlet   # unit + L3 + live native-messaging L4

Stabile entpackte ID (aus dem festgeschriebenen Manifest-key): lgkcgenkjaalkfnpmglgpfclkaokblfj

Entscheidungen, die wir nicht wieder aufgreifen werden

• Gehirn im Agenten, Körper in Chrome. Keine Erweiterungsinterne LLM-Schleife in v1.

• Native Nachrichten, nicht WebSocket, nicht Playwright, nicht Agent-Device-Das-Binärprogramm.

• Agent-Device Vertrag nur (snapshot / press / fill).

• Kein chrome.debugger in v1 (keine gelbe Infoleiste).

• Unabhängige Implementierung. Kopieren Sie keine Marke, Marken oder rückentwickelten Interna eines anderen Anbieters in diesen Baum.

Layout

packages/shared      protocol, snapshot grammar, target parser
packages/extension   MV3 side panel + service worker
packages/host        MCP + native host
packages/plugin      Grok Build plugin (compatibility layer)

Tests

pnpm --filter @chrome-actuator/shared test

Lizenz

MIT. Siehe LIZENZ und HINWEIS.