<img src="static/logo-text.png" width="360" alt="OpenCovibe"> Local-first desktop app for AI-assisted vibe coding <a href="#why-opencovibe">Why</a> · <a href="#key-capabilities">Capabilities</a> · <a href="#quick-start">Quick Start</a> · <a href="#supported-providers">Providers</a> · <a href="#architecture">Architecture</a> · <a href="#license">License</a> English | <a href="README.zh-CN.md">简体中文</a>

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, soft-delete with recovery | | Multi-Provider Switching | Use Claude Code with 15+ API providers (DeepSeek, Kimi, Zhipu, Bailian, DouBao, MiniMax, OpenRouter, Ollama, …) — hot-switch without restarting | | Remote Browser Access | Embedded web server for browser-based access over LAN or HTTP tunnels (ngrok / cloudflared) | | File Explorer | Browse and edit project files with syntax highlighting, markdown preview, image preview, and git diff view | | Memory Editor | Create and edit CLAUDE.md, project-scoped and user-scoped memory files with live preview | | Agent Management | Visual editor to create, edit, and manage custom agent definitions (.md files) with form and source modes | | Permission Rules | Manage CLI permission allow/deny rules at user and project level with a visual rule editor | | Usage Analytics | Per-model token breakdown, cost tracking, daily heatmap, stacked model chart, 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, file tracking panel, 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 batch Allow/Deny panel, CLI-suggested "Always Allow" rules, and AskUserQuestion rendering | | CLI Session Import | Discover and import existing Claude Code CLI sessions into OpenCovibe | | Rewind | Checkpoint and selectively revert file changes with dry-run preview | | Remote Hosts | Configure SSH hosts for remote CLI execution with key generation wizard and connectivity testing | | Doctor Diagnostics | System health checks for CLI, platform, SSH, and proxy configuration |

Features

Rich Chat UI — Markdown, syntax highlighting, thinking blocks, image attachments, file diffs, collapsible tool burst groups
Session Control — Create, resume, fork, rename sessions; plan mode toggle; model hot-switch; context history tracking
Drag & Drop — Native file drag-drop for images, PDFs, directories, and path references
Project Folders — Sidebar project selector with per-project scoping for memory, permissions, and sessions
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
Hook Manager — Configure upstream CLI hooks for event-driven automation
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 with UI zoom control
Auto Update — In-app update checker with download links
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:

Node.js >= 20
Rust >= 1.75

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 | Bearer | | Kimi (Moonshot) | api.moonshot.cn/anthropic | Bearer | | Kimi For Coding | api.kimi.com/coding/ | Bearer | | Zhipu (智谱) | open.bigmodel.cn/api/anthropic | Bearer | | Zhipu (智谱 Intl) | api.z.ai/api/anthropic | Bearer | | Bailian (百炼) | coding.dashscope.aliyuncs.com/apps/anthropic | Bearer | | DouBao (豆包) | ark.cn-beijing.volces.com/api/coding | Bearer | | MiniMax | api.minimax.io/anthropic | Bearer | | MiniMax (China) | api.minimaxi.com/anthropic | Bearer | | Xiaomi MiMo (小米) | api.xiaomimimo.com/anthropic | Bearer |

API Gateway

| Platform | Endpoint | Auth | |----------|----------|------| | Vercel AI Gateway | ai-gateway.vercel.sh | Bearer | | OpenRouter | openrouter.ai/api | Bearer | | AiHubMix | aihubmix.com | Bearer | | ZenMux | zenmux.ai/api/anthropic | Bearer |

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. Three communication modes are supported: stream-JSON (primary), PTY (interactive terminal), and pipe (Codex).

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,

OpenCovibe

Install / Use

README