Terminal
Terminal/Skill
Loads an unpacked Chrome extension in a test browser, opens its popup or side panel, and lets you click through it.
By Adobe
Works with
npx skills add adobe/skills --skill cdp-ext-pilotLaunch Chrome with an unpacked extension, open its UI, interact via CDP.
Composes on cdp-connect — load that skill first for cdp.js commands.
# Locate cdp-ext-pilot.mjs
if [[ -n "${CLAUDE_SKILL_DIR:-}" ]]; then
EXT_PILOT="${CLAUDE_SKILL_DIR}/scripts/cdp-ext-pilot.mjs"
else
EXT_PILOT="$(command -v cdp-ext-pilot.mjs 2>/dev/null || \
find ~/.claude -path "*/cdp-ext-pilot/scripts/cdp-ext-pilot.mjs" -type f 2>/dev/null | head -1)"
fi
# Locate cdp.js (from cdp-connect skill)
if [[ -n "${CLAUDE_SKILL_DIR:-}" ]]; then
CDP_JS="$(find "$(dirname "${CLAUDE_SKILL_DIR}")" -path "*/cdp-connect/scripts/cdp.js" -type f 2>/dev/null | head -1)"
fi
CDP_JS="${CDP_JS:-$(command -v cdp.js 2>/dev/null || \
find ~/.claude -path "*/cdp-connect/scripts/cdp.js" -type f 2>/dev/null | head -1)}"
node "$EXT_PILOT" launch <path-to-extension-dist> [--port 9222]
Returns JSON with extensionId, port, chromeVariant. Auto-installs
Chrome for Testing if no suitable Chrome is found.
Verify: Confirm extensionId is non-null. If null: check the extension
path has a valid manifest.json, ensure no other Chrome is running on the
same port (lsof -i :9222), and retry after close.
node "$EXT_PILOT" open sidepanel [--port 9222] # Opens sidepanel, returns target ID
node "$EXT_PILOT" open popup [--port 9222] # Opens popup as tab
node "$EXT_PILOT" open options [--port 9222] # Opens options page as tab
For sidepanel: navigates to a page first if no page target exists.
Use cdp-connect commands with --id <target-id> from Phase 2:
node "$CDP_JS" ax-tree --id <target-id> # Understand the UI
node "$CDP_JS" screenshot /tmp/ext.png --id <tid> # Visual check
node "$CDP_JS" click "button" --id <tid> # Click elements
node "$CDP_JS" type "input" "text" --id <tid> # Type into fields
node "$CDP_JS" eval "expression" --id <tid> # Run JS
node "$EXT_PILOT" status [--port 9222] # Check session state
node "$EXT_PILOT" close [--port 9222] # Kill Chrome, remove profile
cdp.js type sets DOM .value which does not trigger
React state updates. Focus the element first with
cdp.js eval "document.querySelector('input').focus()", then use
Input.insertText via eval to type character by character.launch fails, another Chrome is on that port.
Run close first, or pass --port <other>.