terminal-browser CLI
A real browser inside the terminal with a CLI for the agent: a coding agent opens sites and interacts with them in the same tab
- 4,609 ★ on the repository
- Last commit
- MIT
Broad access
Why this level
- The agent interacts with open browsers and web pages
- It can perform actions on sites in open sessions
Install
- Works in
Manual install
curl -fsSL https://terminal-browser.sh/install | bashmacOS and Linux. Upgrade with terminal-browser upgrade. Also available as brew install terminal-browser.
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- The agent interacts with open browsers and web pages
- It can perform actions on sites in open sessions
This is third-party code. Review the repository files before installing.
What it does
terminal-browser is a real chromium-based browser that draws pages right in the terminal through the kitty graphics protocol. Its CLI gives a coding agent web access: the terminal-browser action command is agent-browser compatible and lets the agent interact with open browsers, while ordinary commands open URLs, show the browser in a split pane and list open windows. It works over SSH: the site loads on your device while network requests are proxied through the remote machine, which is handy for viewing sites on the server's localhost. It ships a Claude Code plugin, TUI embedding and element selection on a page to send to the agent.
Who it is for. For developers who work with a coding agent in the terminal and want to give it web access in the same tab.
Good fit when
- You want the agent to open sites and interact with them from the terminal
- You want the site and the agent in one terminal tab
- You want to preview sites from a remote machine over SSH
Not a fit when
- Your terminal does not support the kitty graphics protocol
- You cannot let the agent interact with open browsers
Example request
Open my local site in terminal-browser and check whether the login form worksLimitations
Rendering needs a terminal that supports the kitty graphics protocol, such as ghostty, kitty or vscode. The terminal-browser action CLI lets the agent interact with open browsers, so grant access deliberately. On some systems a background system app is used to read input. Linux is supported, and some features are still planned.
How to disable. Uninstall terminal-browser installed via brew or the script and remove its Claude Code plugin via /plugin.
FAQ
How does the agent get web access?
Through terminal-browser action, an agent-browser compatible CLI for interacting with open browsers.
Does it work over SSH?
Yes. terminal-browser open --ssh loads the site on your device and proxies requests through the remote machine, including sites on its localhost.
Discussion
No questions or reviews yet.
Related
CLI toolsA CLI and MCP server that lets an agent drive your real Chrome with its logged-in sessions: 103 commands across 36 platforms plus browser automation
A separate browser for agents with a skill and MCP: Claude Code and Codex work in your logged-in accounts, and every session is recorded for replay
A Claude Code plugin with an MCP server and seven skills: the agent drives a real browser by writing Python code
A Chromium browser built for agents with visible control: an MCP server, named sessions, checkpoints and approval prompts
An agent drives your real logged-in Chrome: a CLI, MCP and an extension with a separate tab group per session
CLI, skill and Python library for browser control: the agent clicks, fills forms and reads pages over CDP
README in short
The README describes terminal-browser as a real chromium browser that draws pages in the terminal through the kitty graphics protocol using Electron offscreen rendering. The CLI opens URLs, shows the browser in a split pane, lists windows and, via terminal-browser action, gives the agent web access. Install via a curl script or Homebrew, with a Claude Code plugin. It supports SSH with request proxying, TUI embedding and element selection to send to the agent. The outer UI is built on a Rust engine with a React renderer. MIT licensed.