Vicoa

这个 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（启动会话、查询任务和自动化）的自动化玩家

如何安装或部署这个 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 有哪些优点和局限？

这个 Agent 与同类方案有什么区别？

与相关度最高的同类 agent 并排比较关键指标。

FollowAgents 如何评估这个 Agent？

常见问题