terminal-browser 是一个把真正的 Chromium 塞进终端里的浏览器。不是 w3m、lynx 那种把网页转成文字的"终端浏览器",而是网页原样渲染成像素显示在终端格子里,能点、能滚、能开 DevTools。它这两天冲上 TypeScript 趋势榜,我猜跟它顺手做了个 Claude Code 插件有关:在 Claude Code 里敲 /browser,旁边就能分出一个浏览器窗格。
它解决什么问题
现在不少人一天大半时间泡在终端里跟编码 agent 打交道,但一到"看一眼页面效果"就得切到外面的浏览器,来回切窗口很碎。terminal-browser 的思路是:网页就放在 agent 同一个终端标签页里,开个分屏,左边聊天改代码,右边刷新看结果。
另一个场景是远程开发。服务跑在远程机器的 localhost 上,平时要么配端口转发,要么开 SSH 隧道。它的 --ssh 模式直接把浏览器的所有网络请求通过 SSH 走远程机器,本地打开就能访问对方的 localhost。
核心功能
- 真浏览器:底层是 Electron 的离屏渲染,从 GPU 读 Chromium 画好的像素,再用 kitty 图形协议画进终端。键鼠事件从终端读取后转成合成事件喂给 Chromium,macOS 上还用一个后台 Swift 小程序补读触控板事件,所以平滑滚动、无限画布这类网页也能用
- 标签页、地址栏、命令面板、页内查找、DevTools,快捷键基本照搬普通浏览器(macOS 用 cmd,Linux 用 ctrl)
- 给 agent 用:
terminal-browser action是一套兼容 agent-browser 的命令行接口,agent 可以直接操作已经打开的浏览器。还有"选中元素发给 agent"(ctrl+g)和录制页面操作的功能 - 分屏打开:
--split right在当前终端右侧分出一个窗格 - 嵌入模式:可以嵌到别的 TUI 里,仓库里有示例。底层渲染能力也拆成了独立的 JS 库 pixel,想在终端里做图形界面的可以拿去用
怎么用
macOS / Linux 一行安装:
curl -fsSL https://terminal-browser.sh/install | bash # 或者 brew install terminal-browser
常用命令:
terminal-browser # 启动
terminal-browser open https://example.com # 打开指定网址
terminal-browser --split right # 在右侧分屏打开
terminal-browser open --ssh user@host http://localhost:3000 # 请求走远程机器
terminal-browser ls # 列出已打开的浏览器
terminal-browser upgrade # 升级
装 Claude Code 插件的话,先在 ~/.claude/settings.json 里打开实验性的函数钩子:
{
"env": { "CLAUDE_CODE_ENABLE_FUNCTION_HOOKS": "1" }
}
然后:
claude plugin marketplace add zenbu-labs/terminal-browser
claude plugin install terminal-browser@terminal-browser
之后在 Claude Code 里输入 /browser 就能开。插件还暴露了一个 browser.open 接口,别的插件可以借它做 /tldraw、/open-pr 这种一键在侧边打开某个页面的命令。
值得注意的地方
门槛主要在终端上。必须用支持 kitty 图形协议的终端,比如 Ghostty、kitty、cmux、VS Code 终端,以及基于 libghostty 的终端。系统方面目前只支持 macOS 和 Linux,Windows 用户暂时用不上。
Claude Code 插件这块作者自己也标了"实验性",限制写得挺坦白:
- 除了图形协议,还要求终端支持 kitty 的 unicode placeholder,基本就是 Ghostty 和 kitty
- 套了 tmux 之类的多路复用器,插件目前用不了(独立运行的 terminal-browser 在 tmux 里可以)
- 在 Claude Code 里帧率超过 50 左右界面可能花屏,鼠标位置偶尔有偏差
- 依赖 Claude Code 还不稳定的函数钩子 API,升级后可能会坏
所以我的看法是:如果你本来就是 Ghostty / kitty 用户,每天在终端里跑 agent,它很值得装上试试,"agent 改完我在旁边直接看"的体验是别的方案给不了的。远程开发看 localhost 的 --ssh 模式也挺实用。要是你在 Windows 上或者用的终端不支持图形协议,就先收藏观望。
同类里比较早的尝试是 awrit,作者在致谢里也提到了。terminal-browser 在输入处理、UI 和 agent 集成上走得更远。
项目信息
- 语言:TypeScript(外层 UI 引擎用 Rust)
- License:MIT
- Star:截至 2026-09-27 约 3470
- 最新版本:v0.11.1(2026-09-17)
- GitHub:GitHub - zenbu-labs/terminal-browser: A browser inside your terminal · GitHub
- 官网:https://terminal-browser.com
