github.com/AnyiWang/OpenCovibe @v0.2.5

本地优先的 AI 辅助编程桌面应用

为什么 · 核心能力 · 快速开始 · 平台 · 架构 · 许可证

English | 简体中文

为什么选择 OpenCovibe？

Claude Code 等 AI 编程 CLI 功能强大，但它们运行在终端里。这意味着没有持久化的面板、没有可视化的 Diff 审查、没有跨会话历史、也无法自由切换多个 API 平台。OpenCovibe 用原生桌面 UI 包装这些 CLI，补上终端无法提供的那些能力层 —— 同时保持所有数据本地存储。（调用远程模型 API 需要联网；应用本身没有云端后台。）

平台状态：目前主要在 macOS 上开发和测试。Windows 和 Linux 可以构建运行，但尚未进行充分的兼容性调整和测试，欢迎提交问题报告和贡献。

核心原则：封装 CLI，可视化工作，数据本地化。

核心能力

CLI 不提供、OpenCovibe 补上的

更多功能

• 富文本聊天 UI — Markdown、语法高亮、思考块、图片附件、文件 Diff、工具突发折叠分组
• 会话控制 — 创建、恢复、分叉、重命名会话；计划模式切换；模型热切换；上下文历史追踪
• 拖拽上传 — 原生文件拖拽，支持图片、PDF、目录和路径引用
• 项目文件夹 — 侧栏项目选择器，Memory、权限和会话按项目隔离
• 内联斜杠命令 — /model、/diff、/todos、/tasks、/doctor、/copy、/stats、/preview、/ralph 等——在应用内原生渲染
• 快捷键 — 完全可自定义的键绑定，支持组合键和冲突检测
• Hook 管理 — 配置上游 CLI Hook，实现事件驱动自动化
• 国际化 — 轻量响应式运行时，支持英文和简体中文
• 系统托盘 — 最小化到托盘；后台会话持续运行，支持原生通知
• 深色 / 浅色主题 — 基于 CSS 变量的主题系统，支持 UI 缩放
• 自动更新 — 应用内更新检测与下载链接
• 安装向导 — 首次启动引导 CLI 检测、认证和平台配置

快速开始

方式 A：下载预编译包（macOS）

从 Releases 下载最新 .dmg —— 通用二进制，同时支持 Apple Silicon 和 Intel Mac。

注意：应用未经代码签名。首次启动时，右键点击应用选择"打开"以绕过 macOS Gatekeeper。

方式 B：自动安装（macOS）

git clone https://github.com/AnyiWang/OpenCovibe.git
cd OpenCovibe
./scripts/setup.sh          # 加 --yes 跳过确认提示
npm run tauri dev

安装脚本自动检测并安装缺少的依赖（Xcode CLI Tools、Homebrew、Node.js、Rust）。

方式 C：手动安装

前置条件：

• 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：

# 从 https://rustup.rs 安装 Rust
# 从 https://nodejs.org 安装 Node.js

构建与运行：

git clone https://github.com/AnyiWang/OpenCovibe.git
cd OpenCovibe
npm install
npm run tauri dev

安装向导

首次启动时，OpenCovibe 会引导你完成：

1. CLI 检测 — 自动检测 Claude Code 和 Codex CLI，未安装则提供安装引导
2. 认证 — OAuth 登录或 API Key，支持 15+ 平台
3. 就绪 — 开始编程

你可以随时从设置 > 通用 > 安装向导重新运行。

支持的平台

LLM 厂商

API 代理

本地

架构

技术栈：

Agent 通信：

每个会话都是由独立的 session actor 管理的长连接多轮进程。Claude Code 通过双向 stream-JSON 协议（stdin/stdout）通信，带交互式控制协议。Codex 支持两种传输方式：codex app-server（双向 JSON-RPC —— 默认，解锁交互式审批、turn 中途 steer、fork/rewind/compact/goal、图片输入和实时命令输出）或 codex exec（每轮一次性 NDJSON —— 回退方案，可在设置中为旧版 Codex CLI 选用）。

数据存储：

所有数据本地存储在 ~/.opencovibe/ —— 无云端，无数据库。

~/.opencovibe/
├── settings.json          # 用户设置
├── runs/                  # 会话历史
│   └── {run-id}/
│       ├── meta.json      # 运行元数据
│       ├── events.jsonl   # 事件日志
│       └── artifacts.json # 摘要
└── keybindings.json       # 自定义快捷键

开发

npm install              # 安装依赖
npm run tauri dev        # 热重载开发模式
npm test                 # 运行测试
npm run lint:fix         # 代码检查
npm run format           # 代码格式化

参与贡献

欢迎贡献！请通过 Issue 提交 Bug 报告或功能建议，也欢迎提交 Pull Request。

许可证

基于 Apache License 2.0 许可。

Copyright 2025-2026 OpenCovibe Contributors.