Vicoa

开源 AI 编排器:在桌面、手机或 VPS 上指挥一支编程代理团队,会话随处同步,支持自托管。

Star 数
★ 544
最近更新
1 天前
License
AGPL-3.0
主语言
Python

30 秒速览

运行形态
桌面应用命令行工具自托管服务
可在哪里用
通用 · 跨平台Codex · Claude Code
费用
软件免费,模型调用费用自付
上手难度
中 · 需要几步配置
开始前需要
Node.js 18+(CLI)Docker(自托管)PostgreSQL(自托管后端)至少一个受支持的 agent CLI(如 claude、codex、opencode)Python 3.10+(后端,或 pip install vicoa)Flutter(移动端开发)Shell / 命令行网络访问本地文件系统
典型场景
白天在桌面启动多个代理并行改造同一个仓库的工程师,下班后在手机上继续审批 diff、回答代理的提问
不适合
  • 希望单一厂商托管、无需自备模型订阅或 API key 的用户
  • 不想自己部署后端和数据库、也接受不了账号云同步的团队
  • 只需要一个纯聊天式代码助手的开发者
官网
vicoa.ai ↗ 来自 GitHub 仓库设置
维护状态
近 30 天有提交最近提交 2026-11-20最新版本 v0.2.1(2026-11-20)近 7 天每天 +0.6 ★

这个 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> 添加。

  1. 白天在桌面启动多个代理并行改造同一个仓库的工程师,下班后在手机上继续审批 diff、回答代理的提问
  2. 在多台机器(Mac、Windows、Linux、VPS)上有代码的开发者,想从一个界面选择会话在哪台机器上运行
  3. 需要同时评估 Claude Code、Codex、OpenCode、Gemini 等多个代理效果的团队,想在同一工作区并排运行对比
  4. 想用 cron 定时让代理自动认领看板任务并完成的维护者(Automations + 任务管理)
  5. 希望把整套编排栈部署在自己基础设施上(Docker + Postgres)、数据不经第三方托管的团队
  6. 想让 CLI 中的代理反向驱动 Vicoa(启动会话、查询任务和自动化)的自动化玩家

安装与配置要点

摘自下方的安装和使用说明,以项目 README 的最新说明为准。

安装 / 启动命令
  • npm i -g @vicoa/cli
  • pip install vicoa
配置文件
.env.example .env docker-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/cli

vicoa

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?

  1. 安装并登录 Vicoa Desktop。
  2. 点击 New Session,选择机器、代理(如 claude、codex),输入第一条提示词。
  3. 在手机安装 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?

FollowAgents 源码审查 · FARS-2.1
存在缺口
67/ 100 五分制 3.4 / 5
本评测基于 2026年11月7日 的源码;此后该项目发布了 6 个正式版本,尚未复审。分数与结论只代表评测时的版本。 最近版本 ↓
信任安全 14/29
可靠稳定 8/14
适用触发 16/18
规范维护 12/18
有效结果 12/13
证据核验 5/8
查看各维度的扣分理由
信任安全14 / 29 · 2.4/5

文档说明 CLI 使用用户自己的 Agent 凭据,并为任务变更、分享会话、创建自动化和启动会话规定先检查或确认;分享链接可能向持有链接者公开记录,自动化会启动真实会话。文档还描述 API key 哈希存储、撤销检查和私下报告安全问题。扣分原因:Vicoa 会代表用户启动代码代理和定时任务,权限范围及其对代码的访问较广;所给源代码片段未展示各操作完整的授权、密钥存储或恢复实现,也没有明确的来源归属细节。

可靠稳定8 / 14 · 2.9/5

两个服务入口都描述了各自的职责和关闭流程;后端对数据库断连返回可重试的 503,CLI 在更新检查失败时采用尽力而为处理,SSE 错误有日志。测试片段体现了数据库事务隔离和访问控制语义。扣分原因:依赖清单、可用性策略及完整故障处理路径未提供;测试片段不能证明运行结果。

适用触发16 / 18 · 4.4/5

产品面向跨桌面、移动、远程机器和自托管场景,列出多种原生与 ACP Agent,并说明不同 CLI 模式、身份提供方和远程使用条件。技能的触发描述具体,部分技能禁用模型自主调用。扣分原因:多种组件和 Agent 组合会带来配置与兼容性负担,片段未完整说明支持边界和平台差异。

规范维护12 / 18 · 3.3/5

