基于 Electron 的本地优先浏览器,AI 代理可通过 MCP 或 HTTP API 在你已登录的真实会话中操作网页。
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
使用 Homebrew 安装(macOS 和 Linux)
brew install terminal-browser - 2
启动浏览器
terminal-browser - 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 数据每日更新。
相关项目
627+3 本周90TypeScriptMIT维护活跃更新于 5天前
一款桌面应用,将 ChatGPT、Claude、Gemini 等多个 AI 聊天服务放入相互隔离的独立窗口中统一管理。
9076+7 本周717TypeScript无许可证更新于 3个月前
一条命令检测已发布应用的构建产物有多容易被 AI 逆向工具读取,并自动修复可安全处理的问题。
10+2 本周2JavaScriptMIT维护活跃更新于 19天前
基于 Chromium 构建、注重隐私的网页浏览器,支持 macOS、Linux 和 Windows。
2.2万+227 本周685C++GPL-3.0维护活跃更新于 19小时前