vicoa: Coordinate Coding Agents Across Devices

Overview

Vicoa coordinates coding-agent sessions across machines and devices. Instead of managing separate terminal sessions, developers can start agents on a computer or VPS, track their work centrally, and steer sessions from desktop, web, CLI, or mobile clients.

It is aimed at people who already use coding-agent CLIs and want to run several in parallel, including in separate Git worktrees. The project includes a local daemon, backend, and client applications, and can be self-hosted. Agents and model access are BYO-key: Vicoa launches tools installed and authenticated by the user.

Key Features

• Runs multiple coding-agent sessions side by side, with each agent able to use its own Git worktree and branch.
• Connects local computers, remote machines, and VPS instances so sessions can run where the code resides.
• Provides desktop, web, iOS, Android, and CLI ways to monitor and interact with sessions.
• Supports built-in agent integrations and additional agents through the Agent Client Protocol (ACP).
• Includes conversation views, per-file diffs, commit history, a file browser, and an adjacent terminal.
• Offers task boards and scheduled automations for starting and managing work.
• Supports self-hosting the backend stack with Docker and PostgreSQL.

Use Cases

• A developer running several coding agents on one repository can keep their sessions separate with parallel worktrees and monitor them from one place.
• A developer working on a remote server or VPS can run agents near the code and steer their sessions from another device.
• A team or individual who wants an agent command center across desktop and mobile can review progress and respond to agent requests away from their workstation.
• A self-hosting user can run Vicoa's backend on their own infrastructure while using their existing agent installations and credentials.

Getting Started

Install the CLI with Node.js 18 or newer, then launch it:

npm i -g @vicoa/cli
vicoa

The machine running agents needs at least one supported agent CLI installed and signed in. See the README for desktop setup, self-hosting, and development instructions.

Alternatives

• OpenHands: OpenHands centers on agent conversations and recurring automations across local, remote, and cloud backends, while Vicoa also offers task management and desktop, web, mobile, and CLI clients.
• orca: Orca focuses on side-by-side agents in isolated Git worktrees through desktop and mobile apps, while Vicoa spans more clients and includes task management and review tools.
• agent-orchestrator: Agent Orchestrator centers on Git-backed tasks, isolated worktrees, and pull request and CI activity in a desktop workspace; Vicoa also targets web, mobile, and CLI use.
• multica: Multica organizes agent runs and reviews around assigned issues and team workflows, while Vicoa provides a broader command center across desktop, web, mobile, and CLI.

Considerations

• Vicoa does not replace or provide the coding agents or model access. Install and authenticate a supported agent CLI on each machine that will run agents, and bring your own subscription or API keys.
• Remote use requires connecting the machines where agents will run. Self-hosting also involves configuring environment variables and JWT keys, and running the backend stack with Docker.
• The repository is licensed under AGPL-3.0, which is relevant when modifying or distributing the software or offering it as a network service.