VibeX

English · 简体中文

IAP · Integrated Agent Platform
A unified workspace for agents, tools, and collaboration in Vibe Coding.

Download · Report an issue · Local development

VibeX brings Claude Code, Codex, OpenCode, Pi, and ACP Registry agents into one desktop environment. Every agent uses a shared pipeline for detection, installation, authentication, configuration, updates, and conversations.

The project is built around three goals: connect more agents, isolate parallel work, and bring software delivery into one place. Developers can organize conversations, create worktrees, delegate subtasks, review code, and use the integrated browser, Git tools, terminals, and session board without leaving the application.

Important

Local operation and privacy: VibeX is a local-first agent host. VibeX does not operate cloud storage and does not automatically upload projects, conversations, configuration, or diagnostics to a VibeX-operated service. When you explicitly connect a remote client to a user-controlled desktop or Headless Host, the data required for the selected remote workflows is sent to that Host.

Testing-stage notice: VibeX is still in testing. Use version control, keep backups of important projects, and review agent-generated changes before committing, syncing, or merging them.

Enabled agents, model providers, MCP servers, plugins, messaging channels, and browser sessions may connect to third-party services according to your configuration. Those services handle data under their own privacy policies.

IAP Capabilities

Multiple agents, one platform

• Built-in agent profiles: First-class support for Claude Code, Codex, OpenCode, and Pi.
• ACP Registry: Browse and add more compatible agents from the official ACP Registry.
• Unified lifecycle: Inspect runtime, ACP adapter, version, location, authentication, configuration, and diagnostics in one place.
• Local runtime reuse: Detect and validate compatible CLIs already installed on the machine.
• Managed installation: Install missing components at pinned versions, persist installation locks, and expose update, repair, and uninstall actions.
• Managed foundation runtimes: Agents that need npm use a Node.js runtime validated and managed by VibeX, without requiring a system Node/npm installation.
• Separate authentication state: Complete account login or API configuration in the corresponding agent after installation.

Agents join the shared conversation pipeline through the Agent Client Protocol (ACP). Model, mode, and reasoning controls are shown according to the capabilities of each agent, while preserving agent-specific behavior.

Worktrees and multi-agent collaboration

• Create an isolated Git worktree for each task so parallel conversations have clear filesystem boundaries.
• Run multiple agent conversations in the same project for implementation, testing, review, and debugging.
• Use &Agent mentions to express delegation intent. When the parent agent has the required MCP capability, it can create asynchronous child conversations and collect their results.
• Track each subtask independently with its own conversation history, status, and cancellation controls.
• Fork, resume, cancel, retry, import, and export conversations while persistent events retain execution history.

Vibe Coding Tools

Component	What it provides
Session board	Organize conversations by project and state, and inspect parallel work, agent status, and resource usage.
Integrated browser	A dedicated Chromium/CEF runtime with tabs, navigation, device sizes, DevTools, element inspection, Console, and Network tools.
Git panel	Inspect changes, diffs, history, branches, stashes, issues, and pull requests; stage and commit changes.
Files and diffs	Browse the file tree, preview common formats, compare unified or side-by-side diffs, and add review comments.
Integrated terminal	Manage multiple terminal sessions and run development servers, tests, and project scripts.
MCP, skills, and plugins	Manage agent tools, reusable skills, and structured workflow actions.
Automations	Save agent, workspace, branch, and action settings; launch isolated scheduled work and retain run history.
Messaging and remote foundations	Send conversation notifications to external channels; a versioned Remote Protocol and headless Host foundation are available for tested remote workflows.
Office artifact previews	Preview .docx, .xlsx, and .pptx artifacts through the managed OfficeCLI capability.

Remote access status

VibeX contains a versioned Remote Protocol, device pairing and revocation, durable conversation replay, and a source-build vibex-server. First-class desktop Server Profiles, official Server containers/binaries, and the Android companion are accepted roadmap work and are not yet released product surfaces. See the P0/P1 remote productization plan and current headless deployment notes.

