VaneHub AI

Desktop-first workspace for managing AI coding agents through one React interface and explicit Web/mock and Tauri runtime boundaries.

Overview

VaneHub AI brings Claude Code, OpenCode, Codex CLI, Gemini CLI, and Antigravity CLI into a shared desktop workspace. It manages CLI availability, sessions, terminal execution, projects and worktrees, settings, tools, observability, and desktop integrations without letting React components depend directly on native APIs.

Supported CLIs

One is enough to start. You do not need all five.

• In-app install means VaneHub AI can install and upgrade the CLI for you from Settings → CLI management. It drives npm, WinGet on Windows, and per-CLI audited vendor installers. A copy that came from Homebrew, Bun, Volta, a desktop bundle, or a system package is detected and reported but never changed — VaneHub names the tool that owns it instead of installing a second copy beside it.
• Third-party model endpoint means the CLI can be pointed at a compatible endpoint such as DeepSeek or OpenRouter from Settings → Agent configurations. Vendor subscription login (OAuth) always happens in your terminal; VaneHub AI does not broker it.
• OpenCode’s model family is “Unknown” by decision, not omission: it drives whichever model you configured, so it has no fixed family, and policies such as “require a reviewer from a different model family” do not apply to it.
• Gemini CLI is being replaced by Antigravity CLI. Google began phasing it out for personal and free accounts on 2026-06-18.
• If you would rather install no CLI at all, the built-in native API Agent OnePiece calls model providers over HTTP entirely inside the application. See the user guide below.

Supported model providers

Twenty-five providers ship as configuration templates, shared by OnePiece and three of the CLI Agents. Anything outside the catalog can be added as a custom compatible endpoint.

Which Agent a provider can serve depends on the endpoint protocols it offers: the 16 providers speaking Anthropic Messages can back Claude Code, and the 24 speaking OpenAI Chat Completions can back Codex CLI and OpenCode.

The full catalog — vendor icons, endpoint protocols, default models, and API key links — is in the built-in model provider catalog (Simplified Chinese).

Download

Prebuilt desktop packages are published on the Releases page: a signed Windows x64 .exe installer, signed and notarized macOS x64 and Apple Silicon .dmg files, and Linux x64 and ARM64 .deb and AppImage builds. No .msi or .rpm is published.

Verify downloads against the published SHA256SUMS, SPDX SBOM, and GitHub attestations. Linux packages carry integrity and provenance evidence but do not use operating-system code signing.

Documentation

User guide

Developer guide

User guides are available in English and Simplified Chinese. Japanese, Traditional Chinese, and Korean are delivered as application UI resource locales only; no user guide is provided for those locales.

Architecture

flowchart LR
  UI[React UI] --> Service[Frontend service interfaces]
  Service --> Web[Web/mock adapters]
  Service --> Tauri[Tauri adapters]
  Tauri --> Commands[Rust commands]
  Commands --> Contexts[Native bounded contexts]
  Contexts --> SQLite[(SQLite)]
  Contexts --> CLI[Agent CLIs]

React components call services in src/services/. Tauri-specific invoke() calls stay in frontend Tauri adapters, while SQLite, CLI processes, filesystem access, and desktop lifecycle behavior stay in Rust.

Run from source

Prerequisites: Node.js 22+, npm, stable Rust, and the Tauri prerequisites for your platform.

For platform linker requirements, release-profile behavior, worktree cache guidance, and measured build evidence, see the native build performance guide.

npm ci

Run Web/mock preview:

npm run dev -- --host 127.0.0.1

Run the desktop application:

$env:PATH="$env:USERPROFILE\.cargo\bin;$env:PATH"
npm run tauri -- dev

Web/mock is a deterministic browser simulation. It does not claim local CLI execution, SQLite persistence, filesystem changes, or operating-system side effects.

Development

Run every command in the「校验命令」(validation commands) section of AGENTS.md verbatim before submitting changes; that list is the single source of truth aligned with CI.

New features and architecture changes require an OpenSpec proposal before implementation. See AGENTS.md and openspec/project.md for project rules.

Agent infrastructure technical documentation

Reference: native architecture inventory · contributing · native build performance · release signing

Build the mdBook guides and Rustdoc reference:

npm run docs:check
npm run docs:test
npm run docs:build

The documentation build requires the mdBook version pinned in docs/toolchain.json.

Roadmap

Implemented work and current contracts are recorded in OpenSpec main specifications. Near-term product work includes custom Agents, a plugin marketplace, and extended local OCR/speech capabilities.

Contributing

Read CONTRIBUTING.md before opening a change. Keep documentation, both frontend runtime adapters, native contracts, tests, and OpenSpec artifacts aligned with the behavior you change.

License

Licensed under the Apache License 2.0. See LICENSE.