Repolode
zenbu-labs

zenbu-labs/terminal-browser

一款在终端内直接渲染网页的 Chromium 浏览器,基于 kitty 图形协议显示页面。

Star
4,468
Fork
221
未关闭 Issue
110
最近提交
前天

这是什么?

terminal-browser 是一个运行在终端窗口里的图形化网页浏览器。它通过 Electron 的离屏渲染调用 Chromium 绘制页面,再把像素发送到支持 kitty 图形协议的终端,例如 Ghostty、kitty 和 VS Code 内置终端。终端中的键盘和鼠标输入会转发给页面,普通网站无需离开 shell 即可浏览。

它也能嵌入终端工作流:可以在编码代理旁边的分屏中打开,代理也能通过兼容 agent-browser 的 CLI 操作已打开的浏览器标签页。`--ssh` 选项会把网络请求经由远程机器转发,便于在本地预览远程机器 localhost 上运行的页面。终端还可以实现一套小型 socket API,让浏览器打开、聚焦窗格,或向代理发送文本。

在 macOS 和 Linux 上可通过 curl 脚本或 Homebrew 安装,Windows 需要通过 WSL 使用。项目还包含用于构建终端图形应用的 JavaScript 库 pixel,以及一个 Claude Code 插件。

核心功能

  • 01在支持 kitty 图形协议的终端中渲染完整的 Chromium 网页。
  • 02将终端中的鼠标、触控板和键盘输入转发给页面。
  • 03支持分屏打开、多标签页、命令面板、页内查找和开发者工具。
  • 04通过 SSH 代理网络请求,可在本地查看远程机器 localhost 上的页面。
  • 05提供兼容 agent-browser 的命令行工具,用于脚本化操作已打开的浏览器。
  • 06内置 tmux、WezTerm、kitty 等多种终端和复用器的集成。

适用场景

  • 在同一个终端标签页中同时使用编码代理和它所操作的网页。
  • 通过 SSH 预览远程服务器上运行的网站,无需桌面浏览器。
  • 让 AI 代理通过命令行读取或操作网页。
  • 在代理旁边的分屏中查看代理生成的 HTML 方案。

快速上手

  1. 1

    使用 Homebrew 安装(macOS 和 Linux)

    brew install terminal-browser
  2. 2

    启动浏览器

    terminal-browser
  3. 3

    在指定网址打开

    terminal-browser open <url>

使用前须知

  • Windows 仅能通过 WSL 使用,且支持的终端很少。
  • 需要支持 kitty 图形协议的终端。
  • 默认会收集遥测数据和崩溃报告,如不需要须手动关闭。
  • 尚不支持 Chrome 扩展,设计模式仍在开发中。

收录于专题

标签

常见问题

terminal-browser 是什么?
一款在终端内直接渲染网页的 Chromium 浏览器,基于 kitty 图形协议显示页面。 terminal-browser 是一个运行在终端窗口里的图形化网页浏览器。它通过 Electron 的离屏渲染调用 Chromium 绘制页面,再把像素发送到支持 kitty 图形协议的终端,例如 Ghostty、kitty 和 VS Code 内置终端。终端中的键盘和鼠标输入会转发给页面,普通网站无需离开 shell 即可浏览。
terminal-browser 可以免费使用吗?用的什么许可证?
terminal-browser 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
terminal-browser 还在维护吗?
活跃维护中。terminal-browser 最近一次提交是在 2026年11月5日。
terminal-browser 适合用来做什么?
在同一个终端标签页中同时使用编码代理和它所操作的网页。 通过 SSH 预览远程服务器上运行的网站,无需桌面浏览器。 让 AI 代理通过命令行读取或操作网页。 在代理旁边的分屏中查看代理生成的 HTML 方案。
terminal-browser 怎么安装和运行?
使用 Homebrew 安装(macOS 和 Linux): brew install terminal-browser 启动浏览器: terminal-browser 在指定网址打开: terminal-browser open <url>
在哪里获取 terminal-browser?
源代码和安装说明在 GitHub 上:https://github.com/zenbu-labs/terminal-browser

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目