terminal-browser
### Architecture & Positioning terminal-browser, developed by Zenbu Labs, bridges the gap between text-based terminal interfaces and graphical web browsers. Utilizing the Kitty Graphics Protocol, it renders a full-fledged, real Chromium browser directly inside modern GPU-accelerated terminal emulators. As terminal-first AI coding agents (such as Claude Code and Aider) become mainstream, context switching between CLI terminals and desktop GUI browsers introduces friction; terminal-browser solves this by rasterizing Chromium frames and streaming them via CDP into terminal pane layouts alongside the active coding assistant. ### Core Capabilities & Differentiation Unlike traditional terminal browsers like Lynx or w3m that only parse raw text, terminal-browser runs a full Chromium engine supporting complex JavaScript, CSS3, dynamic DOM rendering, and interactive developer tools. Its key differentiator is two-fold: first, native support for tabs, split-pane previews, and remote SSH forwarding; second, a built-in agent-browser-compatible Action CLI that allows AI agents to inspect open tabs, issue click and typing events, scroll viewports, and capture screenshots directly through standard terminal commands. ### Deployment & Best Practices To run terminal-browser smoothly, ensure you use a terminal that fully supports the Kitty graphics protocol (such as Kitty, Ghostty, or configured WezTerm). For remote development over SSH, ensure high-bandwidth network connectivity and proper socket forwarding to avoid visual lag. When integrating with automated coding agents, configure the Action CLI as an executable tool with built-in DOM-ready wait states, guaranteeing that heavy React/Vue SPA hydration finishes before agent click dispatches.
Features
Why choose it
Trade-offs
Maintenance check
- Last commit
- 2026-11-13
- Commits, last 90 days
- 100+
- Releases, last 90 days
- 30
- Latest release
- pixel-v0.2.21 (2026-11-13)
- Open issues
- 135
- Recent issues with at least one comment
- 2/24
Oldest week on the left; the latest four weeks are orange. Source: GitHub commit activity.
Status rule: archived on GitHub = Archived; last commit within 90 days = Active; 91 to 365 days = Slowing; older = Stale. All figures come from the GitHub API on the date shown.
Most discussed open issues
- #89 Herdr - Terminal-Browser not rendering8 comments · 2026-08-30
- #207 terminal-browser 中文乱码5 comments · 2026-10-26
- #97 herdr graphics client is dark on herdr 0.8.2, and inline set cannot replace the file transport4 comments · 2026-09-05
- #16 Pages appear zoomed ~2x when Ghostty is on a secondary 1x display (hostDisplayScale uses primary only)4 comments · 2026-08-04
- #126 agent-browser daemons survive shutdown and are never reaped3 comments · 2026-09-27
Issue titles are quoted from GitHub. Open the link to check whether a problem still applies to the version you use.
Compatibility
Quick start
Use cases
Alternatives
Comments
No comments yet. Be the first!