dev-browser 教程

按 dev-browser README 走一遍。跑通标准：一段脚本能 goto https://example.com 并打印 title()。

本机 npm install dev-browser 时 postinstall 去拉 dev-browser-darwin-arm64，GitHub release-assets 超时，二进制没装上，所以没能跑通 --headless 示例。下面命令与官方 Quick start 一致，请在能访问 GitHub Releases 的环境执行。

1. 安装 CLI

npm install -g dev-browser
dev-browser install

install 只在找不到 Chrome 时需要。支持 macOS 和 glibc Linux；Windows / musl 官方尚未支持。包管理器拦住 lifecycle scripts 时，按 README 跑 npm rebuild -g dev-browser。

2. 跑通一次

官方 Quick start，整段复制：

dev-browser --headless <<'EOF'
const page = await browser.getPage("main");
await page.goto("https://example.com");
console.log(await page.title());
EOF

成功时终端应打印 Example Domain。

要接到已经打开的 Chrome：

dev-browser chrome
dev-browser --connect <<'EOF'
console.log(await browser.listPages());
EOF

3. 给编码 Agent 装 skill

dev-browser install-skill

或分别 --codex / --claude / --agents。新开对话，让 Agent 先跑 dev-browser --help。

4. 翻车点

官方：Chrome 136 以后默认配置文件不接受远程调试。dev-browser chrome 用独立配置文件。Snap 包装的 Chromium 读不了 ~/.dev-browser/v1。

出处：README