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.)

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

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:

1. CLI Detection — Auto-detects Claude Code CLI, offers installation if missing
2. Authentication — OAuth login or API key for 15+ providers
3. Ready — Start coding

You can re-run the wizard anytime from Settings > General > Setup Wizard.

Supported Providers

LLM Providers

API Gateway

Local

Architecture

Tech Stack:

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, coding conventions, and PR guidelines.

Star History

License

Licensed under the Apache License 2.0.

Copyright 2025-2026 OpenCovibe Contributors.