Repolode
Submit
zenbu-labs

zenbu-labs/terminal-browser

A Chromium-based web browser that renders pages directly inside a terminal using the kitty graphics protocol.

View on GitHubWebsite
Stars
4,468
Forks
221
Open issues
110
Last commit
2 days ago

What is it?

terminal-browser is a graphical web browser that runs inside a terminal window. It uses Chromium through Electron's offscreen rendering to draw pages, then sends the pixels to terminals that support the kitty graphics protocol, such as Ghostty, kitty, and VS Code's terminal. Keyboard and mouse input from the terminal are forwarded to the page, so ordinary websites can be browsed without leaving the shell.

The browser fits into terminal workflows. It can open in a split pane next to a coding agent, and an agent can drive open browser tabs through an agent-browser compatible CLI. The `--ssh` option proxies network requests through a remote machine, so pages served on that machine's localhost can be previewed locally. Terminals can also expose a small socket API so the browser can open and focus panes or send text to an agent.

Installation is available through a curl script or Homebrew on macOS and Linux, and on Windows through WSL. The project also includes `pixel`, a JavaScript library for building graphical terminal applications, and a Claude Code plugin.

Key features

  • 01Renders full Chromium web pages in terminals that support the kitty graphics protocol.
  • 02Forwards mouse, trackpad, and keyboard input from the terminal to the page.
  • 03Opens in split panes and supports tabs, a command palette, find-in-page, and devtools.
  • 04Proxies network requests over SSH so remote localhost pages can be viewed locally.
  • 05Provides an agent-browser compatible CLI for scripting open browsers.
  • 06Ships built-in integrations for several terminals and multiplexers, including tmux and WezTerm.

Use cases

  • Keeping a coding agent and the web pages it works with in the same terminal tab.
  • Previewing a website running on a remote server over SSH without a desktop browser.
  • Letting an AI agent read or interact with web pages through the CLI.
  • Viewing HTML plans generated by an agent in a split pane beside the agent.

Quick start

  1. 1

    Install with Homebrew (macOS & Linux)

    brew install terminal-browser
  2. 2

    Launch the browser

    terminal-browser
  3. 3

    Open a specific URL

    terminal-browser open <url>

Things to know

  • Windows is supported only through WSL, and few terminals support the required graphics protocol there.
  • Requires a terminal that supports the kitty graphics protocol.
  • Telemetry and crash reports are collected by default and must be disabled manually if unwanted.
  • Chrome extensions are not yet supported and design mode is still in progress.

In collections

Claude Code tools, skills & pluginsOpen-source AI agent frameworks & appsCLI & terminal tools

Topics

#browser#terminal#cli#chromium#electron#ssh#ai-agent#kitty-graphics#claude-code#claude-code-plugin

FAQ

What is terminal-browser?
A Chromium-based web browser that renders pages directly inside a terminal using the kitty graphics protocol. terminal-browser is a graphical web browser that runs inside a terminal window. It uses Chromium through Electron's offscreen rendering to draw pages, then sends the pixels to terminals that support the kitty graphics protocol, such as Ghostty, kitty, and VS Code's terminal. Keyboard and mouse input from the terminal are forwarded to the page, so ordinary websites can be browsed without leaving the shell.
Is terminal-browser free to use? What license does it have?
terminal-browser is open source under the MIT license. Check the license terms before using it in commercial products.
Is terminal-browser still maintained?
Actively maintained. The last commit to terminal-browser was on Nov 5, 2026.
What can I use terminal-browser for?
Keeping a coding agent and the web pages it works with in the same terminal tab. Previewing a website running on a remote server over SSH without a desktop browser. Letting an AI agent read or interact with web pages through the CLI. Viewing HTML plans generated by an agent in a split pane beside the agent.
How do I install terminal-browser?
Install with Homebrew (macOS & Linux): brew install terminal-browser Launch the browser: terminal-browser Open a specific URL: terminal-browser open <url>
Where can I get terminal-browser?
The source code and installation instructions are on GitHub: https://github.com/zenbu-labs/terminal-browser

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects