Browser Tools

Minimal CDP tools for collaborative site exploration and scraping.

IMPORTANT: All scripts are located in ~/.codex/skills/browser/ and must be called with full paths.

Setup

Assume packages are already installed. If not, run once:

cd ~/.codex/skills/browser/
npm install

Start Chrome

~/.codex/skills/browser/start.js              # Fresh profile
~/.codex/skills/browser/start.js --profile    # Copy user's profile (cookies, logins)

Start Chrome on :9222 with remote debugging.

Navigate

~/.codex/skills/browser/nav.js https://example.com
~/.codex/skills/browser/nav.js https://example.com --new

Navigate current tab or open new tab.

Evaluate JavaScript

~/.codex/skills/browser/eval.js 'document.title'
~/.codex/skills/browser/eval.js 'document.querySelectorAll("a").length'

Execute JavaScript in active tab. Code is wrapped in return (${code}) — expressions or IIFE for multiple statements:

# ✅ Works
~/.codex/skills/browser/eval.js 'document.title'
~/.codex/skills/browser/eval.js '(() => { const x = 1; return x + 1; })()'

# ❌ Fails
~/.codex/skills/browser/eval.js 'const btn = document.querySelector("button")'

Screenshot

~/.codex/skills/browser/screenshot.js

Screenshot current viewport, returns temp file path.

Pick Elements

~/.codex/skills/browser/pick.js "Click the submit button"

IMPORTANT: Use this tool when the user wants to select specific DOM elements on the page. This launches an interactive picker that lets the user click elements to select them. The user can select multiple elements (Cmd/Ctrl+Click) and press Enter when done. The tool returns CSS selectors for the selected elements.

Common use cases:

• User says "I want to click that button" → Use this tool to let them select it
• User says "extract data from these items" → Use this tool to let them select the elements
• When you need specific selectors but the page structure is complex or ambiguous

Cookies

~/.codex/skills/browser/cookies.js

Display all cookies for the current tab including domain, path, httpOnly, and secure flags. Use this to debug authentication issues or inspect session state.

When to Use

• Testing frontend code in a real browser
• Interacting with pages that require JavaScript
• When user needs to visually see or interact with a page
• Debugging authentication or session issues

Troubleshooting

Timing

Add sleep between operations for UI updates:

sleep 0.5 && ~/.codex/skills/browser/screenshot.js