OcHub

English · 简体中文

One native control center for your AI coding tools.

Connect providers, switch models, share MCP servers and skills,
and route every supported client through one local gateway.

Download OcHub · Why OcHub · Install · Build from source

Why OcHub

AI coding tools are powerful, but each one keeps its providers, MCP servers,
skills, sessions, and usage data in a different place. Changing an API endpoint
or sharing the same setup across several clients quickly turns into repeated
config-file editing.

OcHub brings that work into one fast, native desktop app. Use it as a simple
connection switcher, or place its local gateway between your tools and upstream
APIs for centralized routing, compatibility conversion, failover, and usage
tracking.

OcHub currently manages Claude Code, Claude Desktop, Codex, Grok Build,
OpenCode, OpenClaw, and Hermes.

Everything in one place

Two ways to connect

Direct connection

Choose a tool, add an API connection, test it, and switch. OcHub writes the
client's native configuration, so the tool keeps working normally after OcHub
is closed.

Best for: a straightforward endpoint change, a tool's official login, or a
small setup with independent connections.

Model provider mode

Point supported clients at OcHub's loopback gateway. The gateway can translate
between supported API dialects and apply model aliases, reasoning mappings,
interface retries, health checks, and failover before a request reaches its
upstream.

Best for: sharing an upstream across tools, normalizing model names,
converting API formats, tracking usage centrally, or building a resilient
multi-provider setup.

Built for the desktop

• Native UI powered by GPUI — no browser shell or webview
• Local-first storage in ~/.ochub/
• Cross-platform releases for macOS, Windows, and Linux
• In-app updates for DMG, Windows installer, and AppImage installations
• Open source under GPL-3.0-or-later

[!IMPORTANT]
OcHub is under active pre-release development. Back up important tool
configuration before trying an early build. OcHub only changes the live
configuration of applications you explicitly manage.

Install

Homebrew

Homebrew automatically selects the correct Apple Silicon or Intel build:

brew install --cask ochub-team/tap/ochub

OcHub is not yet notarized by Apple. If macOS blocks the first launch, open
System Settings → Privacy & Security and choose Open Anyway, or install
without the quarantine flag:

brew install --cask --no-quarantine ochub-team/tap/ochub

Direct download

Download the latest release for your platform from the
GitHub Releases page.

Releases include SHA256SUMS and a GitHub artifact attestation. Packaging,
signature verification, and release details live in the
release guide.

The headless archives contain ochcli and ochubd. See the included README
or run ochcli --help to configure and operate OcHub without the desktop GUI.

Build from source

OcHub is a Rust workspace built with GPUI and axum. The repository pins its
Rust toolchain, so rustup will select the correct version automatically.

git clone https://github.com/OcHub-team/OcHub.git
cd OcHub
cargo run -p ochub-app

Platform requirements:

• macOS: Xcode or Xcode Command Line Tools
• Windows: Visual Studio 2022 Build Tools with the Windows SDK
• Debian/Ubuntu: ./scripts/ci/install-linux-deps.sh

Common development commands:

just check
just test
just ci
just qa-app       # macOS: builds /tmp/OCHUB-QA.app for acceptance testing

The workspace is split into these main components:

License

OcHub is licensed under the
GNU General Public License v3.0 or later.

OcHub draws inspiration from
cc-switch and
new-api.