Opencovibe
Local-first desktop app for AI-assisted vibe coding
Why · Capabilities · Quick Start · Providers · Architecture · License
English | 简体中文
Why OpenCovibe?
AI coding CLIs like Claude Code are powerful, but they run inside a terminal. That means no persistent dashboard, no visual diff review, no cross-session history, and no multi-provider switching. OpenCovibe wraps these CLIs with a native desktop UI that adds the layers the terminal can't provide — while keeping all your data stored locally. (Remote model APIs require network access; the app itself has no cloud backend.)
| Agent | Status |
|---|---|
| Claude Code | Supported |
| Codex | In progress |
Platform status: Currently developed and tested primarily on macOS. Windows and Linux builds are functional but have not been thoroughly tested for compatibility — contributions and bug reports are welcome.
Core principle: Wrap the CLI, surface the work, keep it local.
Key Capabilities
What the CLI doesn't give you
| Capability | What OpenCovibe adds |
|---|---|
| Visual Tool Cards | Every tool call (Read, Edit, Bash, Grep, Write, WebFetch, …) rendered as an inline card with syntax-highlighted diffs, structured output, and one-click copy |
| Run History & Replay | Browse all past sessions, full event replay, resume / fork from any point |
| Multi-Provider Switching | Use Claude Code with 15+ API providers (DeepSeek, Kimi, Zhipu, Bailian, DouBao, MiniMax, OpenRouter, Ollama, …) — hot-switch without restarting |
| Agent Management | Visual editor to create, edit, and manage custom agent definitions (.md files) with form and source modes |
| Usage Analytics | Per-model token breakdown, cost tracking, daily heatmap, session-level stats |
| Team Dashboard | Read-only view into Claude Code multi-agent teams — task lists, teammate status, message flow |
| Activity Monitor | Real-time hook event stream, tool activity timeline, subagent tracking with nested tool cards |
| Plugin Marketplace | Browse, install, and manage Claude Code plugins and skills from a visual marketplace |
| MCP Management | Discover MCP servers, view per-server status, reconnect / toggle from a panel |
| Inline Permissions | Rich permission review UI with Allow/Deny buttons, CLI-suggested "Always Allow" rules, and AskUserQuestion rendering |
Features
- Rich Chat UI — Markdown, syntax highlighting, thinking blocks, image attachments, file diffs, collapsible tool groups
- Session Control — Create, resume, fork, rename sessions; plan mode toggle; model hot-switch
- Inline Slash Commands —
/model,/diff,/todos,/tasks,/doctor,/copy,/stats, and more — rendered natively in-app - Keyboard Shortcuts — Fully customizable keybindings with chord support and conflict detection
- i18n — English and Chinese (Simplified) with lightweight reactive runtime
- System Tray — Hide to tray; background sessions keep running with native notifications
- Dark / Light Theme — CSS variable-based theming
- Setup Wizard — Guided CLI detection, authentication, and provider configuration on first launch
Quick Start
Option A: Download Pre-built Binary (macOS)
Download the latest .dmg from Releases — universal binary, supports both Apple Silicon and Intel Macs.
Note: The app is not code-signed. On first launch, right-click and select "Open" to bypass macOS Gatekeeper.
Option B: Automated Setup (macOS)
git clone https://github.com/AnyiWang/OpenCovibe.git
cd OpenCovibe
./scripts/setup.sh # add --yes to skip confirmation prompts
npm run tauri dev
The setup script detects missing dependencies (Xcode CLI Tools, Homebrew, Node.js, Rust) and installs them automatically.
Option C: Manual Setup
Prerequisites:
macOS:
xcode-select --install
brew install node
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
Linux (Debian/Ubuntu):
sudo apt install libwebkit2gtk-4.1-dev build-essential curl wget file \
libxdo-dev libssl-dev libayatana-appindicator3-dev librsvg2-dev
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
Windows:
# Install Rust from https://rustup.rs
# Install Node.js from https://nodejs.org
Build & Run:
git clone https://github.com/AnyiWang/OpenCovibe.git
cd OpenCovibe
npm install
npm run tauri dev
Setup Wizard
On first launch, OpenCovibe guides you through:
- CLI Detection — Auto-detects Claude Code CLI, offers installation if missing
- Authentication — OAuth login or API key for 15+ providers
- Ready — Start coding
You can re-run the wizard anytime from Settings > General > Setup Wizard.
Supported Providers
LLM Providers
| Provider | Endpoint | Auth |
|---|---|---|
| Anthropic | Official API | API Key |
| DeepSeek | api.deepseek.com/anthropic |
API Key |
| Kimi (Moonshot) | api.moonshot.cn/anthropic |
Bearer |
| Kimi For Coding | api.kimi.com/coding/ |
API Key |
| Zhipu (智谱) | open.bigmodel.cn/api/anthropic |
API Key |
| Bailian (百炼) | dashscope.aliyuncs.com/apps/anthropic |
Bearer |
| DouBao (豆包) | ark.cn-beijing.volces.com/api/coding |
API Key |
| MiniMax | api.minimax.io/anthropic |
API Key |
| MiniMax (China) | api.minimaxi.com/anthropic |
API Key |
| Xiaomi MiMo (小米) | api.xiaomimimo.com/anthropic |
API Key |
API Gateway
| Platform | Endpoint | Auth |
|---|---|---|
| Vercel AI Gateway | ai-gateway.vercel.sh |
Bearer |
| OpenRouter | openrouter.ai/api |
Bearer |
| AiHubMix | aihubmix.com |
API Key |
Local
| Platform | Endpoint |
|---|---|
| Ollama | localhost:11434 |
| CC Switch | localhost:15721 |
| Claude Code Router | localhost:3456 |
| Custom | Any Anthropic-compatible endpoint |
Architecture
Tech Stack:
| Layer | Technology |
|---|---|
| Framework | Tauri v2 (Rust backend + WebView) |
| Frontend | Svelte 5 + SvelteKit (adapter-static) |
| Styling | Tailwind CSS v3 + CSS variables |
| Terminal | xterm.js |
| Markdown | marked + highlight.js + DOMPurify |
| i18n | Custom lightweight runtime (en + zh-CN) |
| Testing | Vitest |
Agent Communication:
The app communicates with Claude Code CLI via bidirectional stream-JSON protocol (stdin/stdout). Each session is a long-lived, multi-turn process managed by a per-run session actor. Four communication modes are supported: stream-JSON (primary), PTY (interactive terminal), pipe (Codex), and direct API (HTTP streaming).
Data Storage:
All data is stored locally at ~/.opencovibe/ — no cloud, no database.
~/.opencovibe/
├── settings.json # User settings
├── runs/ # Session history
│ └── {run-id}/
│ ├── meta.json # Run metadata
│ ├── events.jsonl # Event log
│ └── artifacts.json # Summary
└── keybindings.json # Custom shortcuts
Development
npm install # Install dependencies
npm run tauri dev # Dev mode with hot-reload
npm test # Run tests
npm run lint:fix # Lint
npm run format # Format
Contributing
Contributions are welcome! Please read CONTRIBUTING.md for development setup, coding conventions, and PR guidelines.
Star History
License
Licensed under the Apache License 2.0.
Copyright 2025-2026 OpenCovibe Contributors.
