为什么值得关注

它弥合了无头自动化与直接 GUI 观察之间的鸿沟，让开发者无需离开终端即可实时查看并干预自动化过程，这在浏览器自动化工具中非常罕见。

适合谁使用

偏好 CLI 的开发者与终端爱好者
构建浏览器自动化工作流的 AI 代理开发者
使用 Playwright、Browser Use 或基于 CDP 工具的 QA 工程师
希望在终端内预览本地开发服务器的开发者

典型使用场景

实时观察和调试 AI 驱动的浏览器自动化过程
在终端内交互式检查本地开发服务器，无需单独打开浏览器
在自动化中中途接管控制权以修复 UI 问题或检查状态
使用 Playwright 或其他 CDP 客户端运行自动化，同时拥有可见且可交互的浏览器面板

项目优势

实时交互面板展示自动化过程，而非事后仅通过截图重建
无缝双向控制：代理驱动的同时，人类可随时用鼠标/键盘接管，而无需断开连接
持久化的 Chrome 配置文件跨会话保留 Cookie、登录状态和存储
CDP 网关提供通过标准协议进行完全自动化控制的能力，兼容 Playwright、MCP 工具等

使用前须知

并非通用浏览器；缺少 DevTools、扩展、下载、右键菜单和输入法支持
需要支持 Kitty 图形协议的终端以及 Herdr 的实验性图形功能，不适合远程 SSH 使用
当前仅支持 Linux 和 macOS；不支持 Windows、弹出式布局、页面文本选择、剪贴板复制和页面内查找

README 快速开始

Herdr Browser

Herdr Browser renders a real Chromium view inside a Herdr pane and exposes it to Chrome DevTools Protocol clients. An agent drives the browser, you watch it in the pane, and you take over with the mouse and keyboard at any point without detaching the automation client.

Browser automation is normally invisible. The agent runs headless and you reconstruct what happened from screenshots after the fact, or you babysit a detached Chrome window that has no relationship to your session. Herdr Browser puts the automated browser in the layout you are already working in, live, and makes it directly interactive.

What This Is Not

This is not a general-purpose browser. A desktop browser wins on devtools, extensions, video, downloads, right-click menus, and IME, and this plugin does not try to compete with it. Use it to observe and steer automation, and to preview local development servers without leaving the terminal.

Requirements

Herdr 0.7.4 or newer
Linux or macOS
Bun
Google Chrome or Chromium
A Kitty graphics-compatible terminal such as Ghostty, kitty, or WezTerm

Enable Herdr's experimental graphics support in your Herdr configuration:

[experimental]
kitty_graphics = true

Apply the change by restarting Herdr or running:

herdr server reload-config

Install

Install the published plugin from GitHub:

herdr plugin install ogulcancelik/herdr-browser --yes

For local development, link this checkout instead:

herdr plugin link ~/Projects/herdr-browser

Agent Browser Automation

Herdr Browser includes a CLI in the plugin directory; it does not install a global executable. Find the active checkout with:

herdr plugin list --plugin official.browser --json

Read result.plugins[0].plugin_root, then run the CLI with Bun:

bun run "/src/cli.ts" views
bun run "/src/cli.ts" connect --view

views lists browser views currently backed by visible plugin panes. connect starts a loopback CDP gateway scoped to the selected view and returns its HTTP and WebSocket endpoints. The gateway represents the complete browser view, not only its active tab. Browser Use, PinchTab, Playwright, and other CDP clients can navigate and manage tabs through their normal APIs while the Herdr tab strip and rendered page follow standard CDP target activation.

Point a client at the retu

项目描述

Render a real Chromium view inside a Herdr pane and drive it over CDP.

herdr-browser