Skip to main content
Glama
deenesjakoruzh
xlreon

Chrome Actuator

by xlreon
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

Chrome Actuator

Unofficial companion: drive the Chrome window you already have open from an agent (tested with Grok Build). New work lands in a pink Actuator tab group in the current session, not a new Chrome window.

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

v1 is an actuator, not a side-panel chatbot. The agent stays in the terminal. The extension sees the page, assigns @eN refs, and clicks/types. Your cookies and logins stay in Chrome.

Not affiliated with, endorsed by, or sponsored by xAI. "Grok" and "Grok Build" are xAI marks, used here only to describe compatibility. See NOTICE.

Status

Phases 0–3 are in. pnpm gauntlet covers unit tests, the content-script actuator, and a live Chromium tab driven through native messaging.

Phase

What

State

0

Workspace, stable extension id, side panel

done

1

Native messaging heartbeat

done

2

snapshot / press / fill on a real tab

done

3

Agent plugin + /chrome + skill

done

Related MCP server: chrome-dom-mcp

Load the extension

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

  1. Open chrome://extensions

  2. Enable Developer mode

  3. Load unpacked → packages/extension/dist

  4. Pin the extension and click it (or Cmd+Shift+G)

Then register the native host (once) and fully quit Chrome:

node packages/host/dist/install.js

--trust on the plugin install lets the agent operate this Chrome profile. Only do that if you trust the agent.

grok plugin install ./packages/plugin --trust

Side panel should say connected once the MCP host is running.

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

Stable unpacked id (from the committed manifest key): lgkcgenkjaalkfnpmglgpfclkaokblfj

Decisions we will not reopen

  • Brain in the agent, body in Chrome. No in-extension LLM loop in v1.

  • Native messaging, not WebSocket, not Playwright, not agent-device-the-binary.

  • agent-device contract only (snapshot / press / fill).

  • No chrome.debugger in v1 (no yellow infobar).

  • Independent implementation. Do not copy another vendor's brand, marks, or reverse-engineered internals into this tree.

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

License

MIT. See LICENSE and NOTICE.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • chrome-mcp

    dawei008
    F
    license
    Not graded
    quality
    D
    maintenance
    Drive your real, signed-in Chrome browser from any MCP client, enabling browser automation such as navigation, clicking, typing, and screenshots through standard MCP tools.
    1
    -

  • chrome-dom-mcp

    imfaisii
    A
    license
    Not graded
    quality
    B
    maintenance
    Enables real-time browser control and DOM interaction through a Chrome extension bridge, supporting navigation, snapshots, clicks, screenshots, and JavaScript execution.
    MIT

  • browser-bridge

    jeffkit
    A
    license
    Not graded
    quality
    A
    maintenance
    Enables remote agents to control a local Chrome/Edge browser via MCP, supporting navigation, snapshots, clicks, typing, screenshots, and script execution.
    152 npm
    ISC

  • Antigravity Browser Operator

    hashan-lakshitha
    A
    license
    A
    quality
    A
    maintenance
    Enables AI agents to drive the user's already-running Google Chrome through a WebSocket bridge, listing and switching tabs, navigating, clicking, typing, scrolling, extracting DOM, taking screenshots, and evaluating JavaScript. It works without restarting Chrome and preserves all existing logins, cookies, and 2FA sessions.
    11
    MIT