<div align="center">
  <img src="https://vicoa.ai/images/vicoa-light.webp" alt="Vicoa Logo" width="50" height="50">
  <h1>Vicoa - Vibe Code Anywhere</h1>
</div>

Vicoa is a platform that allows you to run a team of coding agents (Claude Code, Codex, and OpenCode) anywhere, on any device. Remote control your AI agents from your phone or tablet.

<div align="center">
  <img src="https://vicoa.ai/images/hero.webp" alt="Vicoa AI Apps">
</div>

<div align="center">
  <a href="https://vicoa.ai">🌐 Website</a> |
  <a href="https://apps.apple.com/app/id6751626168">📱 iOS App</a> |
  <a href="https://play.google.com/store/apps/details?id=app.vicoa">📱 Android App</a> |
  <a href="https://www.youtube.com/watch?v=iserdZx5yBs">🎥 Demo</a>
</div>

## CLI Installation

```bash
# Run directly with npx
npx @vicoa/cli

# Or install globally
npm install -g @vicoa/cli

# Then run
vicoa
```

## Usage

```bash
# Start Claude Code
vicoa

# Start Codex
vicoa codex

# Start OpenCode
vicoa opencode

# Run headless (controlled via web dashboard)
vicoa headless

# Authenticate
vicoa --auth

# Show version
vicoa --version
```

## Key Features

- 💻 **Cross-platform vibe coding** - Start on desktop, continue on mobile
- 📱 **Mobile-first design** - Full coding experience on phones and tablets
- 🔔 **Smart notifications** - Get alerts when your AI agent needs input
- 🤖 **Original Vibe Coding Experience** - Vibe coding with normal Claude Code and Codex sessions
- 🎯 **Seamless workflow** - Pick up exactly where you left off

## Demo Video

<a href="https://www.youtube.com/watch?v=iserdZx5yBs" target="_blank">
  <img src="https://img.youtube.com/vi/ZBpNzqqLYmg/maxresdefault.jpg" alt="Vicoa Introduction | Demo Video">
</a>

## Requirements

- Node.js 16+
- macOS (Apple Silicon), Linux (x64), or Windows (x64)

## Connect With Us

- 📧 **Email**: hi@vicoa.ai
- 🐦 **Twitter**: [@vicoaai](https://x.com/vicoaai)
- 💼 **LinkedIn**: [Vicoa](https://linkedin.com/company/vicoa)
- 🌐 **Website**: [vicoa.ai](https://vicoa.ai)

## License

Apache 2.0
