One install command wires 8 CLI coding agents to a shared stealth Chromium

개요

browser-harness-kit은 Claude Code, Codex CLI, pi, opencode, Gemini CLI, Kiro, Amp, Crush 등 8개의 CLI 코딩 에이전트가 각각 사용하는 헤드리스 Chromium을 공통의 스텔스 Chromium으로 통합하고 설정을 자동화하는 도구입니다.

주요 내용

* 문제점: 다양한 CLI 코딩 에이전트들이 각자 별도의 헤드리스 Chromium을 사용하며, 이는 기본적인 봇 탐지(navigator.webdriver, missing plugins 등)에 의해 차단됩니다. 또한, 각 에이전트마다 설정 파일 위치와 형식이 달라 수동으로 통합하는 데 번거로움이 있습니다.
* 해결책: browser-harness-kit은 설치 명령 하나로 8개 에이전트의 설정을 감지하고, 각 에이전트별 규칙 파일을 올바르게 작성하며, ~/.playwright/cli.config.json 파일을 생성하여 모든 에이전트가 pi-playwright를 통해 동일한 스텔스 Chromium을 사용하도록 구성합니다.
* 결과: 각 에이전트는 navigator.webdriver 체크, 플러그인/mimeType 길이 체크, window.chrome 형태 등 봇 탐지를 통과하는 실제 헤드 Chromium을 구동할 수 있습니다.
* 범위: 이 프로젝트는 통합 설정(integration glue)만을 제공하며, 스텔스 Chromium 빌드(CloakBrowser), Playwright, pi-playwright, 또는 8개의 CLI 에이전트 자체를 포함하거나 재배포하지 않습니다.
* 공유 이유: 개발자가 자신의 환경을 설정하는 과정에서 반복되는 번거로움을 줄이기 위해 개발되었으며, 다른 개발자들도 동일한 수고를 덜 수 있도록 공개되었습니다.
* 기술 스택: WSL2 + Ubuntu 24.04 + Node 22 환경에서 테스트되었으며, MIT 라이선스로 제공됩니다.
* 확장성: 새로운 CLI 에이전트에 대한 어댑터 추가를 위한 PR을 환영합니다.

시사점

browser-harness-kit은 여러 CLI 코딩 에이전트를 사용하는 개발자의 설정 과정을 자동화하여 생산성을 향상시키고, 봇 탐지를 우회하는 스텔스 Chromium을 효율적으로 활용할 수 있게 지원합니다.