VibeAround v0.7.10
VibeAround v0.7.10
This is a major architectural release for VibeAround. The biggest change is that VibeAround is no longer shaped only as a desktop app: the local server, launch layer, desktop UI, Web Hub, CLI, and TUI are now being separated into clearer pieces that can run and evolve independently.
这是 VibeAround 的一次重要架构升级。最大的变化是:VibeAround 不再只是一个桌面应用,而是开始拆分为更清晰的几个层次:本地 server、launch 层、Desktop UI、Web Hub、CLI 和 TUI。它们可以独立运行,也可以继续组合成完整的桌面体验。
This lays the groundwork for the next roadmap item: containerized VibeAround server deployments.
这也为下一阶段 roadmap 做准备:让 VibeAround server 支持容器化部署。
Important: Breaking Change / 重要:破坏性变更
This release changes how VibeAround reads and normalizes local configuration. Some configuration fields have been merged, and some non-essential runtime/log data is no longer useful. For now, the recommended migration is a manual cleanup:
本版本修改了 VibeAround 本地配置的读取和归一化逻辑。部分配置项被合并,部分非必要的运行日志/缓存内容也不再有用。目前建议按下面流程手动清理:
- Back up
~/.vibearound/profilesand~/.vibearound/settings.json. - Delete the
~/.vibearounddirectory. - Copy the backed-up
profilesdirectory andsettings.jsonback into~/.vibearound. - Open VibeAround Desktop.
- Go to Settings and run the onboarding flow again.
中文迁移步骤:
- 备份
~/.vibearound/profiles和~/.vibearound/settings.json。 - 删除整个
~/.vibearound目录。 - 将备份的
profiles目录和settings.json拷贝回~/.vibearound。 - 打开 VibeAround Desktop。
- 进入 Settings,重新走一遍 onboarding 流程。
Known impact: API Bridge configuration may be lost during this migration. Re-enable API Bridge on the affected profiles to restore it.
已知影响:迁移后 API Bridge 配置可能会丢失。重新在对应 profile 上启用 API Bridge 即可恢复。
Major Changes / 主要变化
Standalone VibeAround Server / 独立 VibeAround Server
English:
- Split the VibeAround server runtime into a standalone
vibearound-serverbinary. - The server can now run without the Desktop UI, while still serving the local Web Hub, WebSocket APIs, auth, pairing, local API bridge, MCP endpoints, previews, sessions, and runtime state.
- Desktop now embeds and controls the same server runtime instead of being the only way to run it.
- Added
va serveso the CLI can start the standalone server directly. - This makes Desktop one client of the VibeAround runtime, not the runtime boundary itself.
中文:
- 将 VibeAround server runtime 拆成了独立的
vibearound-serverbinary。 - Server 现在可以脱离 Desktop UI 独立运行,同时继续提供本地 Web Hub、WebSocket API、auth、pairing、local API bridge、MCP endpoints、previews、sessions 和 runtime state。
- Desktop 现在是嵌入和控制同一套 server runtime,而不再是唯一的运行边界。
- 新增
va serve,CLI 可以直接启动独立 server。 - 这意味着 Desktop 变成 VibeAround runtime 的一个 client,而不是 runtime 本身。
Standalone Launch Layer / 独立 Launch 层
English:
- Split agent launching into the standalone
va-launchbinary. va-launchowns the native launch boundary: resolving agent executables, validating workspaces, applying launch templates, preparing project integrations, and starting the selected agent.- Launch profiles are now explicit inputs, which makes launches easier to reproduce from Desktop, CLI, scripts, and future automation.
- The CLI can now launch different agent + profile + workspace combinations without going through the Desktop UI.
- This is the foundation for running multiple profiles and agents in parallel from command-line workflows.
中文:
- 将 agent launch 拆成独立的
va-launchbinary。 va-launch负责 native launch 边界:解析 agent executable、校验 workspace、应用 launch template、准备 project integration,并启动选定的 agent。- Launch profile 现在成为显式输入,因此 Desktop、CLI、脚本和未来自动化流程都可以复现同一次 launch。
- CLI 现在可以不经过 Desktop UI,直接启动不同的 agent + profile + workspace 组合。
- 这是后续从命令行并行运行多个 profile 和多个 agent 的基础。
Early Terminal Hub / 早期 Terminal Hub
English:
- Added the first version of
va-tui, a terminal-first alternative to the Web Hub. - The TUI can connect to local VibeAround sessions, show runtime/session state, switch agent context, and provide chat-style interaction from the terminal.
- This is still an early version, but it establishes the direction: VibeAround should be usable from Desktop, Web Hub, IM channels, browser, CLI, and terminal UI.
中文:
- 新增
va-tui的早期版本,作为 Web Hub 的 terminal-first 替代体验。 - TUI 可以连接本地 VibeAround sessions,展示 runtime/session 状态,切换 agent context,并在终端里提供 chat-style 交互。
- 这仍然是早期版本,但明确了方向:VibeAround 应该能从 Desktop、Web Hub、IM channel、browser、CLI 和 terminal UI 多种入口使用。
CLI And Service Control / CLI 与服务控制
English:
- Added the Rust
vaCLI as a control surface for VibeAround. - Added commands for health checks, diagnostics, auth, pairing, service management, launch sessions, workspaces, profiles, previews, runtime state, and chat workflows.
- Added auth fallback through token flags, environment variables, auth files, and the local
auth.json. - Added single-shot chat, stdin prompts, REPL-style chat, and session continuation.
- Added PTY/session creation and attach support for local agent workflows.
中文:
- 新增 Rust 版
vaCLI,作为 VibeAround 的命令行控制入口。 - 新增 health check、diagnostics、auth、pairing、service management、launch sessions、workspaces、profiles、previews、runtime state 和 chat workflows 等命令。
- 支持通过 token flag、环境变量、auth file 和本地
auth.json读取认证信息。 - 新增 single-shot chat、stdin prompt、REPL-style chat 和 session continuation。
- 新增 PTY/session create 和 attach,支持本地 agent 工作流。
Desktop And Web Hub / Desktop 与 Web Hub
English:
- Added Auth Token display in Desktop Settings > General, with a copy button.
- Updated browser pairing fallback copy to guide users to retrieve a token from VibeAround Desktop.
- Fixed workspace chat thread binding.
- Fixed Web Hub route/session reuse.
- Fixed packaged Web Hub static asset paths.
- Improved chat session display, runtime keys, sidebar behavior, host logo handling, and local session storage.
中文:
- 在 Desktop Settings > General 中新增 Auth Token 展示和复制按钮。
- 更新 browser pairing fallback 文案,引导用户从 VibeAround Desktop 获取 token。
- 修复 workspace chat thread binding。
- 修复 Web Hub route/session reuse。
- 修复 packaged Web Hub static asset paths。
- 改进 chat session display、runtime keys、sidebar behavior、host logo handling 和 local session storage。
Local API, Bridge, And Runtime / Local API、Bridge 与 Runtime
English:
- Consolidated API Bridge translation through the shared
va_ai_api_bridgeprotocol layer. - Kept support for OpenAI Responses, OpenAI Chat Completions, Anthropic Messages, and Gemini Generate Content routes.
- Improved streamable MCP session handling.
- Improved local-agent API bridge routing and completion event translation.
- Rejected direct-only agents before channel runtime launch.
- Stopped persisting API bridge launch records where they no longer belong.
中文:
- 将 API Bridge translation 统一到共享的
va_ai_api_bridgeprotocol layer。 - 继续支持 OpenAI Responses、OpenAI Chat Completions、Anthropic Messages 和 Gemini Generate Content routes。
- 改进 streamable MCP session handling。
- 改进 local-agent API bridge routing 和 completion event translation。
- 在 channel runtime launch 前拒绝 direct-only agents。
- 停止持久化不再需要的 API bridge launch records。
Packaging / 打包发布
English:
- Desktop bundles now include the
va-launchsidecar. - Windows portable packaging now includes
VibeAround.exe,va-launch.exe,va.exe,va-tui.exe, and the Web Hub assets. - Linux AppImage and deb packages are built by GitHub Actions.
- macOS Apple Silicon DMG is signed and notarized locally.
- Release versions are synchronized across desktop, server, core, launcher, CLI, TUI, Rust client, Web Hub, and shared packages.
中文:
- Desktop bundle 现在包含
va-launchsidecar。 - Windows portable 包现在包含
VibeAround.exe、va-launch.exe、va.exe、va-tui.exe和 Web Hub assets。 - Linux AppImage 和 deb 由 GitHub Actions 构建。
- macOS Apple Silicon DMG 由本地签名并完成 notarization。
- release version 已在 desktop、server、core、launcher、CLI、TUI、Rust client、Web Hub 和 shared packages 中同步。
Fixes / 修复
English:
- Fixed Windows launch flow through
va-launch, reducing launcher edge cases when starting or switching agents. - Fixed TUI websocket routing, session replay, scroll behavior, and resume context.
- Fixed TUI session resume handling to align with IM flow.
- Fixed desktop launch button disabled layout.
- Fixed Web Hub route/session reuse.
- Fixed workspace chat thread binding.
- Fixed packaged dashboard asset paths.
中文:
- 修复 Windows 通过
va-launch启动的流程,减少启动或切换 agent 时的 launcher edge case。 - 修复 TUI websocket routing、session replay、scroll behavior 和 resume context。
- 修复 TUI session resume handling,使其与 IM flow 对齐。
- 修复 desktop launch button disabled layout。
- 修复 Web Hub route/session reuse。
- 修复 workspace chat thread binding。
- 修复 packaged dashboard asset paths。
Roadmap / 路线图
English:
- Next major direction: containerized VibeAround server runtime.
- Continue evolving
va-launchinto the common launch boundary for Desktop, CLI, and automation. - Continue evolving
va-tuiinto a terminal-native alternative to the Web Hub.
中文:
- 下一个主要方向:VibeAround server runtime 容器化。
- 继续将
va-launch演进为 Desktop、CLI 和 automation 的统一 launch boundary。 - 继续将
va-tui演进为 Web Hub 的 terminal-native 替代体验。
Known Limitations / 已知限制
English:
- macOS release packaging is currently Apple Silicon only.
va-tuiis an early version and will continue to evolve quickly.
中文:
- macOS release 目前仅提供 Apple Silicon 包。
va-tui仍是早期版本,后续会快速迭代。