What do you want to do?
4 use cases
-
Run several coding agents on one repo at once
Start multiple agents on separate git worktrees so they can edit the same project without conflicts.
- Vicoa
- Claude Code
- Codex
- Cursor
- Gemini CLI
- Software and DevOps
- Intermediate
View prompt
Using the vicoa-ai/vicoa repo, set up three coding sessions on <target-repo>, each with a different task and agent (Claude Code, Codex, and Cursor). Confirm that each session runs on its own git worktree and branch and that all three appear in the Vicoa session list. Report the session names and their status.
-
Check and prompt running agents from your phone
Start a session on your laptop, then follow and prompt it from the Vicoa mobile app.
- Vicoa
- Claude Code
- Codex
- Cursor
- Gemini CLI
- Software and DevOps
- Intermediate
View prompt
Using the vicoa-ai/vicoa repo, start a coding session on <target-project> with the Claude Code agent and a prompt to <task>. Confirm the session appears in the Vicoa mobile app under the same account and that a notification arrives when the agent asks a question or finishes. Report the session status seen on the phone.
-
Run coding agents on a VPS or remote server
Connect a remote Linux machine so agents run there while you start them from your desktop or phone.
View prompt
Using the vicoa-ai/vicoa repo, connect the VPS at <server-address> as a Vicoa machine and start a Codex session on <remote-project-path>. Confirm the VPS appears as a machine option and the session starts there. Report the machine name and session status.
-
Self-host the full Vicoa stack with Docker
Run the Vicoa backend, web app, and database on your own infrastructure using Docker.
- Vicoa
- Software and DevOps
- Advanced
View prompt
Using the vicoa-ai/vicoa repo, self-host the Vicoa stack on <server-address> by following SELF_HOSTING.md. Confirm that the Docker containers started with `docker compose -f docker-compose.selfhost.yml ps` and that the web app loads at the URL you set. Report the running services and the URL.
How to use Vicoa
- Check you have what it needs: At least one supported agent CLI installed and signed in on the machine that runs agents; A Vicoa account for the desktop and mobile apps; Node.js 18+ for the npm CLI, or pip on Intel Macs or old glibc systems.
- Open vicoa-ai/vicoa on GitHub and read the README and license.
- Install and sign in to each agent CLI you plan to use, for example
claude,codex, orcursor-agent. - Install the Vicoa CLI with
npm i -g @vicoa/cli. - Open Vicoa Desktop, click **New Session**, pick the machine, pick an agent, and enter the first prompt for that task.
- Repeat the New Session step for each agent and task, choosing a different agent or prompt each time.
These steps come from our top use case, Run several coding agents on one repo at once, which also has a copy-paste agent prompt.
Get 5 new use cases every morning. Free, one short email, unsubscribe anytime.
Get them freeAbout this repo
- Who it is forDevelopers who already use coding agents like Claude Code or Codex and want to run several of them at once and check on them from a phone.
- Why it is hot
- LanguagePython
- Sourcegithub.com/vicoa-ai/vicoa · Back to Hot repos
Requirements
- At least one supported agent CLI installed and signed in on the machine that runs agents
- A Vicoa account for the desktop and mobile apps
- Node.js 18+ for the npm CLI, or pip on Intel Macs or old glibc systems
Maintain Vicoa? Add the Featured on Deduped badge
Paste this into your README:
[](https://dedupedai.com/use-cases/vicoa-ai-vicoa/?ref=badge)
Questions about Vicoa
What is Vicoa?
Vicoa is an open-source orchestrator that runs a team of coding agents from desktop, mobile, and remote machines, and can be self-hosted. It is an open-source project on GitHub: https://github.com/vicoa-ai/vicoa.
Who is Vicoa for?
Developers who already use coding agents like Claude Code or Codex and want to run several of them at once and check on them from a phone.
What can I do with Vicoa?
4 use cases so far, for example: Run several coding agents on one repo at once; Check and prompt running agents from your phone; Run coding agents on a VPS or remote server. Each has steps and a copy-paste agent prompt.
What do I need to run Vicoa?
At least one supported agent CLI installed and signed in on the machine that runs agents; A Vicoa account for the desktop and mobile apps; Node.js 18+ for the npm CLI, or pip on Intel Macs or old glibc systems.
What are alternatives to Vicoa?
Other hot AI repos in Software and DevOps: Harness2, iFixAi, Orca, Diagram Design, AI Memory.
Is Vicoa safe to run?
Deduped does not own, audit or vouch for it. Read the README and license, run it on your own systems first and review every command before you run it.