Vicoa
Vicoa is an open-source AI orchestrator that runs a team of coding agents (Claude Code, Codex, Cursor, etc.) from any device. It solves the problem of managing multiple coding agents across different machines by providing a unified command center, parallel worktrees, and mobile access. It is for developers who want to coordinate multiple AI coding agents on their projects from desktop or mobile.
✨ Key features
- Run multiple coding agents side by side in one workspace.
- Parallel worktrees: each agent on its own git branch.
- One command center to monitor all sessions.
- Connect any machine: Mac, Windows, Linux, VPS.
- Native iOS and Android apps with notifications.
- Self-hostable with Docker and PostgreSQL.
🎯 Use cases
- Orchestrate a team of coding agents on a single repo.
- Start a session on desktop, continue from phone.
- Automate tasks with cron schedules.
- Self-host the entire stack on your own infrastructure.
📦 Installation
🧰 Requirements: Requires Node.js 18+ for CLI (or Python for older systems) and at least one supported agent CLI installed and signed in on the machine running agents.
npm i -g @vicoa/cli # Node.js 18+; on Intel Macs or old glibc, use: pip install vicoa
vicoa # start a session, or `vicoa daemon` to just connect this machine
🚀 Usage
vicoavicoa daemon⚠️ Good to know
The machine that runs agents needs at least one supported agent CLI installed and signed in; Claude Code and Codex have native integrations, others use ACP.
❓ FAQ
What coding agents does Vicoa support?
It supports Claude Code, Codex, OpenCode, Gemini, Cursor, GitHub Copilot, Kimi, and Hermes. Claude Code and Codex have native integrations; the rest connect over the Agent Client Protocol (ACP).
Can I use Vicoa from my mobile phone?
Yes, Vicoa offers iOS and Android apps that sync sessions automatically, allow you to prompt agents, and send notifications when an agent needs a decision or finishes.
Is Vicoa self-hostable?
Yes, the entire stack is open source and can be self-hosted with Docker and PostgreSQL. See SELF_HOSTING.md for instructions.
Do I need to bring my own API keys?
Yes, Vicoa is BYO-key: you use your existing subscriptions or API keys for the coding agents.
📊 Repository
🤖 Overview, features, install steps and FAQ were generated from the project's README on Sep 4, 2026. Always check the original source before running commands.