Vicoa 是一个开源的 AI 编排平台,解决开发者在面对众多 AI 编程助手(如 Claude Code, Codex, Cursor 等)时的管理痛点。它允许你在任意设备上运行一支由不同 AI 智能体组成的“编程团队”,并通过统一的指挥台进行集中管理、并行协作和跨设备同步。

核心亮点:从单兵作战到团队协同
1. 多智能体并行工作区
- 广泛支持:原生集成或兼容 Claude Code, Codex, OpenCode, Gemini, Cursor, GitHub Copilot, Kimi, Hermes, Pi, Oh My Pi 等主流智能体。
- Git Worktree 隔离:每个智能体在独立的 Git worktree 和分支上运行。这意味着多个 AI 可以同时修改同一个仓库的不同部分,互不干扰,最后再合并代码,彻底解决了并发冲突问题。
- 统一指挥台:所有会话状态集中展示在一个列表中,无需在多个终端标签页之间切换,一目了然地掌控整支“AI 队伍”的进度。
2. 跨设备无缝同步
- 任意机器接入:无论是 Mac、Windows、Linux 笔记本,还是 VPS 或远程服务器,只需安装 Vicoa 守护进程即可接入网络。你可以决定哪个会话跑在哪台机器上,充分利用算力资源。
- 移动端原生应用:提供 iOS 和 Android 应用。正在运行的会话会自动同步到手机,让你随时随地通过语音或文字给项目里的智能体发指令,实现真正的“口袋里的编程团队”。
- 实时通知:只有当智能体需要你的决策或完成任务时才会发送通知,避免信息过载。
3. 深度集成与自动化
- @文件与 /命令:在网页、手机和 CLI 上均支持文件模糊搜索和智能体自带的斜杠命令,保持体验一致。
- 任务看板与自动化:在看板上规划工作,直接从任务开启会话,或设置自动化规则让智能体自动接手重复性工作(如 Cron 定时任务)。
- 技能管理 (Skills):查看、安装和卸载智能体技能,扩展 AI 的能力边界。
- CLI 驱动:所有功能(会话、记录、任务、自动化)均支持 CLI 操作,甚至可以让你的 AI 智能体像人类一样通过命令行驱动 Vicoa。
快速上手
桌面端使用
- 下载并安装 Vicoa 桌面端(支持 macOS, Windows, Linux)。
- 前提条件:确保目标机器上已安装并登录至少一个支持的智能体 CLI(如
claude, codex 等)。 - 启动会话:点击 “New Session”,选择机器和智能体,输入提示词即可开始。
命令行 (CLI) 使用
如果你更习惯终端操作:
npm i -g @vicoa/cli
vicoa
pip install vicoa
vicoa
自托管 (Self-Hosted)
Vicoa 是完全开源且可自托管的,包含后端 API、实时服务及全套客户端。
cp .env.example .env
./backend/scripts/generate-jwt-keys.sh selfhost/keys
docker compose -f docker-compose.selfhost.yml up -d
后端使用 Postgres 数据库,所有数据掌握在你自己手中。
关键理念:自带密钥 (Bring Your Own Key)
Vicoa 不售卖模型订阅,也不中转你的 API 请求。它只是一个编排层:
- 你使用自己现有的智能体订阅或 API Key。
- 智能体运行在你的机器上,使用你的凭证。
- 数据隐私和安全完全由你控制。