English  |  简体中文

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.
• Signed 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 is the real feature list.

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.

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.

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 or AppImage (x86_64); .deb for aarch64.
• macOS: .dmg for Apple silicon or Intel.
• Windows: NSIS .exe for x86_64 or ARM64.

macOS and Windows packages are currently unsigned, so the first launch needs Gatekeeper or SmartScreen approval. See Install for the exact steps.

1. Open Config Center → Agents, add an Agent, and install its managed runtime if Vibex offers one.
2. Sign in to the Agent's own account, or add a model Provider profile with an API key.
3. Open a project folder, start a session, and send a task.
4. Review the plan, tool calls, and diff; approve or deny permission requests as they arrive.

The TUI ships with the desktop package:

cd /path/to/your/project
vibex

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:desktop

Prerequisites: Git with submodule support, Node.js 22, pnpm 11.3.0, Rust 1.97.0, 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/core defines serialized ids, DTOs, errors, capabilities, and remote protocol contracts.
• crates/desktop-model owns framework-neutral session and timeline projections and reducers.
• crates/vibex-backend exposes provider-neutral capability facades shared by native and remote adapters.
• crates/vibex-ui owns semantic tokens, portable component models, workflow controllers, and shell composition.
• crates/vibex-remote-client owns pairing, reconnect, synchronization, and Direct, Tailnet, and Relay route selection.
• apps/desktop owns the native workbench and DesktopRuntime; apps/mobile and apps/tui compose the shared projections into their own surfaces.

Read the UI architecture boundary, platform support matrix, Remote Protocol v2, and SSH Remote Runtime 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 contract

Use the smallest relevant gate while iterating. Packaging, mobile, Relay, and release instructions live in the developer guide and docs/operations/release.md.

Issues and pull requests are welcome. Before opening a change:

• Keep DesktopRuntime as the only authority and route client behavior through typed backend and remote contracts.
• Run the smallest relevant gate while iterating, then run pnpm check for cross-layer changes.
• Update the user guide in all three documentation locales when behavior changes.

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.