// Interact with web pages using Chrome DevTools Protocol. Launches a managed browser instance (Helium / Brave Nightly / Chrome) with an isolated profile and exposes nav, eval, screenshot, pick, and emulation helpers. Run scripts/start.js first.
| name | web-browser |
| description | Interact with web pages using Chrome DevTools Protocol. Launches a managed browser instance (Helium / Brave Nightly / Chrome) with an isolated profile and exposes nav, eval, screenshot, pick, and emulation helpers. Run scripts/start.js first. |
Minimal CDP-based browser automation. Scripts live in scripts/ and run via
node. The skill manages its own browser instance with an isolated profile
cache — it never attaches to your live browser profile.
Adapted from mitsuhiko/agent-stuff with Helium + Brave Nightly support.
./scripts/start.js # Fresh isolated profile (default)
./scripts/start.js --profile # Copy WEB_BROWSER_PROFILE into cache
./scripts/start.js --reset-profile # Clear cached profile before launch
Launches the browser with remote debugging on :9222.
~/.cache/agent-web/browser/
fresh-profile/ # default (--no flag)
profile-copy/ # --profile mode
state.json # pid, port, mode, binary
Default preference order (first match wins):
$WEB_BROWSER_PATH (if set + exists)/Applications/Helium.app/Contents/MacOS/Helium/Applications/Brave Browser Nightly.app/Contents/MacOS/Brave Browser Nightly/Applications/Brave Browser.app/Contents/MacOS/Brave Browser--profile mode)$WEB_BROWSER_PROFILE (if set + exists)~/Library/Application Support/BraveSoftware/Brave-Browser-Nightly~/Library/Application Support/BraveSoftware/Brave-Browser~/Library/Application Support/Google/Chrome| Var | Default (nix) | Purpose |
|---|---|---|
WEB_BROWSER_PATH | /Applications/Helium.app/Contents/MacOS/Helium | Browser binary |
WEB_BROWSER_PROFILE | ~/Library/Application Support/BraveSoftware/Brave-Browser-Nightly | Source profile for --profile |
BROWSER_DEBUG_HOST | localhost | CDP host |
BROWSER_DEBUG_PORT | 9222 | CDP port |
DEBUG | unset | Set to 1 for verbose stderr |
WEB_BROWSER_PATH + WEB_BROWSER_PROFILE are set via home.sessionVariables
in home/common/programs/pi-coding-agent/default.nix. Override per-shell by
exporting before invoking the scripts.
./scripts/nav.js https://example.com # current tab
./scripts/nav.js https://example.com --new # new tab
./scripts/eval.js 'document.title'
./scripts/eval.js 'document.querySelectorAll("a").length'
Runs in async context. Prefer single quotes to avoid shell escaping.
./scripts/screenshot.js # viewport
./scripts/screenshot.js --full-page # full document
./scripts/screenshot.js --device iphone-14 # one-off mobile emulation
./scripts/screenshot.js --device pixel-7 --full-page
Writes to a temp file and prints the path.
./scripts/emulate.js --list # show available presets
./scripts/emulate.js iphone-14 # apply preset
./scripts/emulate.js pixel-7 --landscape
./scripts/emulate.js --reset # clear
Sets an active emulation preference. nav.js, eval.js, pick.js,
dismiss-cookies.js, and screenshot.js automatically reapply it.
./scripts/pick.js "Click the submit button"
Interactive picker. Click to select, Cmd/Ctrl+Click for multi-select, Enter to finish.
./scripts/dismiss-cookies.js # accept
./scripts/dismiss-cookies.js --reject # reject where possible
Common chain:
./scripts/nav.js https://example.com && ./scripts/dismiss-cookies.js
start.js automatically spawns watch.js which writes JSONL to:
~/.cache/agent-web/logs/YYYY-MM-DD/<targetId>.jsonl
Tail:
./scripts/logs-tail.js # dump current log + exit
./scripts/logs-tail.js --follow # keep following
Summarize network responses:
./scripts/net-summary.js
./scripts/start.js
./scripts/nav.js https://example.com
./scripts/emulate.js iphone-14
./scripts/nav.js https://example.com # reload with mobile UA
./scripts/dismiss-cookies.js
./scripts/screenshot.js --full-page
Scripts require the ws npm module (declared in scripts/package.json).
The scripts/ directory is built as a buildNpmPackage derivation in
home/common/programs/pi-coding-agent/default.nix (search for
webBrowserScripts), so node_modules/ws is baked into the symlinked
output and resolves automatically at runtime.
To bump the ws version: edit scripts/package.json, run
npm install --package-lock-only inside scripts/, then just home (the
npmDepsHash fake-hash workflow will reveal the new sha256).
The previous version of this skill required browser connect 9222 against a
user-launched browser. The new version owns the browser lifecycle and uses
an isolated profile — your daily browser stays untouched. No connect step.
Structured workflow for research → plan → tickets → work. Use when starting or continuing a task with /task, /plan, or /tickets commands.
Create and refine tickets for the tk ticket system. Use when the user says 'create tickets for X', 'refine ticket X', 'break this into tickets', 'seed tickets from plan', or anything about creating or refining tk tickets.
Work on a single tk ticket end-to-end. Use when the user says 'work on ticket X' or when spawned by work-tickets.sh.
REQUIRED when user says 'pickup', '/pickup', 'handoff', '/handoff' — MUST load this skill BEFORE any other work. Compacts conversations into handoff docs or resumes work from a prior handoff document.
Delegate tasks to other agents - pi sessions or external agents (claude, opencode, aider). Non-blocking with task tracking and completion notifications.
Display code, diffs, images, and other content in a tmux pane or popup, OR render markdown as a single-page interactive HTML and open in the default chromium-family browser. Auto-detects nvim/megaterm for floating popups.