Skip to content
项目

vibex-ai/vibex has 245 GitHub stars and 31 forks. GitHot measured +4 stars in 24 hours and +175 in 7 days. Last checked 2026-11-15 13:59 UTC. Last push 2026-11-15.

这些数字如何统计

可以做什么

  • Every Agent, one workbench Run Claude Code, Codex, ZCode, OpenCode, and any ACP-compatible Agent side by side. Vibex installs, updates, authenticates, and scopes each runtime, then keeps every session in the same timeline. Docs →

实测星标增长

24小时
+4
7天
+175
15天
更新延迟
1个月
更新延迟

各周期内的星标净变化,周期相互重叠,并非每日新增。缺失的测量保持空白。星标代表关注度,不代表软件质量。

关于

Your agents. Your workspace. Your control—from prompt to commit, desktop to mobile. Works with Codex, Claude Code, OpenCode, Pi, Grok, DeepSeek Harness, Antigravity, and many more through ACP.

开发工具

README.zh-CN.md

原文

Vibex

GitHub stars 许可证: AGPL-3.0 或更高版本 Rust 1.97.0 GPUI 支持平台: macOS、Windows、Linux、iOS 和 Android 发布状态: 0.1.0-rc.9

English  |  简体中文

你的 Agent,你的工作区,你来掌控——从提示词到提交,从桌面到终端再到手机。
面向 Agent 驱动软件开发的原生、本地优先 AI 编程工作台,建立在 Agent Client Protocol 之上。

网站  •  文档  •  快速开始  •  功能  •  支持的 Agent  •  产品形态  •  开发

Vibex 桌面工作台:Agent 会话、文件、Git 与终端

Vibex 将 Agent 会话、源代码、Git、终端、内嵌浏览器、电脑操作和供应商配置整合到一个专注的工作台中。桌面运行时统一管理 Agent 进程、会话历史、工作区文件、Git、PTY、供应商和权限。原生移动端和终端客户端可以远程监控并操控相同的会话,可选的自托管 Relay 只承载加密帧。

运行 Vibex 无需任何由 Vibex 托管的工作区。你的代码仓库、凭据和持久化会话状态都会保留在你选择的设备上。

功能

所有 Agent,一个工作台

并排运行 Claude Code、Codex、ZCode、OpenCode,以及任何兼容 ACP 的 Agent。Vibex 负责安装、升级、登录和按 Agent 隔离运行时,再把所有会话收进同一条时间线。

文档 →

Agent 团队与目标

把任务委派给子 Agent,并让任务跨回合保持打开。在同一个子会话里追加跟进,接受或取消结果;所有权树会显示工作推进到了哪里,目标则让长回合始终对准最终结果。

文档 →

并行 Worktree 与 Git 审查

让每个实验都有自己的隔离 Git worktree。查看差异、暂存与提交、合并或 rebase、逐文件解决冲突,最后丢弃落选分支,而不碰你的主检出。

文档 →

共享供应商与本地网关

模型供应商只需配置一次,就能供多个 Agent 使用。路由组在供应商或模型之间故障转移,在 OpenAI Chat、OpenAI Responses、Anthropic Messages 与 Gemini 之间转换协议,并记录只含 token 的请求台账——全部收在一个回环端点后面。

文档 →

终端、浏览器与电脑操作

使用带标签、分屏、搜索和回滚缓冲的原生 PTY。让 Agent 驱动一个隔离的内嵌浏览器,或者在你批准之后操作真实桌面——你可以从专用面板观看、批准并随时停止。

文档 →

手机,同一个会话

把 iOS 或 Android 客户端与桌面运行时配对。查看同一条时间线、处理审批与提问、发送后续消息、浏览文件和差异,并使用终端——无需启动第二个后端。

文档 →

Vibex TUI

把整个工作台装进终端:会话、流式 Markdown、审批、队列、设置与配对。它随每个桌面安装包一起发布,支持 SSH 和 tmux,也能附着到本机正在运行的桌面运行时。

