Chrome Actuator

Неофициальный компаньон: управляйте уже открытым окном Chrome из агента (протестировано с Grok Build). Новые действия размещаются в розовой группе вкладок Actuator в текущем сеансе, а не в новом окне Chrome.

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

v1 — это актуатор, а не чат-бот в боковой панели. Агент остаётся в терминале. Расширение видит страницу, присваивает ссылки @eN и выполняет клики/ввод. Ваши куки и логины остаются в Chrome.

Не аффилировано с, не одобрено и не спонсировано xAI. «Grok» и «Grok Build» являются товарными знаками xAI, используемыми здесь только для описания совместимости. См. УВЕДОМЛЕНИЕ.

Статус

Фазы 0–3 внедрены. pnpm gauntlet охватывает модульные тесты, актуатор скрипта содержимого и активную вкладку Chromium, управляемую через родные сообщения.

Related MCP server: monkeysee

Загрузка расширения

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

1. Откройте chrome://extensions

2. Включите Режим разработчика

3. Загрузить распакованное → packages/extension/dist

4. Закрепите расширение и нажмите на него (или Cmd+Shift+G)

Затем зарегистрируйте родной хост (один раз) и полностью закройте Chrome:

node packages/host/dist/install.js

--trust при установке плагина позволяет агенту управлять этим профилем Chrome. Делайте это только если доверяете агенту.

grok plugin install ./packages/plugin --trust

Боковая панель должна показывать connected после запуска MCP-хоста.

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

Стабильный id распакованного расширения (из сохранённого в манифесте ключа key): lgkcgenkjaalkfnpmglgpfclkaokblfj

Решения, которые мы не будем пересматривать

• Мозг в агенте, тело в Chrome. Никакого цикла LLM внутри расширения в v1.

• Родные сообщения, не WebSocket, не Playwright, не agent-device-the-binary.

• Только контракт agent-device (snapshot / press / fill).

• Без chrome.debugger в v1 (без жёлтой информационной панели).

• Независимая реализация. Не копируйте чужой бренд, товарные знаки или результаты обратного проектирования в этот репозиторий.

Схема

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)

Тесты

pnpm --filter @chrome-actuator/shared test

Лицензия

MIT. См. ЛИЦЕНЗИЯ и УВЕДОМЛЕНИЕ.