vibex-ai/vibex
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
原文
你的 Agent,你的工作区,你来掌控——从提示词到提交,从桌面到终端再到手机。
面向 Agent 驱动软件开发的原生、本地优先 AI 编程工作台,建立在 Agent Client Protocol 之上。
网站 • 文档 • 快速开始 • 功能 • 支持的 Agent • 产品形态 • 开发
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 在另一台机器上运行权威运行时,或把 |
|
跟得上的会话把后续消息排进队列、引导正在运行的回合、把发送安排到稍后,或让自动继续把回合推进到完成。搜索所有对话、导入本地 Agent 历史,并带着完整时间线恢复已归档会话。 |
|
市场、上下文与预览从应用内市场安装 MCP 服务器和 Skill,编写可复用 Prompt,并按 Agent 限定每项资源。在工作台里阅读 Markdown、PDF、Office 文档和图片,支持分栏、全屏预览,以及属于你的工作台背景。 |
另外还内置了:
- 全局搜索与命令面板 —— 一次搜索会话、设置和快捷操作。
- 用量统计 —— 按 Agent、项目、供应商、模型和时间范围查看 token 与成本。
- 通知与未读状态 —— Agent 完成、失败或需要输入时及时知道。
- 会话归档 —— 把完成的工作移出侧栏,同时保留完整时间线。
- 签名自动更新 —— 默认开启,更新清单经过签名校验。
- 主题与工作台背景 —— 二十套内置主题、自定义 JSON 主题,以及静态或动态背景。
- 还有更多,每周都在发布 —— 更新日志才是真正的功能清单。
支持的 Agent
Vibex 使用 Agent Client Protocol(ACP)作为在线 Agent 传输协议。Agent 的身份和能力与连接它所使用的协议彼此分离。兼容 任何 ACP Agent——只要说 ACP,就能在 Vibex 中运行。
|
Claude Code |
Codex |
ZCode |
OpenCode |
Antigravity |
Cline |
|
Codebuddy |
Cursor |
Gemini CLI |
GitHub Copilot |
Devin |
Grok Build |
|
Hermes |
Kimi Code |
Pi |
DeepSeek Harness |
任意 ACP Agent |
更多 Agent 待添加 |
内置预设包括 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 放行。具体步骤见安装。
第一次会话
- 打开 配置中心 → Agent,添加一个 Agent;如果 Vibex 提供托管运行时,就安装它。
- 登录 Agent 自己的账号,或添加一套带 API Key 的模型供应商配置。
- 打开一个项目目录,新建会话并发送任务。
- 检查计划、工具调用和差异;权限请求到达时逐项批准或拒绝。
试试终端客户端
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 中。