文档 →

远程运行时,由你决定

通过 SSH 或 WSL2 在另一台机器上运行权威运行时,或把 vibex-server 自托管在 HTTPS、Tailnet 或自己的 Relay 后面。桌面端、手机和 TUI 始终是客户端;运行时始终是唯一真相。

文档 →

跟得上的会话

把后续消息排进队列、引导正在运行的回合、把发送安排到稍后,或让自动继续把回合推进到完成。搜索所有对话、导入本地 Agent 历史,并带着完整时间线恢复已归档会话。

文档 →

市场、上下文与预览

从应用内市场安装 MCP 服务器和 Skill,编写可复用 Prompt,并按 Agent 限定每项资源。在工作台里阅读 Markdown、PDF、Office 文档和图片,支持分栏、全屏预览,以及属于你的工作台背景。

文档 →

另外还内置了:


支持的 Agent

Vibex 使用 Agent Client Protocol(ACP)作为在线 Agent 传输协议。Agent 的身份和能力与连接它所使用的协议彼此分离。兼容 任何 ACP Agent——只要说 ACP,就能在 Vibex 中运行。

内置预设包括 Claude Code、Codex、ZCode 和 OpenCode。ACP 目录还包含 Antigravity、Cline、Codebuddy、Cursor、Gemini CLI、GitHub Copilot、Devin、Grok Build、Hermes、Kimi Code、Pi、DeepSeek Harness 等集成。Vibex 会根据本机已安装的运行时、供应商配置和实时能力探测结果判断可用性。

你也可以注册任意兼容 ACP 的可执行程序,配置其命令、参数、环境变量和显示元数据。新增 Agent 无需修改 UI,也无需再实现一套厂商专用的会话协议。


产品形态

产品形态 作用 入口
桌面端 完整的原生 GPUI 工作台,也是 Agent、工作区、文件、Git、PTY、浏览器、电脑操作、供应商、权限和持久化状态的权威 DesktopRuntime。 支持 Linux、macOS 和 Windows;下载最新版本。
移动端 原生 GPUI iOS 和 Android 伴侣应用。将桌面会话模型渲染为 GUI 时间线,并发送类型化远程变更。 从 Releases 获取 Android APK 和未签名 iOS 真机 IPA。
TUI 基于同一套运行时协议的字符网格客户端。随每个桌面安装包发布,也能附着到正在运行的桌面运行时。 vibex、vibex connect 或 vibex-server tui。
无头运行时 vibex-server:没有窗口的同一套权威运行时,适合服务器或常开机器。 ghcr.io/vibex-ai/vibex-server 或发布二进制。
Relay 可选的 Rust/Axum 加密 WebSocket 帧传输服务,不存储工作区、供应商、Agent 或应用数据。 apps/relay-server 和 deploy/relay。

移动端不会启动本地 Agent,不拥有工作区文件系统,不修改本地 Git,也不会成为第二个 PTY 权威。TUI 同样只是客户端:它渲染运行时的投影并发送类型化变更。两者都不会成为第二个后端。


快速开始

安装桌面端

从 GitHub Releases 下载与你平台匹配的安装包:

  • Linux: x86_64 使用 .deb 或 AppImage;aarch64 使用 .deb。
  • macOS: Apple 芯片或 Intel 使用 .dmg。
  • Windows: x86_64 或 ARM64 使用 NSIS .exe。

macOS 和 Windows 安装包目前没有代码签名,首次打开需要 Gatekeeper 或 SmartScreen 放行。具体步骤见安装。

第一次会话

  1. 打开 配置中心 → Agent,添加一个 Agent;如果 Vibex 提供托管运行时,就安装它。
  2. 登录 Agent 自己的账号,或添加一套带 API Key 的模型供应商配置。
  3. 打开一个项目目录,新建会话并发送任务。
  4. 检查计划、工具调用和差异;权限请求到达时逐项批准或拒绝。

试试终端客户端

TUI 随桌面安装包一起发布:

