Your agents. Your workspace. Your control — from prompt to commit, desktop to terminal to phone.
A native, local-first AI coding workbench built on the Agent Client Protocol.
Website • Docs • Quick start • Features • Supported agents • Surfaces • Development
Vibex brings Agent sessions, source code, Git, terminals, an embedded browser, desktop automation, and provider configuration into one focused workbench. The desktop runtime stays in control of Agent processes, session history, workspace files, Git, PTYs, providers, and permissions. A native mobile client and a terminal client let you monitor and steer those same sessions remotely, while an optional self-hosted Relay carries only encrypted frames.
No Vibex-hosted workspace is required. Your repository, credentials, and durable session state remain on the machines you choose.
Also in the box:
- Global search and command palette — one search across sessions, settings, and quick actions.
- Usage statistics — tokens and cost by Agent, project, provider, model, and time range.
- Notifications and unread state — know when an Agent finishes, fails, or needs input.
- Session archive — keep finished work out of the sidebar without losing its timeline.
- Auto-updates — on by default, verified against a signed release manifest.
- Themes and workbench backgrounds — twenty built-in themes, custom JSON themes, and still or animated backgrounds.
- And more shipping every week — the changelog.
Vibex uses the Agent Client Protocol (ACP) as the online Agent transport. An Agent's identity and capabilities stay separate from the protocol used to connect it. Works with any ACP-compatible agent — if it speaks ACP, it runs in Vibex. Agents that ship their own TUI can also run in their native terminal mode directly inside Vibex.
|
Claude Code |
Codex |
ZCode |
OpenCode |
Antigravity |
Cline |
|
Codebuddy |
Cursor |
Gemini CLI |
GitHub Copilot |
Devin |
Grok Build |
|
Hermes |
Kimi Code |
Pi |
DeepSeek Harness |
Any ACP Agent |
More agents coming soon |
Built-in presets include Claude Code, Codex, ZCode, and OpenCode. The ACP catalog also includes Antigravity, Cline, Codebuddy, Cursor, Gemini CLI, GitHub Copilot, Devin, Grok Build, Hermes, Kimi Code, Pi, DeepSeek Harness, and more. Availability is checked against the installed runtime, provider configuration, and live capability probes.
You can also register any ACP-compatible executable with its command, arguments, environment, and display metadata. Adding an Agent does not require a new UI or a second vendor-specific session protocol.
| Surface | Role | Entry point |
|---|---|---|
| Desktop | Full native GPUI workbench and the authoritative DesktopRuntime for Agents, workspaces, files, Git, PTYs, browser, computer use, providers, permissions, and durable state. |
Linux, macOS, and Windows; download the latest release. |
| Mobile | Native GPUI iOS and Android companion. Renders the desktop session model as a GUI timeline and sends typed remote mutations. | Android APK and unsigned iOS device IPA from Releases. |
| TUI | Character-grid client over the same runtime protocol. Ships inside every desktop package and can attach to a running desktop runtime. | vibex / vibex-tui, vibex connect, or vibex-server tui. |
| Headless runtime | vibex-server: the same authoritative runtime without a window, for a server or always-on machine. |
ghcr.io/vibex-ai/vibex-server or a release binary. |
| Relay | Optional Rust/Axum transport for encrypted WebSocket frames. It stores no workspace, provider, Agent, or application data. | apps/relay-server and deploy/relay. |
Mobile never starts a local Agent, owns a workspace filesystem, mutates local Git, or becomes a second PTY authority. The TUI is a client too: it renders the runtime's projections and sends typed mutations. Neither client becomes a second backend.
Download the package for your platform from GitHub Releases:
- Linux:
.deb,.rpm, or AppImage (x86_64);.debor.rpmfor aarch64. - macOS:
.dmgfor Apple silicon or Intel. - Windows: NSIS
.exefor x86_64 or ARM64.
Arch Linux users can install from the AUR instead, which republishes the release
.deb with the vibex and vibex-tui commands on PATH:
yay -S vibex-bin # or: paru -S vibex-binmacOS and Windows packages are currently unsigned, so the first launch needs Gatekeeper or SmartScreen approval. See Install for the exact steps.
- Open Config Center → Agents, add an Agent, and install its managed runtime if Vibex offers one.
- Sign in to the Agent's own account, or add a model Provider profile with an API key.
- Open a project folder, start a session, and send a task.
- Review the plan, tool calls, and diff; approve or deny permission requests as they arrive.
The TUI ships with the desktop package and works from a terminal straight after install:
cd /path/to/your/project
vibex # or vibex-tui; both names are the same clientIt serves the channel it was installed as — the RC package opens desktop-rc,
the stable package desktop-stable — so nothing has to be exported first. Use
vibex --channel stable to serve another channel for one run. It attaches to
the runtime for that home, starting one if needed. Run vibex status to see
which runtime it would use, or vibex connect vibex://… to pair with a remote
runtime. See Vibex TUI.
git clone https://github.com/vibex-ai/vibex.git
cd vibex
git submodule update --init --recursive
pnpm install --frozen-lockfile
pnpm dev:desktopPrerequisites: Git with submodule support, Node.js 22, pnpm 11.3.0, Rust 1.99.1, and a graphical session with a working Vulkan driver.
The desktop runtime is the single authority. Shared contracts and projections keep the native desktop, mobile, and TUI behavior aligned without duplicating business state.
DesktopRuntime / vibex-server
|-- ACP Agent sessions and authoritative timelines
|-- Workspace files, editor, Git, and managed worktrees
|-- Native PTYs, embedded browser, computer use, content previews
|-- Shared Providers, route groups, and the local model gateway
`-- Typed RemoteGateway v2
|-- Direct or Tailnet transport
`-- Encrypted self-hosted Relay
-> AutoRemoteTransport
-> Native mobile GPUI client
-> Vibex TUI
The main ownership boundaries are:
crates/coredefines serialized ids, DTOs, errors, capabilities, and remote protocol contracts.crates/desktop-modelowns framework-neutral session and timeline projections and reducers.crates/vibex-backendexposes provider-neutral capability facades shared by native and remote adapters.crates/vibex-uiowns semantic tokens, portable component models, workflow controllers, and shell composition.crates/vibex-remote-clientowns pairing, reconnect, synchronization, and Direct, Tailnet, and Relay route selection.apps/desktopowns the native workbench andDesktopRuntime;apps/mobileandapps/tuicompose the shared projections into their own surfaces.
Read the UI architecture boundary, platform support matrix, Remote Protocol v2, SSH Remote Runtime, and IM chat channels for the detailed contracts.
- Local-first storage: session timelines, workspace metadata, provider profiles, browser profiles, and runtime state are owned by the runtime and stored locally.
- Explicit permissions: Agent tools, terminal actions, browser navigation, computer use, device access, and remote mutations are capability-gated and auditable.
- Encrypted remote access: Direct, Tailnet, and Relay routes use typed handshakes and encrypted transport. Relay forwards frames but cannot decrypt business payloads.
- Scoped provider configuration: Vibex does not rewrite real Agent home configuration by default. Export is an explicit user action with preview and rollback boundaries.
- Redacted diagnostics: tokens, private keys, prompts, file contents, browser cookies, and terminal bytes are excluded from logs and diagnostic artifacts.
Vibex is a Rust 2024 workspace with a small Node/pnpm toolchain for packaging and release checks.
pnpm check # Rust fmt/clippy/tests, frontend typecheck, licenses
pnpm release:build-smoke # desktop, mobile, and Relay build graph
pnpm check:mobile-native # mobile crate and native project contractUse the smallest relevant gate while iterating. Packaging, mobile, Relay, and release instructions live in the developer guide and docs/operations/release.md.
Thanks to every developer who has helped Vibex. If you run into a problem, open an Issue or a Pull Request.
- Agent Client Protocol — Vibex implements its Agent communication on top of ACP.
- GPUI GPUI-KIT — the GPUI core and the GPUI-KIT component library render the Vibex desktop and mobile apps.
- Cua — Vibex builds computer use on top of Cua.
- Linux.do — Linux.do gives Vibex a place to spread the word and talk with users.
Vibex is free software licensed under the GNU Affero General Public License v3.0 or later. Third-party package, font, icon, and PDFium notices are recorded in docs/licenses.














