Openwork browser-setup-devtools
Guide users through browser automation setup using Chrome DevTools MCP as the primary path and the OpenCode browser extension as a fallback. Use when the user asks to set up browser automation, Chrome DevTools MCP, browser MCP, browser extension, or runs the browser-setup command.
install
source · Clone the upstream repo
git clone https://github.com/different-ai/openwork
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/different-ai/openwork "$T" && mkdir -p ~/.claude/skills && cp -r "$T/.opencode/skills/browser-setup-devtools" ~/.claude/skills/different-ai-openwork-browser-setup-devtools && rm -rf "$T"
manifest:
.opencode/skills/browser-setup-devtools/SKILL.mdsource content
Browser automation setup (DevTools MCP first)
Principles
- Keep prompts minimal; do as much as possible with tools and commands.
- Always attempt Chrome DevTools MCP first; only fall back to the browser extension when DevTools MCP cannot be used.
Workflow
- Ask: "Do you have Chrome installed on this computer?"
- If no or unsure:
- Offer to open the download page yourself and do it if possible.
- Provide a clickable link: https://www.google.com/chrome/
- Continue after installation is confirmed.
- Check DevTools MCP availability:
- Call
.chrome-devtools_list_pages - If pages exist, select one with
.chrome-devtools_select_page - If no pages, create one with
(use https://example.com) and then select it.chrome-devtools_new_page
- Call
- If DevTools MCP calls fail:
- Ask the user to open Chrome and keep it running.
- Retry
.chrome-devtools_list_pages - If it still fails, ensure
includesopencode.jsonc
with commandmcp["chrome-devtools"]
and ask the user to restart OpenWork/OpenCode.['npx', '-y', 'chrome-devtools-mcp@latest'] - Retry the DevTools MCP check.
- If DevTools MCP is ready:
- Offer a first task ("Let's try opening a webpage").
- If yes, use
orchrome-devtools_navigate_page
to open the URL and confirm completion.chrome-devtools_new_page
- Fallback only if DevTools MCP cannot be used:
- Check availability with
orbrowser_version
.browser_status - If missing, run
yourself.npx @different-ai/opencode-browser install - Open the Extensions page yourself when possible:
- macOS:
open -a "Google Chrome" "chrome://extensions" - Windows:
start chrome://extensions - Linux:
xdg-open "chrome://extensions"
- macOS:
- Tell the user to enable Developer mode, click "Load unpacked", and select
, then pin the extension.~/.opencode-browser/extension - Re-check availability with
.browser_version - Offer a first task and use
.browser_open_tab
- Check availability with
Response rules
- Keep each user prompt to one short sentence when possible.
- Use direct offers like "I can open Chrome now" and follow with tool actions.
- Always present links as clickable URLs.