vicoa README

The project's README from github.com/vicoa-ai/vicoa. As one markdown file: README.md.

Vicoa Vicoa

Vicoa website Desktop and CLI on macOS, Windows and Linux Mobile apps for iOS and Android Join the Vicoa Discord Follow Vicoa on X

English | 简体中文

Vicoa is an open-source AI orchestrator for running a team of coding agents from any device.

Download Vicoa

The Vicoa desktop app running several agent sessions, with the same sessions open on a phone

Start at your desk. Steer from your pocket.

Run a team of coding agents

Claude Code, Codex, Cursor, Pi, Kimi, and more

Steer from any device.

The session you started on your laptop, in your pocket.

Four Vicoa mobile screens: agent sessions grouped by project, a chat with a coding agent, a git diff review, and lock-screen push notifications

A real mobile coding app, not a chat tab: sessions, conversation, live git diffs, and push notifications.

More Features

Get started

Download Vicoa Desktop for macOS, Windows, or Linux. It connects the computer it runs on and detects installed agents.

The one prerequisite: the machine that runs agents needs at least one supported agent CLI installed and signed in.

Prefer the terminal?

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

Your first session in three minutes

1. Install and sign in. Open Vicoa Desktop and sign in.

2. Start some agents. Click New Session, pick the machine, the agent, and enter your first prompt.

3. Steer from your phone. Install the Vicoa mobile app and sign in with the same account — running sessions sync automatically.

Download on the App Store   Get it on Google Play

Full walkthrough: Set up Vicoa · Start a remote session

Supported agents

Vicoa launches the agent harness and CLIs you already have installed and authenticated, on your machine, with your credentials.

Agent CLI Agent CLI
Claude Code claude Cursor cursor-agent
Codex codex GitHub Copilot copilot
OpenCode opencode Kimi kimi
Gemini gemini Hermes hermes
Pi pi Oh My Pi omp

Claude Code, Codex, Pi, and Oh My Pi have native integrations; the rest connect over the Agent Client Protocol (ACP).

Documentation

What's in this repository

This is Vicoa, open source: the complete, self-hostable stack:

Vicoa is BYO-key: you bring your own agent and model subscriptions or API keys

Self-hosting

Run the whole stack yourself with Docker:

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

The full walkthrough is in SELF_HOSTING.md.

Architecture

     Web  ·  Desktop (macOS/Windows)  ·  iOS  ·  Android  ·  CLI
                            │
                            ▼
  ┌──────────────┐   ┌────────────────┐   ┌──────────────────┐
  │   Next.js    │──>│    FastAPI     │──>│    PostgreSQL    │
  │  dashboard   │<──│  backend + WS  │<──│                  │
  └──────────────┘   └───────┬────────┘   └──────────────────┘
                             │  sessions and messages over WebSocket
                     ┌───────┴───────┐
                     │ vicoa daemon  │  runs on your machine, next to your code
                     └───────┬───────┘
                             │  spawns
                     ┌───────┴─────────────────────────────────┐
                     │ Claude Code · Codex · OpenCode · Gemini │
                     │ Cursor · Copilot · Kimi · Hermes        │
                     │ Pi · Oh My Pi                           │
                     └─────────────────────────────────────────┘
Layer Stack
Web Next.js 15 + React 19, shadcn/ui, Fumadocs for the docs
Desktop Electron, running the web UI and supervising a bundled daemon
Mobile Flutter (iOS / Android)
Backend Python 3.10+ / FastAPI: a user-facing REST API, plus an agent-facing REST + WebSocket server
Database PostgreSQL via SQLAlchemy and Alembic
Agent runtime The local vicoa daemon, spawning any of the agent CLIs above

Development

Start with the Contributing.md.

Quick repository layout:

vicoa/
├── backend/              # Python: FastAPI backend + REST servers + CLI & daemon
│       └── vicoa/        # the `vicoa` CLI and the local daemon
├── apps/
│   ├── web/              # Next.js dashboard (also the desktop renderer) + docs
│   ├── desktop/          # Electron desktop app
│   └── mobile/           # Flutter app (iOS / Android)