README、AGENTS 和安全策略提供了分层目录、安装与开发入口、组件说明、操作示例、安全报告渠道及支持版本政策;LICENSE 明确为 AGPL-3.0。扣分原因:提供的版本信息和变更历史不足,维护责任只通过社区渠道和安全邮箱间接体现;部分文档描述与实现是否持续同步无法由片段确认。

有效结果12 / 13 · 4.6/5

产品把多个编码 Agent、工作区、会话、任务和自动化汇集到桌面、手机及 CLI,技能说明也给出结构化输出格式和可执行流程,能支持实际协作操作。扣分原因:自行托管需运行数据库、后端、服务端和客户端,且需要安装并登录至少一个外部 Agent CLI;来源未提供成本或资源消耗的量化信息。

证据核验5 / 8 · 3.1/5

README 的产品描述可与 AGENTS 的架构说明及后端、CLI 源码片段相互对照;安全和使用说明也包含具体行为约束。扣分原因:多个产品能力仍主要由文档声称,提供的代码和测试只是样本,无法核对所有关键路径;本评估将文档陈述与代码片段可直接支持的事实区分开,但没有执行验证。

风险与缓解建议
  • 启动会话、创建自动化及分享记录会产生真实外部影响;使用前核实目标机器、任务内容、时间表和分享受众。
  • 自托管涉及多个服务和数据库;本评估仅依据提供的文件片段,未运行程序,也未核验所有依赖和安全实现。
证据充分度:低 评估于 2026年11月7日 审查版本 e7d584606bb9 评估后仓库已有新提交,评分可能未覆盖最新改动
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

徽章显示当前的评审分数和结论,点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/vicoa.svg?lang=zh)](https://followagents.com/zh/agents/vicoa)
<a href="https://followagents.com/zh/agents/vicoa"><img src="https://followagents.com/badge/vicoa.svg?lang=zh" alt="FARS 评测"></a>

最近版本

来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。

  1. v0.2.1
    发布说明摘录
    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 查看 ↗
  2. v0.2.0
    发布说明摘录
    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 查看 ↗
  3. v0.1.46
    发布说明摘录
    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 软件本身开源(AGPLv3)免费,自托管也不收费;但代理需要各自的订阅或 API key(BYO-key),这部分使用成本由你承担。
我的代码和数据会经过 Vicoa 的服务器吗?
使用官方后端时会话和消息通过其 API/实时服务器同步;你也可以用 Docker 自托管整套后端(FastAPI + PostgreSQL),把数据留在自己的基础设施上。
支持哪些代理?怎么接入新的?
内置 Claude Code、Codex、OpenCode、Gemini、Cursor、GitHub Copilot、Kimi、Hermes、Pi、Oh My Pi、Antigravity 等,Claude Code、Codex、Pi、Oh My Pi、Antigravity 为原生集成;其余通过 ACP 连接,任何说 ACP 的代理都能用自定义启动命令接入。
多个代理改同一个仓库会冲突吗?
不会——每个代理运行在自己的 git worktree 和分支上,多个代理可同时处理同一仓库而互不干扰。
不用手机可以用吗?
可以。Vicoa 提供 macOS/Windows/Linux 桌面端、Web 界面和 CLI,移动端只是可选的多设备入口。
Vicoa 官网是什么?
Vicoa 的 GitHub 仓库填写的官网是 https://vicoa.ai。这个链接由仓库作者设置;源码在 GitHub(vicoa-ai/vicoa)。
Vicoa 免费吗?
软件本身免费,但 Vicoa 要调用 AI 模型,模型的调用费用由你向模型服务商支付(也可以接本地模型)。
Vicoa 开源吗?
开源。源码在 GitHub(vicoa-ai/vicoa),许可证是 AGPL-3.0。AGPL-3.0 是传染性(copyleft)许可证,而且覆盖网络使用:把修改后的版本作为服务提供给别人用,也要向用户提供源码。
Vicoa 安全吗?
FollowAgents 的 FARS 评审(2026年11月7日)给 Vicoa 的“信任与安全”打了 14/29 分。评审检查的 8 项安全措施没有完全缺失的。评审之后仓库已有更新。
Vicoa 还在维护吗?
在维护。GitHub 上最近一次提交是 2026-11-20,在最近 30 天内。最新版本是 v0.2.1(2026-11-20)。
Vicoa 是谁开发的?
Vicoa 由 GitHub 账号 vicoa-ai 发布。FollowAgents 没有核实这个账号背后是哪个人或公司。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

所属宿主生态

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关核心概念