zenbu-labs/terminal-browser

terminal-browser

A real browser that runs inside your terminal

<video src="https://github.com/user-attachments/assets/abe2f43e-fc50-4866-b753-33388967945d" controls></video>

Installation

curl (macOS & Linux):

curl -fsSL https://terminal-browser.sh/install | bash

Note: Run terminal-browser upgrade to upgrade versions

Homebrew (macOS & Linux):

brew install terminal-browser

Windows

To install on Windows you must be using WSL. Terminals with kitty graphics support are also very limited on Windows, the following are terminals I have tested that terminal-browser will work on inside Windows:

• https://noctty.com/

curl -fsSL https://terminal-browser.sh/install | bash

Claude code plugin

Install instructions here

Usage

terminal-browser # launches the browser
terminal-browser open <url> # opens the browser at a url
terminal-browser --split right # opens the browser in a split pane to the right
terminal-browser open --ssh <user@host> <url> # performs all network requests through a remote server
terminal-browser open --transparent <url> # the terminal background will show through pages without a background color
terminal-browser ls # lists open browsers
terminal-browser action # an agent-browser compatible cli for interacting with open terminal-browsers
terminal-browser upgrade # upgrade to the latest version

Use cases:

• You can have a coding agent and website scoped to the same terminal tab
• Your agent has full access to interact with open terminal-browsers, which gives your agent the capability to use the web
• You can ask an agent to make HTML plans and then open them inside terminal-browser, which will automatically open in a split pane next to your agent
• terminal-browser works over SSH, which allows you to preview websites running on remote machines easily

Shortcuts

| Action | macOS | Linux | | --- | --- | --- | | Quit | ctrl+q or ctrl+c | c