herdr-browser — Herdr pane 안의 실제 Chromium 뷰 (CDP 자동화)

herdr-browser는 herdr의 공식 브라우저 플러그인으로, Herdr pane 안에 실제 Chromium 뷰를 렌더링하고 Chrome DevTools Protocol(CDP) 클라이언트가 그 뷰를 제어하게 해준다. 에이전트가 브라우저를 자동화하는 동안 사람은 pane에서 실시간으로 보고, 언제든 마우스·키보드로 개입해 제어권을 가져올 수 있다. TypeScript/Bun, MIT, 226 스타 (2026-08-02).

한 줄 요약

보이지 않는 headless 브라우저 대신, 이미 작업 중인 터미널 레이아웃 안에 브라우저가 살아있는 형태. 에이전트(Browser Use, Playwright, Chrome DevTools MCP 등)는 view-scoped CDP gateway를 통해 제어하고, 사람은 같은 화면을 보며 중간에 개입 가능.

핵심 특징

실제 Chromium 뷰 렌더링 — CDP screencast 프레임이 Herdr pane graphics stream(Kitty graphics)으로 터미널에 도달. 수동 조작(클릭·스크롤·호버·타이핑·툴바)이 자동화 클라이언트와 동일한 target에 적용
View-scoped CDP gateway — connect 명령이 loopback CDP HTTP/WebSocket 엔드포인트를 반환. 완전한 브라우저 뷰(활성 탭뿐 아니라)를 나타내며, Browser Use·PinchTab·Playwright·Chrome DevTools MCP가 정상 API로 탭 생성·선택·닫기 가능
개입 가능 — 클라이언트 연결 중에도 pane은 완전 인터랙티브. 중간에 제어를 가로채고 다시 넘겨줄 수 있음. 자동화 클라이언트가 닫혀도 플러그인 브라우저는 유지
로컬 개발 링크 핸들러 — localhost/127.0.0.1/[::1] URL을 Control+클릭하면 Herdr에서 브라우저 pane으로 열림 (개발 서버 프리뷰에 특화)
세션별 격리 프로필 — Herdr 세션마다 별도 headless Chromium + 영구 프로필. 쿠키·로그인·origin storage가 pane/데몬 재시작에도 생존. 일반 브라우저 프로필은 재사용하지 않음
성능 튜닝 — paint-driven 캡처, Page.screencastFrameAck 지연으로 backpressure. passive 15 FPS, 직접 입력 시 750ms간 30 FPS. 정적 페이지는 거의 무전송. HiDPI 부담은 captureScale(0.1~1)로 조절

요구사항

Herdr 0.7.4+ (실험적 Kitty graphics 설정 필요: [experimental] kitty_graphics = true)
Linux 또는 macOS, Bun, Google Chrome/Chromium
Kitty graphics 호환 터미널: Ghostty, kitty, WezTerm

설치

herdr plugin install ogulcancelik/herdr-browser --yes
# 로컬 개발
herdr plugin link ~/Projects/herdr-browser

사용 흐름

# 브라우저 pane 열기 (오른쪽 스플릿)
herdr plugin pane open --plugin official.browser --entrypoint browser --placement split --direction right --focus
 
# CDP gateway 연결 (플러그인 루트 확인 후 Bun으로 CLI 실행)
bun run "<plugin_root>/src/cli.ts" views
bun run "<plugin_root>/src/cli.ts" connect --view <view_id>
# 반환된 cdp_http_url / browser_ws_url을 Browser Use(BU_CDP_URL) 또는 Playwright(connectOverCDP)에 지정

에이전트용 스킬 문서(skills/herdr-browser/SKILL.md)도 저장소에 포함되어 있다.

현재 한계

일반 브라우저가 아님 — devtools, 확장, 비디오, 다운로드, 우클릭 메뉴, IME 미지원. “자동화 관찰·개입 + 로컬 개발 서버 프리뷰”용
Windows, true popup placement, 다운로드, 텍스트 선택·클립보드·find-in-page 미지원
프레임당 대역폭이 커서 원격 SSH 세션에는 부적합 (로컬 세션 튜닝)
Chromium 자동 다운로드 없음 — 미설치 시 시작 실패

데이터 출처 메모

메타데이터는 GitHub REST API 실측(ogulcancelik/herdr-browser), README·SKILL.md는 main 브랜치 원문 캡처(raw/articles/github-ogulcancelik-herdr-browser.md, sha256 검증 완료).
226 스타는 생성(2026-07-26) 후 1주일 미만 시점의 실측 — 초기 단계 프로젝트. 동작은 문서 기반 설명이며 직접 실행 검증은 하지 않음.

description	Herdr 터미널 멀티플렉서의 공식 브라우저 플러그인. pane 안에 실제 Chromium을 렌더링하고 CDP 클라이언트가 제어.
tags	ai-agents, browser, browser-automation, cdp, chromium, herdr-plugin, terminal, kitty-graphics, dev-tools, open-source

LLM Wiki

탐색기