sawyerhood/dev-browser

Do Browser가 제공했습니다.

dev-browser는 코딩 에이전트가 짧은 자바스크립트 스크립트로 크롬을 제어할 수 있게 합니다. 브라우저는 호출 사이에 열려 있습니다. 그래서 상담원은 한 번만 탐색하고, 페이지를 검사하고, 행동하며, 매번 처음부터 다시 시작하지 않고 결과를 검증할 수 있습니다.

주요 특징:

• 영속 페이지. 이름 탭은 스크립트 간에 상태를 전달합니다.
• 컴팩트 스냅샷. 접근성 트리는 에이전트에게 읽기 쉬운 출력과 안정적인 요소 참조를 제공합니다.
• Real Puppeteer. 스크립트는 Puppeteer Page API와 소수의 에이전트 중심 헬퍼 세트를 사용합니다.
• 실행 또는 첨부. 격리된 크롬 프로필을 시작하거나 이미 열어둔 브라우저에 연결하세요.

데모

https://github.com/user-attachments/assets/c6cf7fb9-b1dc-46ed-93b9-6e7240990c53

CLI 설치

릴리스 바이너리에는 Bun과 Puppeteer가 포함되어 있습니다. 설치 후에는 Node가 필요하지 않습니다. macOS와 GLIBC 리눅스는 지원; Windows와 musl Linux는 아직 지원되지 않습니다.

스냅 패키지 Chromium은 기본 ~/.dev-browser/v1 디렉터리를 읽을 수 없습니다. Ubuntu에서는 [[T3]를 사용하세요. 또는 DEV_BROWSER_CHROME를 다른 크롬 바이너리로 가리키는 것.

Brought to you by Do Browser.

dev-browser lets coding agents control Chrome with short JavaScript scripts. The browser stays open between calls, so an agent can navigate once, inspect the page, act, and verify the result without starting over each time.

Key features:

• Persistent pages. Named tabs carry state across scripts.
• Compact snapshots. Accessibility trees give agents readable output and stable element refs.
• Real Puppeteer. Scripts use the Puppeteer Page API plus a small set of agent-focused helpers.
• Launch or attach. Start an isolated Chrome profile or connect to a browser you already have open.

Demo

https://github.com/user-attachments/assets/c6cf7fb9-b1dc-46ed-93b9-6e7240990c53

CLI installation

npm install -g dev-browser
dev-browser install    # only needed if dev-browser cannot find Chrome

The release binary includes Bun and Puppeteer. Node is not required after installation. macOS and glibc Linux are supported; Windows and musl Linux are not yet supported.

Snap-packaged Chromium cannot read the default ~/.dev-browser/v1 directory. On Ubuntu, use dev-browser install or point DEV_BROWSER_CHROME at another Chrome binary.

If your package manager blocks lifecycle scripts, run npm rebuild -g dev-browser, pnpm approve-builds -g dev-browser, or bun pm -g trust dev-browser. The CLI will also try to download its binary on first use. For a private mirror, set DEV_BROWSER_DOWNLOAD_BASE; set DEV_BROWSER_SKIP_DOWNLOAD=1 if you install the binary yourself.

Quick start

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

# Attach to Chrome started with `dev-browser chrome`
dev-browser chrome
dev-browser --connect <<'EOF'
console.log(await browser.listPages());
EOF

Chrome 136 and newer ignore remote-debugging flags on the default profile. dev-browser chrome handles this by using a dedicated profile and checking that Chrome actually started.

Using it with coding agents

Tell the agent to run dev-browser --help. The built-in guide covers the current API and the preferred look → act → verify workflow.

Agents that discover local skills can install the bundled skill explicitly:

dev-browser install-skill --codex   # ~/.codex/skills/dev-browser/SKILL.md
dev-browser install-skill --claude  # ~/.claude/skills/dev-browser/SKILL.md
dev-browser install-skill --agents  # ~/.agents/skills/dev-browser/SKILL.md

Run dev-browser install-skill without flags to update all three locations.

Idle browser cleanup

Launched browsers close after 30 minutes without a script by default. Change that per command, in the environment, or in ~/.dev-browser/v1/config.json: