UStackUStack
VibeAround icon

VibeAround

VibeAround 连接受支持的本地 AI 编程代理:通过 IM 聊天与浏览器 Web 终端随时协作,支持双向会话交接和实时预览。

VibeAround

VibeAround 是什么?

VibeAround 是一个本地代理编程界面,让您随时随地访问受支持的 AI 编程代理。它提供两大交互界面——通过热门 IM 平台的聊天和浏览器 Web 终端——均基于同一本地工作区,无论您使用手机、咖啡厅笔记本还是桌面终端,都能继续工作。

该项目还包含一个轻量级桌面应用(基于 Tauri 构建),用于配置和服务管理。代理和 IM 频道以插件形式实现,可按需启用,而底层连接和会话行为通过一致协议和内置隧道处理。

主要功能

  • 从任意 IM 与本地 AI 代理聊天:在 Telegram、Slack、飞书/Lark 或 Discord 中私信您的代理,通过聊天界面编写代码和运行命令。
  • 支持 tmux 的 Web 终端:在浏览器中使用完整 shell;手机端提供屏幕命令面板,支持一键访问 ESC 和 Ctrl/箭头键等。与 tmux 搭配使用,会话可在关闭浏览器后保持活跃。
  • 双向会话交接:使用 /handover/pickup 在终端和 IM 间转移实时编程会话,保留完整上下文。
  • 对话中切换代理:更改驱动会话的受支持代理(例如 /switch claude/switch codex/switch cursor),无需重启 VibeAround。
  • 通过短效链接实时预览:分享开发服务器的渲染 Markdown/HTML,并从手机或任意浏览器打开链接。
  • 隧道和凭证的一键设置向导:设置向导安装代理依赖、填写频道凭证并选择隧道提供商,减少手动配置。

如何使用 VibeAround

  1. 构建并运行项目(本地开发):cd src,然后 bun installbun run prebuildbun run dev
  2. 启动桌面应用:首次启动时会打开设置向导。
  3. 选择代理和频道:启用您想使用的代理,并按向导提示配置 IM 频道凭证。
  4. 设置隧道:向导选择隧道后端,以便 Web 终端和实时预览通过令牌门控的公共 URL 访问。
  5. 开始工作:打开 IM 客户端私信代理进行聊天式编程,或在浏览器中使用 Web 终端。需要时,使用 /handover/pickup 在界面间交接实时会话。

仓库中列出的先决条件为 Rust 1.82+Node.js 20+Bun 1.1+;macOS 上还需运行 xcode-select --install

使用场景

  • 旅行中通过 IM 编程:从 Telegram/Slack/飞书/Discord 发送命令,直接在聊天中接收编程输出,继续开发。
  • 在借用笔记本上使用终端:在咖啡厅机器上打开浏览器 Web 终端;使用 tmux 让会话在关闭浏览器后持续存在。
  • 在手机和终端间切换:在 Web 终端启动会话,然后使用交接命令从 IM 继续(反之亦然),保持相同上下文。
  • 为不同任务使用不同代理:在 Telegram 中运行一个代理,同时在 Slack 中使用另一个,或使用提供的 /switch ... 命令在对话中切换代理。
  • 分享快速预览验证 UI/内容:通过短效链接发布渲染 Markdown/HTML 或开发服务器输出,并在手机上查看。

常见问题

  • VibeAround 支持哪些 AI 编程代理?

    仓库列出支持 Claude Code、Gemini CLI、Codex CLI、Cursor CLI、Kiro CLI 和 Qwen Code,通过 stdio 使用 ACP(Agent Client Protocol)进行通信。

  • VibeAround 如何连接 IM 平台?

    每个 IM 频道作为独立 Node.js 插件按需加载。频道认证细节因平台而异(例如机器人令牌、应用凭证或二维码登录),设置向导会帮助填写。

  • “会话交接”在实际中是什么意思?

    它允许您使用命令(/handover/pickup)在 Web 终端和 IM 间转移实时编程会话,同时保留完整上下文。

  • Web 终端和实时预览 URL 需要访问控制吗?

    是的。仓库说明暴露的 URL 采用令牌门控:它们可公开访问,但只有您能打开。

  • 会话持久化需要 tmux 吗?

    文档表示 Web 终端可与 tmux 搭配使用,从而在关闭浏览器后保持会话活跃。

替代方案

  • 直接使用 CLI 代理的本地终端工作流:您可以在自己的终端中使用代理 CLI,但无法获得 IM 集成、Web 终端界面或聊天与终端之间的内置会话交接。
  • 基于 Web 的 AI 编程助手:浏览器助手可从任何地方提供一致界面,但无法匹配 VibeAround 连接本地代理进程并在聊天与终端间保持相同工作区的专注。
  • 通过平台机器人进行的聊天编程(无会话交接/Web 终端):IM 机器人方法可将代理输出带入聊天,但可能无法提供 VibeAround 描述的双向交接和 Web 终端体验。
  • 通用隧道 + 您自己的 Web 终端:使用隧道和浏览器终端设置可近似远程访问,但您需要自行组装和维护代理/会话管理,而不是使用 VibeAround 的插件架构和交接命令。
VibeAround | UStack