vicoa-ai/vicoa

Vicoa는 모든 기기에서 코딩 에이전트 팀을 실행하기 위한 오픈 소스 AI 오케스트레이터입니다.

책상에서 시작하고, 주머니에서 조종하세요.

Claude Code, Codex, Cursor, Pi, Kimi 등

지원되는 에이전트: 40개 이상의 코딩 에이전트를 지원합니다. Claude Code, Codex, OpenCode, Gemini, Cursor, GitHub Copilot, Kimi, Hermes, Pi, Oh My Pi, Antigravity가 내장되어 있으며, ACP를 통해 30개 이상(Cline, goose, Kiro, Qwen Code, TRAE 등)을 지원합니다. 하나의 작업 공간에서 여러 에이전트를 나란히 실행하세요.
병렬 작업 트리: 각 에이전트는 자체 git 작업 트리와 브랜치에 존재하여, 여러 에이전트가 서로 간섭하지 않고 같은 리포지토리를 동시에 작업할 수 있습니다.
단일 명령 센터: 모든 세션의 상태를 단일 목록에서 확인할 수 있어, 터미널 탭을 여기저기 찾을 필요 없이 한 곳에서 전체 팀을 조종할 수 있습니다.
모든 기기: Mac, Windows 노트북, Linux 머신, VPS, 원격 서버 등 어떤 것과 연결하든 상관없습니다. 모든 것을 연결하고 각 세션이 어디서 실행될지 선택하세요.
자체 키 가져오기: 기존 구독 또는 API 키를 사용할 수 있습니다.

노트북에서 시작한 세션을 주머니에서도 계속합니다.

iOS 및 Android 앱: 네이티브 모바일 앱에서 동일한 세션을 경험할 수 있습니다.
알림: 에이전트의 결정이 필요하거나 작업이 완료되었을 때 알림을 받을 수 있습니다.
어디서든 코딩 분위기 조성 (Vibe code): 휴대폰으로 프로젝트의 코딩 에이전트에게 프롬프트를 보내고, 모든 세션이 동기화됩니다.
@files 및 /commands: 웹, 모바일, CLI에서 파일 언급(fuzzy file mentions)과 에이전트 자체 슬래시 커맨드가 작동합니다.
받아쓰기 (Dictation): 코딩 에이전트와 음성으로 대화할 수 있습니다.

단순한 채팅 탭이 아닌 실제 모바일 코딩 앱: 세션, 대화, 실시간 git diff, 푸시 알림을 제공합니다.

인라인 diff (Inline diffs): 파일별 변경 사항과 커밋 히스토리를 데스크톱과 휴대폰에서 검토할 수 있습니다. 파일 브라우저 (File browser): 대화 옆에 있는 트리 구조입니다. 터미널 (Terminal): 채팅 옆에서 명령을 실행합니다. 모바일 라이브 미리보기 (Mobile Live preview): 로컬 개발 웹사이트를 열고 데스크톱 모드로 휴대폰에서 미리 볼 수 있습니다. 작업 관리 (Task management): 보드에서 작업을 계획한 다음, 작업에서 바로 세션을 시작하거나 자동화 기능을 통해 에이전트가 자동으로 처리하도록 할 수 있습니다. 자동화 (Automations): 크론 스케줄을 사용하여 스스로 작업을 수행합니다. 스킬 (Skills): 에이전트의 스킬을 보고, 설치하고, 제거할 수 있습니다. CLI: 세션, 채팅 기록, 작업 및 자동화 기능은 CLI를 통해 지원되므로, 사용자가 하는 방식과 동일하게 에이전트로 Vicoa를 구동할 수 있습니다. - 그리고 더 많은 것들 ...

다운로드(Download)
macOS, Windows 또는 Linux용 Vicoa Desktop입니다. 이 프로그램은 실행되는 컴퓨터에 연결하고 설치된 에이전트를 감지합니다.

필수 전제 조건: 에이전트가 실행되는 머신에는 지원되는 에이전트 CLI 중 최소 하나가 설치되어 있고 로그인되어 있어야 합니다.

터미널을 선호하시나요?

npm i -g @vicoa/cli # Node.js 18+; Intel Mac 또는 구형 glibc의 경우, pip install vicoa를 사용하세요.
vicoa # 세션을 시작하거나, 이 머신에 연결만 하려면 `vicoa daemon`을 사용하세요.

