amantus-ai/vibetunnel

这是什么？

核心功能

• 01在任意现代浏览器中查看终端会话，并提供所有会话的仪表盘。
• 02通过 `vt` 命令包装执行命令，支持 shell 别名和函数。
• 03提供 macOS 原生菜单栏应用，以及面向 Linux 和无界面主机的 npm 包。
• 04支持系统账户、SSH 密钥、环境变量凭据等多种认证方式。
• 05可通过 Tailscale、ngrok、Cloudflare、Pinggy 或 Pangolin 进行远程访问。
• 06会话以 asciinema 格式录制，便于之后回放。

适用场景

• 离开工位时用手机查看长时间运行的构建或测试。
• 在开发机上监控 Claude Code 等 AI 编程代理的运行情况。
• 无需配置 SSH，即可与同事共享实时终端会话。
• 在无界面的 Linux 服务器或 Docker 容器中运行终端仪表盘。

快速上手

1. 1

   全局安装 npm 包

   npm install -g vibetunnel
2. 2

   或通过 Homebrew 安装 macOS 应用

   brew install --cask vibetunnel
3. 3

   在浏览器中运行任意命令

   vt pnpm run dev
4. 4

   打开 localhost 4020 端口的仪表盘

使用前须知

• !原生 macOS 应用需要 Apple Silicon Mac（M1 或更新机型），不支持 Intel Mac。
• !暂不支持 Windows。
• !iOS 应用仍在开发中，不建议用于生产环境。

标签

常见问题

vibetunnel 是什么？

把浏览器变成终端，可在任意设备上查看和操控命令行会话与 AI 编程代理。 VibeTunnel 将宿主机上的终端会话转发到网页仪表盘，可以在手机、平板或其他电脑上查看长时间运行的构建、测试或 AI 编程代理的输出。默认在本机 4020 端口运行服务，`vt` 命令可包装任意 shell 命令，使其输出显示在浏览器中，并支持 shell 别名和交互式 shell。

vibetunnel 可以免费使用吗？用的什么许可证？

vibetunnel 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

vibetunnel 还在维护吗？

半年内有更新。vibetunnel 最近一次提交是在 2026年8月5日。

vibetunnel 适合用来做什么？

离开工位时用手机查看长时间运行的构建或测试。 在开发机上监控 Claude Code 等 AI 编程代理的运行情况。 无需配置 SSH，即可与同事共享实时终端会话。 在无界面的 Linux 服务器或 Docker 容器中运行终端仪表盘。

vibetunnel 怎么安装和运行？

全局安装 npm 包: npm install -g vibetunnel 或通过 Homebrew 安装 macOS 应用: brew install --cask vibetunnel 在浏览器中运行任意命令: vt pnpm run dev 打开 localhost 4020 端口的仪表盘

在哪里获取 vibetunnel？

源代码和安装说明在 GitHub 上：https://github.com/amantus-ai/vibetunnel