VibeX does not operate a cloud relay. Remote clients connect to a user-controlled desktop or Headless Host; without an online Host they can only use supported read-only offline data.

Download and Installation

Download the installer for your platform from GitHub Releases.

Platform	Baseline	Architecture	Package	Installation
macOS	macOS 12 or later	Intel / ARM64	.dmg	Open the image and drag VibeX.app into Applications.
Windows	Windows 10/11	x64 / ARM64	.exe / .msi	Run the installer and follow the setup wizard.
Linux	Ubuntu 22.04 equivalent	x64 / ARM64	.AppImage / .deb	Run the AppImage or install the deb with your package manager.

Windows installers include the offline WebView2 installer, so first launch does not depend on a network download. VibeX and its background agent, Git, npm, and uv processes do not open visible console windows. The integrated Chromium/CEF child window on Linux requires X11 or XWayland. The .deb declares an xwayland dependency; pure Wayland systems using the AppImage must install and enable XWayland separately.

On first launch, VibeX checks local agent runtimes and the ACP Registry. Select the agents to enable, choose a default agent and external editor, and continue to the workspace. Missing managed components are installed in the background.

Compatible local runtimes are reused. Account login, browser authorization, and API configuration remain part of each agent's official authentication flow.

If macOS blocks the application

Official releases always use Tauri updater signatures. Developer ID signing and notarization are applied when the project credentials are configured; otherwise macOS installers can still be published unsigned and Gatekeeper may block their first launch. Confirm that the installer came from the official VibeX Releases page, then review the reason under System Settings > Privacy & Security and use Open Anyway only for that verified download. Do not disable Gatekeeper globally or remove quarantine attributes from software obtained from an unknown source.

Initial agent setup

1. Select the agents you want to enable during onboarding.
2. Choose the default agent used for new conversations.
3. Select an external editor.
4. Wait for background installation notifications and review preflight results under Settings > Agents.
5. Complete login or API configuration through the agent's official flow.

If a runtime or ACP adapter is unhealthy, Settings > Agents shows its version, location, diagnostics, and the available install or repair action.

Local Development

Prerequisites

• Node.js 18 or later
• pnpm 8 or later
• Rust; rust-toolchain.toml selects the repository toolchain
• The Tauri system dependencies for your platform
• At least one agent CLI for integration testing

Start the desktop app

pnpm install
pnpm run dev

This starts the React/Vite frontend, Tauri desktop shell, and Rust services.

Checks and tests

pnpm run check
pnpm run lint
cd frontend && pnpm test
cargo test --workspace

Build installers

pnpm run tauri:build

Platform-specific commands are also available:

pnpm run tauri:build:macos
pnpm run tauri:build:windows
pnpm run tauri:build:linux

Architecture

frontend/        React + TypeScript + Vite user interface
src-tauri/       Tauri desktop shell, system integration, and IPC commands
crates/agents/   Agent profiles, ACP, installation, and conversation runtime
crates/git/      Git and worktree capabilities
crates/browser-* Chromium/CEF browser runtime
crates/          Conversations, automations, plugins, artifacts, and services
shared/          TypeScript types generated from Rust

VibeX is built with Tauri, Rust, and React. Application data managed by VibeX stays on the selected user-controlled Host and is not automatically uploaded to a VibeX-operated service. Selected agents, model providers, MCP servers, plugins, messaging channels, and browser sessions may connect to external services under their respective data and account policies.

shared/types.ts is generated. Run pnpm run generate-types after changing shared Rust types.

Contributing

Bug reports and feature requests are welcome through Issues, and pull requests are welcome. Run the checks and tests relevant to your changes before submitting code.

VibeX is licensed under the Apache License 2.0.

Acknowledgements

VibeX is built on Tauri, React, Rust, and the Agent Client Protocol.