interceptor-browser

name	interceptor-browser
description	Drive a signed-in Chrome / Brave session via the interceptor CLI: open/read pages, click, type, inspect DOM/text/network, automate rich browser editors and scene graphs, capture WebSocket/Beacon/BroadcastChannel traffic, record/replay flows, take VLM-budgeted screenshots, compare pages, and route to specific browser profiles with --context. Use for browser page content, tabs, forms, SPA extraction, request overrides, page communication capture, and deployment checks. Not for native macOS apps, Electron desktop app web contents, OS dialogs, browser chrome, or large scraping.
metadata	{"short-description":"Drive a real signed-in Chrome / Brave session via the interceptor CLI"}

Interceptor Browser

Agent-operator skill for the Browser surface of Interceptor. Use the interceptor CLI (no prefix) to drive a live Chrome / Brave session: pages, network, scene graph, monitor, screenshots. For native macOS apps load interceptor-macos instead.

This installed skill is self-contained. Source checkouts also have AGENTS.md, but packaged users may only have the skill directory below /Library/Application Support/Interceptor/skills.

Core Rules

• Use compound commands (open, read, act, inspect) before low-level verbs.
• Browser commands operate inside managed Interceptor tab groups. Do not use --any-tab unless the user explicitly authorizes acting outside those groups.
• When other agents may share this browser, scope yourself with --group <label> on every command (or set INTERCEPTOR_GROUP once): your tabs live in their own colored group, resolution never leaves it, and cross-group targets are rejected. Run interceptor group close <label> when your job is done; interceptor group list shows what's running.
• interceptor open <url> and interceptor tab new <url> create background tabs by default. Only open --activate, tab new --activate, tab switch <id>, and window focus <id> intentionally move browser focus.
• If multiple browser profiles are connected, run interceptor contexts and pass --context <id>.
• Prefer structured reads (read, tree, text, inspect, scene) before screenshots. Open references/screenshot-policy.md before screenshot-heavy work.
• Default to plain text output. Use --json only when piping into scripts or when a downstream tool needs a machine-readable contract.
• If an already-loaded unpacked extension behaves stale after a package update, reload it from chrome://extensions or brave://extensions, or run interceptor reload once the extension is reachable.

Fast Path

interceptor status                        # 1. Confirm daemon + extension are alive
interceptor open "https://example.com"    # 2. Background tab + wait + tree + text
interceptor read                          # 3. Current state (re-read after any mutation)
interceptor act e5                        # 4. Click ref e5 (refs come from `read`)
interceptor act e7 "example user"         # 5. Type into ref e7
interceptor inspect                       # 6. Tree + text + network in one read

Inside this repo without interceptor on PATH, use ./dist/interceptor ....

Workflows

Each workflow is a complete self-contained "you are doing X" procedure. Open the file when the task matches.

Workflow	When to invoke
workflows/verify-deploy.md	"Verify the deploy", "check that X works on the page", reproducing a bug before touching code
workflows/read-and-extract.md	Compound page read + SPA state extraction — pull a specific value off a page
workflows/drive-rich-editor.md	Canva, Google Docs, Google Slides, design-tool layer manipulation — anything where DOM refs aren't enough
workflows/rich-editor-workflows.md	Canva shape insertion, Docs table build+fill, Slides table insert — what works natively vs the eval --main last mile
workflows/google-docs-fill-empty-table-cells.md	Fill empty Docs table cells with the value above (canvas caret + per-char typing + Tab)
workflows/canva-custom-size-creation.md	Create a custom-size Canva design from home (normalized semantic replay) + monitor launch/handoff pattern
workflows/cook-in-canvas.md	Draw effects/markers directly through a page's own CanvasRenderingContext2D (Docs/Excalidraw), pixel-verified
workflows/cook-on-top-of-pages.md	"Cook" a live page in-place — banners, HUDs, overlays that track real DOM, full-screen takeovers, over the real session
workflows/override-xhr.md	Mutate a request before it hits the server — change params, force a status, throttle
workflows/capture-page-communication.md	Capture WebSocket, Beacon, and BroadcastChannel activity without CDP
workflows/record-and-replay.md	Learn a real user flow, export a replay plan, run it back
workflows/screenshot-for-vlm.md	Take a screenshot the model will actually understand — VLM-budgeted, WebP, on-disk
workflows/multi-page-compare.md	Compare facts across multiple pages (e.g. "who designed Python vs JavaScript") — sequential open --text-only per page

References

File	Topic
references/browser-and-network.md	Command selection, SPA extraction, request overrides, SSE capture, page-world eval --main cautions
references/page-communication-capture.md	P1 WebSocket, Beacon, and BroadcastChannel capture mechanics, commands, event shapes, and limits
references/rich-editors.md	Overview: Canva, Google Docs, Google Slides behavior, canvas-rendered editor input, WebGL camera apps, blob export capture (deep mechanics in the four references/canvas-*/webgl-*/blob-* files below)
references/canvas-rendered-editor-input.md	Deep mechanic: caret / typing / key-nav inside canvas-rendered editors (Docs/Slides/Sheets) via dispatched events + iframe-window KeyboardEvent. The eval --main + __interceptor_trust/userActivation foundation lives here.
references/canvas-camera-overlays.md	Deep mechanic: pan/zoom a WebGL map viewer + lat/lng DOM overlays (Web Mercator), URL-watcher pattern, CSS-filter restyle
references/webgl-camera-control.md	Deep mechanic: generic, app-agnostic WebGL camera control + overlay anchoring
references/blob-export-capture.md	Deep mechanic: capture a webapp's client-side export bytes (PNG/PDF/SVG) with no Save dialog
references/monitor-and-replay.md	Monitor session behavior, replay-plan generation, cross-tab/focus-follow notes
references/command-catalog.md	Full browser command surface with flags and examples
references/screenshot-policy.md	VLM-aware screenshot budget table; agent-default recipe

When To Switch Surfaces

If the target is outside the page - a native dialog, browser chrome (URL bar, profile picker), Save/Open file picker, OS notification, or any non-browser macOS app - load interceptor-macos instead.

If the target is an Electron / Chromium desktop app's web contents (Slack, VS Code, Notion, Descript, etc.), use the CDP/app reference from interceptor-macos: references/cdp-app.md.

Do Not Default To Troubleshooting

• User wants a browser task completed → run Interceptor commands.
• User wants Interceptor fixed, installed, or explained → that's a separate task; ask before diving into repo state.
• Inside the Interceptor repo, use this skill for live browser validation, not as the primary source of repo-development instructions.