Vicoa
开源 AI 编排器:在桌面、手机或 VPS 上指挥一支编程代理团队,会话随处同步,支持自托管。
- Star 数
- ★ 544
- 最近更新
- 1 天前
- License
- AGPL-3.0
- 主语言
- Python
- FA 评分
- 67/100 · 存在缺口
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code
- 费用
- 软件免费,模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 白天在桌面启动多个代理并行改造同一个仓库的工程师,下班后在手机上继续审批 diff、回答代理的提问
- 不适合
- 希望单一厂商托管、无需自备模型订阅或 API key 的用户
- 不想自己部署后端和数据库、也接受不了账号云同步的团队
- 只需要一个纯聊天式代码助手的开发者
- 官网
- vicoa.ai ↗ 来自 GitHub 仓库设置
- 维护状态
- 近 30 天有提交最近提交 2026-11-20最新版本 v0.2.1(2026-11-20)近 7 天每天 +0.6 ★
- 源码审查
- 67/100 · 存在缺口
这个 Agent 能做什么,适合哪些场景?
Vicoa 是一个开源(AGPLv3)的 AI 编排器,用于从任意设备运行和管理多个编程代理(Claude Code、Codex、OpenCode 等 40+ 个)。它由 Python/FastAPI 后端加 PostgreSQL、本地 vicoa 守护进程、Next.js Web/桌面端(Electron)和 Flutter 移动端(iOS/Android)组成,全套可通过 Docker 自托管。每个代理在自己的 git worktree 和分支上并行工作,所有会话在统一列表中管理,可在手机上查看对话、内联 diff 和接收推送通知。用户自带模型订阅或 API key(BYO-key),代理以本机已安装并登录的 CLI 身份被启动。README 明确说明这套栈是完整开源、可自托管的。
Vicoa 的本地守护进程(vicoa 或 vicoa daemon)检测机器上已安装的代理 CLI,按你选择的位置(本机、VPS、远程服务器)生成会话;每个代理运行在独立的 git worktree 和分支上以并行处理同一仓库。后端(FastAPI + WebSocket + PostgreSQL)负责认证、会话、消息、任务和自动化(cron 计划任务),并把所有会话实时同步到 Web、桌面和移动客户端。用户从统一列表监控全部会话,通过 @文件 模糊引用、/命令、语音听写或任务看板下发指令;在桌面或手机上逐文件查看内联 diff、提交历史、文件树、终端和本地开发的实时预览。CLI 同样可操作会话、聊天历史、任务与自动化,因此代理本身也能驱动 Vicoa。代理集成方面,Claude Code、Codex、Pi、Oh My Pi、Antigravity 为原生集成,其余(Cursor、Copilot、Kimi 等)通过 Agent Client Protocol(ACP)连接,另有 30+ 个 ACP 代理内置目录,可用 vicoa provider add <id> 添加。
- 白天在桌面启动多个代理并行改造同一个仓库的工程师,下班后在手机上继续审批 diff、回答代理的提问
- 在多台机器(Mac、Windows、Linux、VPS)上有代码的开发者,想从一个界面选择会话在哪台机器上运行
- 需要同时评估 Claude Code、Codex、OpenCode、Gemini 等多个代理效果的团队,想在同一工作区并排运行对比
- 想用 cron 定时让代理自动认领看板任务并完成的维护者(Automations + 任务管理)
- 希望把整套编排栈部署在自己基础设施上(Docker + Postgres)、数据不经第三方托管的团队
- 想让 CLI 中的代理反向驱动 Vicoa(启动会话、查询任务和自动化)的自动化玩家
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 安装 / 启动命令
npm i -g @vicoa/clipip install vicoa
- 配置文件
.env.example.envdocker-compose.selfhost.yml- 运行环境
- Node.js 18+
- 安装说明涉及
- Windows · macOS · Linux · Docker
如何安装或部署这个 Agent?
安装桌面端:从 https://vicoa.ai/download 下载 macOS、Windows 或 Linux 版本,打开并登录。前提条件:运行代理的机器上需安装并登录至少一个受支持的代理 CLI(如 claude、codex、opencode)。
安装 CLI(Node.js 18+):
bash
npm i -g @vicoa/clivicoa
Intel Mac 或旧 glibc 系统改用 pip:
bash
pip install vicoa自托管整套栈(Docker):
bash
cp .env.example .env # passwords and public URLs
./backend/scripts/generate-jwt-keys.sh selfhost/keys
docker compose -f docker-compose.selfhost.yml up -d详细步骤见仓库中的 SELF_HOSTING.md。移动端:App Store / Google Play 搜索 Vicoa 安装后用同一账号登录。
如何使用这个 Agent?
- 安装并登录 Vicoa Desktop。
- 点击 New Session,选择机器、代理(如 claude、codex),输入第一条提示词。
- 在手机安装 Vicoa App 并用同一账号登录,运行中的会话自动同步。
纯终端用法:
bash
vicoa # start a session, or vicoa daemon to just connect this machine
vicoa provider add <id> # add an ACP agent from the built-in catalog会话内可用 @文件 模糊引用文件、使用该代理自己的 /命令,或用听写功能语音输入;桌面和手机均可查看内联 diff、文件树、终端和本地 dev 网站的实时预览。任务在任务看板上规划,可从任务直接启动会话或交给 Automations 定时自动执行。
这个 Agent 有哪些优点和局限?
- 40+ 代理支持且并行运行在同一仓库:每个代理使用独立 git worktree 和分支,避免相互冲突,这是纯终端多开会话做不到的
- 真正的移动端体验:原生 iOS/Android 应用提供会话、对话、实时 git diff 和锁屏推送通知,而非简单的聊天网页
- 供应商中立、BYO-key:启动的是你本机已安装并已认证的代理 CLI,用你自己的订阅或 API key,可自托管整套栈
- 可编程:CLI 覆盖会话、聊天历史、任务和自动化,代理也能像人一样驱动 Vicoa
- 运行代理的机器必须先安装并登录至少一个受支持的代理 CLI,Vicoa 本身不提供模型能力,需自备订阅或 API key
- 自托管需要维护 Docker Compose、JWT 密钥生成和 PostgreSQL 等组件,成本高于单二进制工具
- 会话跨设备同步依赖账号体系,断网或后端不可用时多端协同中断;自托管需自行保证其可用性
- AGPLv3 许可证对商业集成和二次分发有传染性约束,需法律评估
- 桌面端为 Electron,移动端需 Flutter 构建,对资源敏感或想嵌入自有应用的团队有额外适配成本
这个 Agent 与同类方案有什么区别?
README 将 Vicoa 定位为运行 Claude Code、Codex、Cursor、Pi、Kimi 等多种代理 CLI 的编排层,与直接在终端里单独使用这些代理相比,Vicoa 增加了并行 worktree、统一指挥、多设备同步和移动端通知;仓库本身未点名其他编排竞品。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Vicoa 当前 | 67 · 存在缺口 | 桌面应用免费 + 模型费 | ★ 544 | 1 天前 | Python | Codex · Claude Code |
| Cezar — AI 编码代理编排器 | 62 · 存在缺口 | 命令行工具免费 | ★ 1.1k | 今天 | TypeScript | Codex · Claude Code |
| gnhf(Good Night, Have Fun) | 55 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 4.3k | 4 天前 | TypeScript | Codex · Claude Code |
| Kandev | 74 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 1.2k | 今天 | Go | Codex · Claude Code |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
文档说明 CLI 使用用户自己的 Agent 凭据,并为任务变更、分享会话、创建自动化和启动会话规定先检查或确认;分享链接可能向持有链接者公开记录,自动化会启动真实会话。文档还描述 API key 哈希存储、撤销检查和私下报告安全问题。扣分原因:Vicoa 会代表用户启动代码代理和定时任务,权限范围及其对代码的访问较广;所给源代码片段未展示各操作完整的授权、密钥存储或恢复实现,也没有明确的来源归属细节。
两个服务入口都描述了各自的职责和关闭流程;后端对数据库断连返回可重试的 503,CLI 在更新检查失败时采用尽力而为处理,SSE 错误有日志。测试片段体现了数据库事务隔离和访问控制语义。扣分原因:依赖清单、可用性策略及完整故障处理路径未提供;测试片段不能证明运行结果。
产品面向跨桌面、移动、远程机器和自托管场景,列出多种原生与 ACP Agent,并说明不同 CLI 模式、身份提供方和远程使用条件。技能的触发描述具体,部分技能禁用模型自主调用。扣分原因:多种组件和 Agent 组合会带来配置与兼容性负担,片段未完整说明支持边界和平台差异。
README、AGENTS 和安全策略提供了分层目录、安装与开发入口、组件说明、操作示例、安全报告渠道及支持版本政策;LICENSE 明确为 AGPL-3.0。扣分原因:提供的版本信息和变更历史不足,维护责任只通过社区渠道和安全邮箱间接体现;部分文档描述与实现是否持续同步无法由片段确认。
产品把多个编码 Agent、工作区、会话、任务和自动化汇集到桌面、手机及 CLI,技能说明也给出结构化输出格式和可执行流程,能支持实际协作操作。扣分原因:自行托管需运行数据库、后端、服务端和客户端,且需要安装并登录至少一个外部 Agent CLI;来源未提供成本或资源消耗的量化信息。
README 的产品描述可与 AGENTS 的架构说明及后端、CLI 源码片段相互对照;安全和使用说明也包含具体行为约束。扣分原因:多个产品能力仍主要由文档声称,提供的代码和测试只是样本,无法核对所有关键路径;本评估将文档陈述与代码片段可直接支持的事实区分开,但没有执行验证。
- 启动会话、创建自动化及分享记录会产生真实外部影响;使用前核实目标机器、任务内容、时间表和分享受众。
- 自托管涉及多个服务和数据库;本评估仅依据提供的文件片段,未运行程序,也未核验所有依赖和安全实现。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
发布说明摘录
Bundles Vicoa CLI daemon [v1.10.1](https://www.npmjs.com/package/@vicoa/cli/v/1.10.1). 🚀 Features * AGENTS: don't name other products in PRs, commits or docs in https://github.com/vicoa-ai/vicoa/commit/8a029d8 * Dashboard plugin: Needs you lists the open questions on tasks; the plugin bridge reports openQuestions in https://github.com/vicoa-ai/vicoa/commit/8231f26 * Tasks: annotate text in a comment and send it in a reply in https://github.com/vicoa-ai/vicoa/pull/264 …在 GitHub 查看 ↗ -
发布说明摘录
Bundles Vicoa CLI daemon [v1.10.0](https://www.npmjs.com/package/@vicoa/cli/v/1.10.0). 🚀 Features * CLI: remove vicoa codex and the bundled Codex fork in https://github.com/vicoa-ai/vicoa/pull/255 * Keep earlier queued messages in the bar when a later one is steered in https://github.com/vicoa-ai/vicoa/pull/253 * Sessions: import sessions started outside Vicoa (Claude Code, Codex) in https://github.com/vicoa-ai/vicoa/pull/257 * Backend: index agent_instances.last_read_message_id so session deletes don't time out in https://github.com/vicoa-ai/vicoa/pull/256 …在 GitHub 查看 ↗ -
发布说明摘录
Bundles Vicoa CLI daemon [v1.9.18](https://www.npmjs.com/package/@vicoa/cli/v/1.9.18). 🚀 Features * Sessions: send to a closed or stopped session to resume it in https://github.com/vicoa-ai/vicoa/pull/250 * Web: keep AskUserQuestion answers in the transcript in https://github.com/vicoa-ai/vicoa/pull/249 * AskUserQuestion: keep the answer in the transcript when the session reads active in https://github.com/vicoa-ai/vicoa/pull/239 * Daemon collision check knows which server each daemon belongs to in https://github.com/vicoa-ai/vicoa/pull/246 …在 GitHub 查看 ↗
常见问题
我需要付钱吗?
我的代码和数据会经过 Vicoa 的服务器吗?
支持哪些代理?怎么接入新的?
多个代理改同一个仓库会冲突吗?
不用手机可以用吗?
Vicoa 官网是什么?
Vicoa 免费吗?
Vicoa 开源吗?
Vicoa 安全吗?
Vicoa 还在维护吗?
Vicoa 是谁开发的?
谢谢反馈,我们会据此改进页面。