Herdr Browser renders a real Chromium view inside a Herdr pane, exposes Chrome DevTools Protocol (CDP) for automation, and supports seamless switching between agent-driven and manual interaction.

Stars

95

7-day growth

No data

Forks

2

Open issues

0

License

MIT

Last updated

2026-07-27

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It bridges headless automation and direct GUI observation, letting developers watch and intervene in real time without leaving the terminal, which is rare in browser automation tools.

Who it is for

  • CLI-first developers and terminal enthusiasts
  • AI agent developers building browser-automated workflows
  • QA engineers using Playwright, Browser Use, or CDP-based tools
  • Developers previewing local web servers from within the terminal

Use cases

  • Observing and debugging AI-driven browser automation live
  • Interactively inspecting local development servers without opening a separate browser
  • Handing over control mid-automation to fix a UI issue or inspect state
  • Running Playwright or other CDP clients with a visible, interactive browser pane

Strengths

  • Live interactive pane shows automation in real time, not just screenshots after the fact
  • Seamless two-way control: agent drives while human can take over mouse/keyboard without disconnecting
  • Persistent Chrome profiles across sessions preserve cookies, logins, and storage
  • CDP gateway gives full automation control via standard protocol – works with Playwright, MCP tools, and others

Considerations

  • Not a general-purpose browser; lacks DevTools, extensions, downloads, right-click menus, and IME support
  • Requires a Kitty-graphics-compatible terminal and Herdr experimental graphics, not suitable for remote SSH
  • Currently limited to Linux and macOS; Windows, popup placement, page text selection, clipboard copy, and find-in-page are not supported

README quick start

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

Description

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

Related repositories

Similar projects matched by category, topics, and programming language.

l0ng-ai
Featured
l0ng-ai GitHub avatar

tty7

tty7 is a fast, GPU-accelerated terminal workbench with persistent sessions, built-in input tools, SSH support, and coding agent awareness.

Developer ToolsCLI & Terminal
359
programmersd21
Featured
programmersd21 GitHub avatar

flow

flow is a minimalist terminal dashboard that displays real-time network throughput with smooth animations, multiple responsive modes, and zero configuration.

Developer ToolsCLI & Terminal
277
TanStack
Featured
TanStack GitHub avatar

router

TanStack Router is a type-safe, data-driven React router with built-in caching, prefetching, and nested layouts, while TanStack Start extends it into a full-stack SSR framework.

Web DevelopmentFrontend Frameworks
14,861