Common commands: 

# backend, CLI and daemon (Python)
cd backend 
make dev-install
./dev-start.sh

make lint && make test

# web and docs (Next.js)
cd apps/web && pnpm install && pnpm dev

# desktop app (Electron); see apps/desktop/README.md
cd apps/desktop && pnpm install && pnpm dev

# mobile app (Flutter)
cd apps/mobile && flutter pub get && flutter run

Community & Support

License

Vicoa is open source under AGPLv3 license.

vicoa (vicoa-ai/vicoa)

Searching Database…

518 ·GitHub
Vicoa
Что это?Vicoa — опенсорсный оркестратор ИИ, который позволяет запускать команду кодинг-агентов (Claude Code, Codex, Cursor и другие) и управлять ею с десктопа, телефона или VPS, с синхронизацией сессий между устройствами.
Это чат-приложение или оно реально запускает моих кодинг-агентов?Оно действительно запускает настоящие агентские CLI (claude, codex, cursor-agent и т. д.) на подконтрольной вам машине и даёт сессии, живые git-диффы, браузер файлов и push-уведомления, а не просто окно чата.
Как это запустить?Скачайте Vicoa Desktop для macOS, Windows или Linux; он сам обнаружит агентские CLI на этой машине. Затем нажмите New Session, выберите машину и агента и введите первый промпт; установите приложение для iOS/Android, чтобы продолжать вести ту же сессию с телефона.
Нужно ли, чтобы Claude Code или Codex уже были установлены?Да, Vicoa не поставляет собственную модель; он запускает агентские CLI, которые вы уже установили и в которых авторизовались на машине, например claude, codex, cursor-agent или opencode.
Vicoa включает собственную ИИ-модель или нужна своя подписка?Это BYO-key: Vicoa оркестрирует сессии, а подписки на агентов и модели или API-ключи вы предоставляете сами.
С каких устройств можно вести сессию?Сессию, начатую в десктоп-приложении для Mac/Windows/Linux, можно подхватить из приложения для iOS или Android либо из веб-клиента: запущенные сессии автоматически синхронизируются между устройствами, когда вы входите с одним аккаунтом.
Каких кодинг-агентов поддерживает Vicoa?Claude Code, Codex, OpenCode, Gemini, Cursor, GitHub Copilot, Kimi, Hermes, Pi и Oh My Pi могут работать бок о бок; у Claude Code, Codex, Pi и Oh My Pi есть нативные интеграции, остальные подключаются через Agent Client Protocol (ACP).
Почему каждый агент получает свой git worktree?Чтобы несколько агентов могли одновременно работать в одном репозитории, не мешая друг другу: каждая сессия выполняется в своём git worktree и своей ветке.
Что входит, если я сам размещаю весь стек?Полный стек: CLI плюс локальный демон, бэкенд на Python/FastAPI с PostgreSQL, а также веб-, десктопный Electron- и мобильный Flutter-клиенты, разворачиваемые с Docker, как описано в SELFHOSTING.md.
Что ещё можно делать, кроме чата с агентом?Ещё есть встроенные диффы файлов, браузер файлов, терминал внутри приложения, мобильный живой предпросмотр локального dev-сервера, доска задач и автоматизации на cron, чтобы агенты сами подхватывали работу.
What are similar projects?orca, paseo, claude_codex_bridge, Ghostex, oh-my-openagent, zuse, hapi, ordewell
Which topics is it in?ade, agent-client-protocol, git-worktrees, kimi, task-management, vibe-coding, hermes-agent, flutter, github-copilot, agplv3, fastapi, opencode
Creator
vicoa-ai
Size
49.9 MB
Stars
518
Updated
CommitOct 10Releasev0.1.38Oct 08
Age
1mo
Commits · 90 Days