1. 설치 및 로그인. Vicoa Desktop을 열고 로그인합니다.

2. 에이전트 실행. **새 세션(New Session)**을 클릭하고, 머신과 에이전트를 선택한 다음, 첫 번째 프롬프트를 입력합니다.

3. 휴대폰으로 제어. Vicoa 모바일 앱을 설치하고 동일 계정으로 로그인하면, 실행 중인 세션이 자동으로 동기화됩니다.

전체 가이드: Vicoa 설정 · 원격 세션 시작

Vicoa는 사용자의 자격 증명(credentials)을 사용하여 사용자의 머신에 이미 설치 및 인증된 에이전트 하네스(agent harness)와 CLI를 실행합니다.

Claude Code, Codex, Pi, Oh My Pi, 그리고 Antigravity는 네이티브 통합을 지원하며, 나머지 에이전트들은 Agent Client Protocol (ACP)을 통해 연결됩니다.

ACP를 통한 30개 이상의 추가 에이전트. Amp, Auggie, Cline, Devin, Factory Droid, goose, Grok, Junie, Kilo, Kiro, Mistral Vibe, Qwen Code, TRAE 등 다른 ACP 에이전트들은 내장 카탈로그에 포함되어 있습니다. **설정(Settings) → 제공업체(Providers) → 더 많은 에이전트(More agents)**에서 추가하거나 vicoa provider add <id> 명령어를 사용하세요.

ACP를 지원하는 다른 모든 에이전트는 자체 실행 명령어와 함께 작동합니다. 사용자 지정 에이전트를 확인하세요.

CLI 명령어— 터미널에서 vicoa 세션, 작업 및 자동화를 구동하세요.셀프 호스팅(Self-hosting)— 전체 스택을 자체 인프라에서 Docker를 이용해 실행하세요.시작하기(Getting started)— 설치하고 로그인한 후 첫 번째 세션을 실행하세요.지원되는 에이전트(Supported agents)— Claude Code, Codex 및 나머지 에이전트를 설정하세요.주요 기능(Some Features)— 기능 소개전체 문서 →

여기가 Vicoa, 오픈 소스입니다: 완전하고 셀프 호스팅 가능한 스택입니다:

CLI 및 로컬 데몬: 기기에서 코딩 에이전트를 시작하고 실행합니다.백엔드(Backend): 인증, 세션, 메시지, 작업, 자동화를 위한 백엔드 API 및 실시간 서버. Postgres를 사용해 셀프 호스팅 가능합니다.클라이언트(Clients): 웹 앱, 데스크톱 앱, 모바일 앱 (iOS / Android).

Vicoa는 BYO-key: 사용자 본인이 에이전트와 모델 구독 또는 API 키를 가져옵니다.

Docker로 전체 스택을 직접 실행하세요:

cp .env.example .env # 비밀번호 및 공개 URL
./backend/scripts/generate-jwt-keys.sh selfhost/keys
docker compose -f docker-compose.selfhost.yml up -d

전체 워크스루는 SELF_HOSTING.md에 있습니다.

Web · Desktop (macOS/Windows) · iOS · Android · CLI
│
▼
...

간단한 리포지토리 레이아웃:

vicoa/
├── backend/ # Python: FastAPI 백엔드 + REST 서버 + CLI 및 데몬
│ └── vicoa/ # `vicoa` CLI와 로컬 데몬
...

일반 명령어:

# 백엔드, CLI 및 데몬 (Python)
cd backend
make dev-install
...

Discord: 도움과 논의를 위해 Discord 커뮤니티에 참여하세요. Twitter / X: 업데이트 및 공지사항을 받으려면 @vicoaai를 팔로우하세요. 피드백 및 아이디어: 저희는 빠르게 배포합니다. 빠진 것이 있나요? 기능을 요청할 때 플랫폼, 버전 및 재현(reproduction) 정보를 포함해 주세요 (CONTRIBUTING.md 참조). 보안 문제: 공개 이슈로 등록하지 마시고 SECURITY.md를 따라주세요. 지원하기: 이 레포지토리에 별점을 주어 저희의 일일 배포에 동참하세요.

Vicoa는 AGPLv3 라이선스 하에 오픈 소스로 제공됩니다.