cd /path/to/your/project
vibex

它会附着到该 home 对应的运行时,必要时自己启动一个。运行 vibex status 可以查看它会使用哪个运行时;运行 vibex connect vibex://… 可以配对远程运行时。详见 Vibex TUI。

从源码构建

git clone https://github.com/vibex-ai/vibex.git
cd vibex
git submodule update --init --recursive
pnpm install --frozen-lockfile
pnpm dev:desktop

前置条件:支持子模块的 Git、Node.js 22、pnpm 11.3.0、Rust 1.97.0,以及带可用 Vulkan 驱动的图形会话。


架构

桌面运行时是唯一的权威状态所有者。共享契约和投影让原生桌面端、移动端和 TUI 保持一致,同时避免重复业务状态。

DesktopRuntime / vibex-server
|-- ACP Agent 会话与权威时间线
|-- 工作区文件、编辑器、Git 与托管 worktree
|-- 原生 PTY、内嵌浏览器、电脑操作、内容预览
|-- 共享供应商、路由组与本地模型网关
`-- 类型化 RemoteGateway v2
    |-- Direct 或 Tailnet 传输
    `-- 加密的自托管 Relay
            -> AutoRemoteTransport
            -> 原生移动端 GPUI 客户端
            -> Vibex TUI

主要的所有权边界如下:

  • crates/core 定义序列化 id、DTO、错误、能力以及远程协议契约。
  • crates/desktop-model 负责与框架无关的会话和时间线投影及 reducer。
  • crates/vibex-backend 提供原生适配器与远程适配器共享的、与供应商无关的能力 facade。
  • crates/vibex-ui 负责语义化 token、可移植组件模型、工作流控制器和 shell 组合。
  • crates/vibex-remote-client 负责配对、重连、同步以及 Direct、Tailnet 和 Relay 路由选择。
  • apps/desktop 负责原生工作台和 DesktopRuntime;apps/mobile 与 apps/tui 只把共享投影组合成各自的界面。

详细契约请阅读 UI 架构边界、平台支持矩阵、Remote Protocol v2,以及 SSH Remote Runtime。

隐私与控制

  • 本地优先存储: 会话时间线、工作区元数据、供应商配置、浏览器配置和运行时状态由运行时持有并存储在本地。
  • 明确的权限控制: Agent 工具、终端操作、浏览器导航、电脑操作、设备访问和远程变更都经过能力门控并可审计。
  • 加密远程访问: Direct、Tailnet 和 Relay 路由都使用类型化握手与加密传输。Relay 只转发帧,无法解密业务载荷。
  • 有作用域的供应商配置: 默认情况下 Vibex 不会改写真实 Agent home 配置。导出操作需要用户明确触发,并提供预览和回滚边界。
  • 脱敏诊断: token、私钥、提示词、文件内容、浏览器 Cookie 和终端字节不会写入日志和诊断产物。

开发

Vibex 是一个 Rust 2024 workspace,只用一小套 Node/pnpm 工具处理打包和发布检查。

pnpm check                 # Rust fmt/clippy/tests、前端类型检查、许可证
pnpm release:build-smoke   # 桌面端、移动端和 Relay 构建图
pnpm check:mobile-native   # 移动端 crate 与原生项目契约

迭代时运行与改动相关的最小检查集。打包、移动端、Relay 和发布说明见开发者指南与 docs/operations/release.md。

参与贡献

欢迎提交 Issue 和 Pull Request。提交变更前请注意:

  • 保持 DesktopRuntime 为唯一权威状态所有者,客户端行为必须通过类型化后端和远程契约路由。
  • 迭代时运行与改动相关的最小检查集,涉及跨层改动时再运行 pnpm check。
  • 用户可见行为变化时,同步更新三个语言的用户文档。

许可证

Vibex 是自由软件,采用 GNU Affero General Public License v3.0 或更高版本 授权。第三方包、字体、图标和 PDFium 的声明记录在 docs/licenses 中。