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, and Gemini 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.

Feature status

• Delivered: CLI management, single-Agent sessions, interactive Agent terminals, session organization, project/worktree and SSH workspace tools, settings, MCP/SDK/Skills/Prompt Hooks/extensions, IM connectors, scheduled tasks, notifications, usage reporting, unified redacted logs, and cross-platform packaging.

• Preview: Multi-Agent coordination has native and Web/mock service contracts for validated dependency graphs, ordered fallback, persistence, cancellation, and output propagation.

• Planned: The normal create-session UI still disables Multi Agent mode. The workflow guide does not present unavailable controls as delivered.

• Planned: Japanese runtime UI resources. Japanese is currently supported for this README, not for the application UI.

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.

Quick start

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.

Documentation

• User Guides — English and 简体中文
• Developer Guide source
• Native architecture inventory
• Contributing guide
• Native build performance guide
• Release signing guide

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.

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.

Roadmap

Delivered work and current contracts are recorded in OpenSpec main specifications. Near-term product work includes the Multi-Agent coordination UI, persistent Agent memory, 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.