name	chromium-debug-use
description	Attach to a user's already-open Chromium-family browser for live inspection and light interaction after explicit local approval
mode	subagent

Chromium Debug Use

Read tools/browser/chromium-debug-use.md first.

Use This Skill When

The user wants to inspect or lightly interact with something already open in a Chromium-family browser (Chrome, Brave, Edge, Vivaldi, Chromium) before committing to a heavier automation tool.

Workflow

Confirm explicit, user-approved live-session investigation.
If the debug port is not yet open, have the user launch with the flag from tools/browser/chromium-debug-use.md.
Use .agents/scripts/chromium-debug-use-helper.sh version and list to confirm access.
Prefer snapshot, html, and eval to understand the page before using click, type, navigate, or screenshot.
Once the flow is understood, hand off to the best-fit longer-term tool:
- tools/browser/playwright.md — repeatable isolated automation
- tools/browser/dev-browser.md — aidevops-managed persistent profile
- tools/browser/playwriter.md — per-tab extension consent in the user's normal browser
- tools/browser/chrome-devtools.md — performance, network, and console inspection

Safety

Local-only and temporary; the user must have enabled the debug path for this investigation.
Prefer loopback endpoints and temporary profiles.
Do not use this path for unrelated tabs or long-lived background control.

Commands

.agents/scripts/chromium-debug-use-helper.sh version
.agents/scripts/chromium-debug-use-helper.sh list
.agents/scripts/chromium-debug-use-helper.sh snapshot <target>
.agents/scripts/chromium-debug-use-helper.sh html <target> [selector]
.agents/scripts/chromium-debug-use-helper.sh eval <target> "document.title"
.agents/scripts/chromium-debug-use-helper.sh click <target> "button.submit"
.agents/scripts/chromium-debug-use-helper.sh type <target> "hello world"
.agents/scripts/chromium-debug-use-helper.sh screenshot <target> /tmp/page.png

Use --browser-url http://127.0.0.1:9222 when the session is not on the default endpoint.

Chromium Debug Use

Read tools/browser/chromium-debug-use.md first.

Use This Skill When

The user wants to inspect or lightly interact with something already open in a Chromium-family browser (Chrome, Brave, Edge, Vivaldi, Chromium) before committing to a heavier automation tool.

Workflow

Confirm explicit, user-approved live-session investigation.

If the debug port is not yet open, have the user launch with the flag from tools/browser/chromium-debug-use.md.

Use .agents/scripts/chromium-debug-use-helper.sh version and list to confirm access.

Prefer snapshot, html, and eval to understand the page before using click, type, navigate, or screenshot.

Once the flow is understood, hand off to the best-fit longer-term tool:

tools/browser/playwright.md — repeatable isolated automation
tools/browser/dev-browser.md — aidevops-managed persistent profile
tools/browser/playwriter.md — per-tab extension consent in the user's normal browser
tools/browser/chrome-devtools.md — performance, network, and console inspection

Safety

Local-only and temporary; the user must have enabled the debug path for this investigation.

Prefer loopback endpoints and temporary profiles.

Do not use this path for unrelated tabs or long-lived background control.

Commands

.agents/scripts/chromium-debug-use-helper.sh version .agents/scripts/chromium-debug-use-helper.sh list .agents/scripts/chromium-debug-use-helper.sh snapshot <target> .agents/scripts/chromium-debug-use-helper.sh html <target> [selector] .agents/scripts/chromium-debug-use-helper.sh eval <target> "document.title" .agents/scripts/chromium-debug-use-helper.sh click <target> "button.submit" .agents/scripts/chromium-debug-use-helper.sh type <target> "hello world" .agents/scripts/chromium-debug-use-helper.sh screenshot <target> /tmp/page.png

Use --browser-url http://127.0.0.1:9222 when the session is not on the default endpoint.

chromium-debug-use