Skip to content
Back to search

vicoa

Vicoa is the agentic IDE for running a team of coding agents from desktop, mobile, VPS. Open-source, self-hostable.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/vicoa-ai/vicoa with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/vicoa-ai/vicoa'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/vicoa-ai--vicoa/badge.svg)](/listings/vicoa-ai--vicoa)

HTML

<a href="/listings/vicoa-ai--vicoa"><img src="/api/listings/vicoa-ai--vicoa/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 240 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <div align="center">
  2. <h1 align="center">
  3. <img src="apps/web/public/images/vicoa-logo-small.webp" alt="Vicoa" height="60" valign="middle" /> Vicoa
  4. </h1>
  5. <p align="center">
  6. <a href="https://vicoa.ai"><img src="https://img.shields.io/badge/Website-vicoa.ai-4493F8" alt="Vicoa website" /></a>
  7. <img src="https://img.shields.io/badge/Desktop%20%26%20CLI-macOS%20%7C%20Windows%20%7C%20Linux-4493F8?style=flat-square" alt="Desktop and CLI on macOS, Windows and Linux" />
  8. <img src="https://img.shields.io/badge/Mobile-iOS%20%7C%20Android-4493F8?style=flat-square" alt="Mobile apps for iOS and Android" />
  9. <a href="https://discord.gg/mqz4qRPV4j"><img src="https://img.shields.io/badge/Discord-5865F2?logo=discord&logoColor=white" alt="Join the Vicoa Discord" /></a>
  10. <a href="https://x.com/vicoaai"><img src="https://img.shields.io/badge/X-000000?logo=x&logoColor=white" alt="Follow Vicoa on X" /></a>
  11. </p>
  12. **English | [简体中文](./README.zh.md)**
  13. Vicoa is an open-source **AI orchestrator** for running a team of coding agents from any device.
  14. <h3 align="center"><a href="https://vicoa.ai/download"><ins>Download Vicoa</ins></a></h3>
  15. </div>
  16. <p align="center">
  17. <img src="apps/web/public/images/hero3.webp" alt="The Vicoa desktop app running several agent sessions, with the same sessions open on a phone" width="100%">
  18. </p>
  19. <p align="center">
  20. <sub><em>Start at your desk. Steer from your pocket.</em></sub>
  21. </p>
  22. ---
  23. ## Run a team of coding agents
  24. *Claude Code, Codex, Cursor, Pi, Kimi, and more*
  25. - **[Supported Agents](#supported-agents):** 40+ coding agents. Claude Code, Codex, OpenCode, Gemini, Cursor, GitHub Copilot, Kimi, Hermes, Pi, Oh My Pi, and Antigravity are built in; 30+ more (Cline, goose, Kiro, Qwen Code, TRAE, …) are supported via ACP. Run them side by side in one workspace
  26. - **Parallel worktrees:** each agent on its own git worktree and branch, so several can work the same repo at once without stepping on each other.
  27. - **One command center:** every session's status in a single list, so you steer the whole fleet from one place instead of hunting terminal tabs.
  28. - **[Any machine](https://vicoa.ai/docs/start-remote-session):** your Mac, a Windows laptop, a Linux machine, a VPS, a remote server: connect them all and pick where each session runs.
  29. - **[Bring your own key](https://vicoa.ai/docs/alternative-models):** your existing subscription or API keys
  30. ## Steer from any device.
  31. *The session you started on your laptop, in your pocket.*
  32. - **[iOS and Android apps](https://vicoa.ai/download):** the same session on a native mobile apps
  33. - **Notifications:** get notified when an agent needs a decision or finishes
  34. - **Vibe code anywhere:** prompt your coding agents on your project from your phone, all sessons are synced
  35. - **[@files and /commands](https://vicoa.ai/docs/vicoa-features):** fuzzy file mentions and the agent's own slash commands work from web, mobile and CLI alike
  36. - **[Dictation](https://vicoa.ai/docs/vicoa-features#talk-to-code-dictation):** talk to your coding agents
  37. <p align="center">
  38. <img src="apps/web/public/images/mobile-cockpit.webp" alt="Four Vicoa mobile screens: agent sessions grouped by project, a chat with a coding agent, a git diff review, and lock-screen push notifications" width="100%">
  39. </p>
  40. <p align="center">
  41. <sub><em>A real mobile coding app, not a chat tab: sessions, conversation, live git diffs, and push notifications.</em></sub>
  42. </p>
  43. ## More Features
  44. - **Inline diffs:** per-file changes and commit history, reviewable on a desktop and phone
  45. - **File browser:** the tree beside the conversation
  46. - **Terminal:** run commands next to the chat.
  47. - **[Mobile Live preview](https://vicoa.ai/docs/live-preview):** open a local dev website and preview it from your phone in desktop mode.
  48. - **Task management:** plan work on a board, then start a session straight from a task, or let agent pick up automatically with automations.
  49. - **[Automations](https://vicoa.ai/docs/cli-commands#vicoa-automation):** cron schedules get things done on their own
  50. - **Skills:** view, install and remove the agent skills.
  51. - **[CLI](https://vicoa.ai/docs/cli-commands):** sessions, chat history, tasks, and automations are supported via CLI, so your agents can drive Vicoa the same way you do.
  52. - and more ...
  53. ---
  54. ## Get started
  55. Download
  56. **[Vicoa Desktop](https://vicoa.ai/download)** for macOS, Windows, or Linux. It connects the computer
  57. it runs on and detects installed agents.
  58. The one prerequisite: the machine that runs agents needs at least one
  59. [supported agent CLI](#supported-agents) installed and signed in.
  60. Prefer the terminal?
  61. ```bash
  62. npm i -g @vicoa/cli # Node.js 18+; on Intel Macs or old glibc, use: pip install vicoa
  63. vicoa # start a session, or `vicoa daemon` to just connect this machine
  64. ```
  65. ## Your first session in three minutes
  66. **1. Install and sign in.** Open [Vicoa Desktop](https://vicoa.ai/download) and sign in.
  67. **2. Start some agents.** Click **New Session**, pick the machine, the agent, and enter your first prompt.
  68. **3. Steer from your phone.** Install the Vicoa mobile app and sign in with the same account — running sessions sync automatically.
  69. <p align="center">
  70. <a href="https://apps.apple.com/app/id6751626168"><img src="https://toolbox.marketingtools.apple.com/api/v2/badges/download-on-the-app-store/black/en-us" alt="Download on the App Store" height="40" align="middle"></a>
  71. &nbsp;
  72. <a href="https://play.google.com/store/apps/details?id=ai.vicoa"><img src="https://play.google.com/intl/en_us/badges/static/images/badges/en_badge_web_generic.png" alt="Get it on Google Play" height="59" align="middle"></a>
  73. </p>
  74. Full walkthrough: [Set up Vicoa](https://vicoa.ai/docs/getting-started) ·
  75. [Start a remote session](https://vicoa.ai/docs/start-remote-session)
  76. ## Supported agents
  77. Vicoa launches the agent harness and CLIs you already have installed and
  78. authenticated, on your machine, with your credentials.
  79. | Agent | CLI | Agent | CLI |
  80. | --- | --- | --- | --- |
  81. | [Claude Code](https://vicoa.ai/docs/agents/claude-code) | `claude` | [Cursor](https://vicoa.ai/docs/agents/more-coding-agents) | `cursor-agent` |
  82. | [Codex](https://vicoa.ai/docs/agents/codex) | `codex` | [GitHub Copilot](https://vicoa.ai/docs/agents/more-coding-agents) | `copilot` |
  83. | [OpenCode](https://vicoa.ai/docs/agents/opencode) | `opencode` | [Kimi](https://vicoa.ai/docs/agents/more-coding-agents) | `kimi` |
  84. | [Gemini](https://vicoa.ai/docs/agents/more-coding-agents) | `gemini` | [Hermes](https://vicoa.ai/docs/agents/more-coding-agents) | `hermes` |
  85. | [Pi](https://vicoa.ai/docs/agents/more-coding-agents) | `pi` | [Oh My Pi](https://vicoa.ai/docs/agents/more-coding-agents) | `omp` |
  86. | [Antigravity](https://vicoa.ai/docs/agents/more-coding-agents) | `agy` | | |
  87. Claude Code, Codex, Pi, Oh My Pi, and Antigravity have native integrations; the rest connect
  88. over the Agent Client Protocol (ACP).
  89. **30+ more via ACP.** Amp, Auggie, Cline, Devin, Factory Droid, goose, Grok, Junie, Kilo,
  90. Kiro, Mistral Vibe, Qwen Code, TRAE, and other ACP agents are in the built-in catalog: add
  91. one from **Settings → Providers → More agents** or `vicoa provider add <id>`. Any other
  92. agent that speaks ACP works with your own launch command. See
  93. [custom agents](https://vicoa.ai/docs/agents/custom-agents).
  94. ## Documentation
  95. - **[CLI commands](https://vicoa.ai/docs/cli-commands)** — drive vicoa sessions, tasks, and automations from the terminal.
  96. - **[Self-hosting](./SELF_HOSTING.md)** — run the whole stack on your own infrastructure with Docker.
  97. - **[Getting started](https://vicoa.ai/docs/getting-started)** — install, sign in, and run your first session.
  98. - **[Supported agents](https://vicoa.ai/docs/agents)** — set up Claude Code, Codex, and the rest.
  99. - **[Some Features](https://vicoa.ai/docs/vicoa-features)** — feature introduction
  100. - **[Full documentation →](https://vicoa.ai/docs)**
  101. ## What's in this repository
  102. This is **Vicoa, open source**: the complete, self-hostable stack:
  103. - **CLI and local daemon:** starts and runs coding agents on a machine
  104. - **Backend:** backend API and realtime server for auth, sessions, messages, tasks,
  105. automations. Self-hostable with Postgres.
  106. - **Clients:** web app, desktop app, mobile app (iOS / Android).
  107. Vicoa is **BYO-key**: you bring your own agent and model subscriptions or API keys
  108. ## Self-hosting
  109. Run the whole stack yourself with Docker:
  110. ```bash
  111. cp .env.example .env # passwords and public URLs
  112. ./backend/scripts/generate-jwt-keys.sh selfhost/keys
  113. docker compose -f docker-compose.selfhost.yml up -d
  114. ```
  115. The full walkthrough is in **[SELF_HOSTING.md](./SELF_HOSTING.md)**.
  116. ## Architecture
  117. ```
  118. Web · Desktop (macOS/Windows) · iOS · Android · CLI
  119. │
  120. ▼
  121. ┌──────────────┐ ┌────────────────┐ ┌──────────────────┐
  122. │ Next.js │──>│ FastAPI │──>│ PostgreSQL │
  123. │ dashboard │<──│ backend + WS │<──│ │
  124. └──────────────┘ └───────┬────────┘ └──────────────────┘
  125. │ sessions and messages over WebSocket
  126. ┌───────┴───────┐
  127. │ vicoa daemon │ runs on your machine, next to your code
  128. └───────┬───────┘
  129. │ spawns
  130. ┌───────┴─────────────────────────────────┐
  131. │ Claude Code · Codex · OpenCode · Gemini │
  132. │ Cursor · Copilot · Kimi · Hermes │
  133. │ Pi · Oh My Pi · Antigravity │
  134. │ + 30 more ACP agents │
  135. └─────────────────────────────────────────┘
  136. ```
  137. | Layer | Stack |
  138. | --- | --- |
  139. | Web | Next.js 15 + React 19, shadcn/ui, Fumadocs for the docs |
  140. | Desktop | Electron, running the web UI and supervising a bundled daemon |
  141. | Mobile | Flutter (iOS / Android) |
  142. | Backend | Python 3.10+ / FastAPI: a user-facing REST API, plus an agent-facing REST + WebSocket server |
  143. | Database | PostgreSQL via SQLAlchemy and Alembic |
  144. | Agent runtime | The local `vicoa` daemon, spawning any of the agent CLIs above |
  145. ## Development
  146. Start with the **[Contributing.md](./CONTRIBUTING.md)**.
  147. Quick repository layout:
  148. ```
  149. vicoa/
  150. ├── backend/ # Python: FastAPI backend + REST servers + CLI & daemon
  151. │ └── vicoa/ # the `vicoa` CLI and the local daemon
  152. ├── apps/
  153. │ ├── web/ # Next.js dashboard (also the desktop renderer) + docs
  154. │ ├── desktop/ # Electron desktop app
  155. │ └── mobile/ # Flutter app (iOS / Android)
  156. ```
  157. Common commands:
  158. ```bash
  159. # backend, CLI and daemon (Python)
  160. cd backend
  161. make dev-install
  162. ./dev-start.sh
  163. make lint && make test
  164. # web and docs (Next.js)
  165. cd apps/web && pnpm install && pnpm dev
  166. # desktop app (Electron); see apps/desktop/README.md
  167. cd apps/desktop && pnpm install && pnpm dev
  168. # mobile app (Flutter)
  169. cd apps/mobile && flutter pub get && flutter run
  170. ```
  171. ## Community & Support
  172. - **Discord:** Join the community on **[Discord](https://discord.gg/mqz4qRPV4j)** for help and discussion.
  173. - **Twitter / X:** Follow **[@vicoaai](https://x.com/vicoaai)** for updates and announcements.
  174. - **Feedback & ideas:** We ship fast. Missing something? [Request a feature](https://github.com/vicoa-ai/vicoa/issues), include your platform, versions, and a reproduction (see [CONTRIBUTING.md](./CONTRIBUTING.md)).
  175. - **Security issues:** don't file a public issue; follow [SECURITY.md](./SECURITY.md).
  176. - **Show support:** [Star](https://github.com/vicoa-ai/vicoa) this repo to follow along with our daily ships.
  177. ## License
  178. Vicoa is open source under [AGPLv3](./LICENSE) license.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.