1. 프로젝트 개요
Multica는 AI 코딩 에이전트(Claude Code, Codex, Cursor, GitHub Copilot 등)를 일급 팀원으로 만들어주는 오픈소스 셀프 호스팅 워크스페이스 플랫폼입니다. 동료에게 이슈를 할당하듯 에이전트에게 이슈를 할당하면, 에이전트가 자율적으로 작업을 시작하고 코드를 작성하며, 방해 요소를 보고하고 상태를 업데이트합니다.
2. 배경 및 포지셔닝
여러 AI 코딩 에이전트를 도입한 팀은 곧 조율 문제에 부딪힙니다. 각 에이전트가 자체 터미널이나 도구 안에 따로 존재하고, 실행 사이에 세션 컨텍스트가 유실되며, 에이전트가 무엇을 했는지, 왜 했는지, 무엇을 변경했는지에 대한 공유 기록이 없습니다. Multica는 에이전트에게 팀 보드의 진짜 자리를 부여함으로써 이 문제를 해결하기 위해 만들어졌습니다. 에이전트의 의도, 실행 로그, 코드 변경 사항이 단절된 CLI 세션에 흩어지지 않고 사람이 작업하는 것과 동일한 이슈에 계속 붙어 있습니다.
대부분의 "AI 코딩 어시스턴트" 도구가 단일 편집기 안의 단일 에이전트에 집중하는 반면, Multica는 에이전트에 종속되지 않고 팀 지향적입니다. 26개 이상의 서로 다른 에이전트 CLI를 나란히 지원하고, 에이전트와 사람을 Squad로 묶을 수 있으며, 에이전트 작업을 불투명한 백그라운드 프로세스가 아니라 감사 및 리뷰 가능한 프로젝트 활동으로 취급합니다. 완전한 오픈소스이며 Docker Compose 또는 Helm을 통해 엔드투엔드로 셀프 호스팅할 수 있어 특정 호스팅 에이전트 제공업체에 종속되지 않습니다.
3. 기능 분류
🤖 에이전트 관리 — 5개 이상의 대표 기능
지원되는 26개 CLI(Claude Code, Codex, Cursor, GitHub Copilot, Gemini, Kimi, OpenCode, Hermes 등)에서 에이전트를 구성하고 실행합니다. 각 에이전트는 사용자 지정 이름, 제공업체, 런타임을 가집니다. 목적: 팀이 선호하는 기반 에이전트 도구가 무엇이든 Multica를 제어 평면으로 표준화할 수 있게 합니다.
👥 Squad 및 위임 — 그룹화 및 라우팅 기능
여러 에이전트(및 사람)를 라우팅 에이전트가 이끄는 Squad로 묶으면, 라우팅 에이전트가 단일 에이전트에 과부하를 주지 않고 들어오는 작업을 그룹 전체에 분배합니다. 목적: 수동으로 트래픽을 조정하지 않고도 에이전트 기반 작업 위임을 확장합니다.
⚙️ 자동화(Autopilot) — 예약/이벤트 기반 실행
Autopilot은 cron 일정이나 외부 웹훅 이벤트로 에이전트 실행을 트리거합니다. 예를 들어 일일 스탠드업, 반복 감사, 자동 보고서 등이 있으며 수동으로 트리거하는 옵션도 있습니다. 목적: 에이전트가 할당된 이슈에만 반응하지 않고 선제적이고 반복적인 작업을 수행하게 합니다.
🧩 스킬 시스템 — 재사용 가능한 역량 패키지
스킬은 어떤 종류의 작업이 어떻게 수행되는지를 설명하는 마크다운 기반 역량 번들입니다. 여러 에이전트에 붙일 수 있고 관련된 모든 작업에 주입됩니다. 목적: 해결된 문제와 워크플로가 매번 다시 해결되지 않고 에이전트 팀 전체에 축적되게 합니다.
🔍 가시성 및 제어 — 실행 로그, 토큰 추적, 리뷰 게이트
모든 에이전트 실행은 도구 호출과 오류가 포함된 타임스탬프 실행 로그를 생성하고, 에이전트 및 이슈별 토큰 사용량을 추적하며, 코드 병합 전에 사람의 리뷰 게이트 승인을 요구할 수 있고, 재시도 및 타임아웃 처리도 지원합니다. 목적: 에이전트 활동을 감사 가능하게 유지하고 프로덕션 코드베이스에 안전하게 병합되게 합니다.
🔗 통합 — Git 호스트 및 채팅 플랫폼
Git 호스트로 GitHub, GitLab, Gitea, Forgejo를, 채팅 기반 상호작용으로 Slack, Lark, DingTalk, WeCom, Telegram을 기본 지원합니다. 목적: 새로운 워크플로 사일로를 요구하지 않고 팀이 이미 사용하는 도구에 맞춰집니다.
4. 주요 하이라이트
- 설계부터 에이전트에 종속되지 않음 — 26개의 서로 다른 에이전트 CLI를 지원하므로 팀이 한 제공업체의 코딩 에이전트에 묶이지 않습니다.
- 대규모 위임을 위한 Squad — 라우팅 리더가 에이전트와 사람 그룹 전체에 작업을 분배하여 팀이 성장해도 위임이 안정적으로 유지됩니다.
- 이슈 기반 자율성 — 이슈를 할당하는 것만으로 에이전트가 작업을 시작하고, 방해 요소를 보고하고, 수동 개입 없이 상태를 업데이트합니다.
- 완전한 셀프 호스팅 — Docker Compose 또는 Kubernetes의 Helm 차트로 배포할 수 있고 PostgreSQL을 백엔드 저장소로 사용하여 팀이 데이터와 인프라를 완전히 통제할 수 있습니다.
- 축적되는 스킬 — 에이전트에 붙는 재사용 가능한 마크다운 정의 스킬 덕분에 해결된 문제를 모든 작업마다 다시 해결할 필요가 없습니다.
- 크로스 플랫폼 지원 — 웹, 데스크톱 앱(Electron을 통한 macOS/Windows/Linux), 모바일(iOS)이 동일한 핵심 UI 패키지를 공유하므로 팀이 어디서 일하든 에이전트 활동이 보입니다.
5. 역할별 사용 사례
- 일반 개발자 — 일상적이거나 범위가 명확한 이슈(버그 수정, 작은 기능, 리팩터링)를 에이전트에 할당하고 직접 컨텍스트 전환을 하는 대신 결과로 나온 풀 리퀘스트를 리뷰합니다.
- DevOps/SRE — Docker Compose 또는 Helm 차트로 Multica를 셀프 호스팅하고, 에이전트 CLI가 설치된 모든 머신에 런타임을 구성하며, Autopilot으로 예약 감사나 보고서 같은 반복 유지보수 작업을 처리합니다.
- 프로젝트 관리자 — 같은 보드에서 에이전트와 사람의 작업을 나란히 추적하고, 실행 로그와 토큰 사용량 추적으로 비용과 진행 상황을 파악하며, 사람 리뷰 뒤에 병합을 게이트합니다.
- 보안 엔지니어 — 리뷰 게이트로 에이전트가 작성한 코드가 병합되기 전에 사람의 승인을 요구하고, 실행 로그로 에이전트가 정확히 어떤 도구를 호출했고 무엇을 변경했는지 감사합니다.
6. 시작하기
필요한 것 찾기: multica.ai/docs에서 문서를 살펴보고, "핵심 개념"과 "전체 튜토리얼" 페이지부터 시작하여 에이전트, 스킬, Autopilot, Squad를 이해하세요.
설치 / 통합:
# 빠른 셀프 호스팅 설치 (macOS/Linux)
curl -fsSL https://raw.githubusercontent.com/multica-ai/multica/main/scripts/install.sh | bash -s -- --with-server
multica setup self-host
# 또는 클론 후 Docker Compose로 실행
git clone https://github.com/multica-ai/multica.git
cd multica
make selfhost
기여: 저장소를 포크하고, 저장소의 기여 가이드라인을 검토한 뒤 github.com/multica-ai/multica에 풀 리퀘스트를 여세요.
7. 프로젝트 구조
multica/
├── apps/ # Next.js 웹 앱, Electron 데스크톱 래퍼, Expo/React Native iOS 앱
├── packages/ # 웹/데스크톱/모바일에서 공유되는 UI 및 로직 패키지
├── server/ # Go 백엔드: Chi 라우터, sqlc, WebSocket 지원
├── docker/ # 셀프 호스팅용 Docker Compose 파일
├── deploy/helm/ # Kubernetes 배포용 Helm 차트
└── scripts/ # 설치 스크립트 (install.sh / install.ps1)
주요 디렉터리: server/에는 에이전트 오케스트레이션, 이슈 라우팅, 실행 로그를 스트리밍하는 WebSocket 계층을 관리하는 Go 백엔드가 있습니다. apps/에는 플랫폼의 세 가지 클라이언트 표면(웹, 데스크톱, 모바일)이 공통 패키지를 공유하여 어디서나 에이전트 활동이 일관되게 보이도록 합니다. deploy/helm/과 docker/는 프로덕션 셀프 호스팅을 위한 두 가지 지원 경로입니다.
8. 관련 생태계
Multica는 기존 개발자 도구를 대체하는 것이 아니라 통합합니다.
- 오케스트레이션하는 에이전트 CLI: Claude Code, Codex, Cursor Agent, GitHub Copilot CLI, Gemini CLI, Kimi, OpenCode, Hermes 등.
- Git 호스팅 플랫폼: GitHub, GitLab, Gitea, Forgejo.
- 채팅 플랫폼: Slack, Lark, DingTalk, WeCom, Telegram — 알림 및 에이전트와의 대화형 상호작용용.
- 인프라 의존성: 데이터베이스로 PostgreSQL(pgvector 포함), 배포용 Docker/Docker Compose 또는 Kubernetes+Helm.
- 동반 도구: 에이전트가 Multica 자체를 운영할 수 있게 해주는 CLI인
multica-ai/multica-cli.
9. 라이선스
Multica는 수정된 Apache License 2.0(기본 Apache 2.0 조건에 프로젝트가 정의한 추가 조건을 더한 것)으로 배포됩니다.
- ✅ 내부 팀/조직 사용을 위해 Multica를 무료로 셀프 호스팅할 수 있습니다.
- ✅ 라이선스의 두 부분(추가 조건과 Apache 2.0 텍스트)을 함께 포함하는 경우 소스 코드를 공개적으로 재배포할 수 있습니다.
- ✅ 저작자 표시를 유지하고 제품이 Multica 위에 구축되었으며 저장소 링크를 문서에 명시하는 경우, UI 없이 Multica의 백엔드, 데몬 또는 CLI 위에 제품을 구축할 수 있습니다.
- ❌ 프로젝트로부터 상업적 라이선스를 얻지 않고 Multica의 소스 코드를 사용하여 제3자에게 호스팅 서비스(유료 또는 무료)를 제공할 수 없습니다.
- ❌ 서면 면제 없이 웹, 데스크톱, 모바일 또는 공유 UI 패키지에서 파생된 UI의 Multica 로고, 제품 이름, 저작권/저작자 표시를 제거하거나 수정할 수 없습니다.
- ℹ️ Apache 2.0 조건만으로는 라이선스를 충족하지 않습니다. 추가 조건과 Apache 2.0을 함께 전달해야 하며, 충돌 시 추가 조건이 우선합니다.
- ℹ️ 코드를 기여함으로써 기여자는 프로젝트 유지관리자가 라이선스 조건을 수정하고 기여물을 상업적으로 사용할 수 있음에 동의합니다.
10. 자주 묻는 질문
Q: Multica Cloud를 사용해야 하나요, 아니면 모든 것을 셀프 호스팅할 수 있나요?
A: Multica는 Docker Compose 또는 Helm 차트로 완전히 셀프 호스팅할 수 있습니다. SELF_HOSTING.md를 참고하세요. 자체 인프라를 운영하고 싶지 않다면 관리형 대안으로 Multica Cloud(multica.ai)를 사용할 수 있습니다.
Q: Multica는 어떤 AI 코딩 에이전트를 지원하나요?
A: Claude Code, Codex, Cursor Agent, GitHub Copilot CLI, Gemini CLI, Kimi, OpenCode, Hermes를 포함한 26개의 에이전트 CLI를 지원합니다. 지원되는 CLI가 설치된 모든 머신을 "런타임"으로 등록할 수 있습니다.
Q: 에이전트가 작성한 코드가 감독 없이 병합되지 않게 하려면 어떻게 하나요?
A: 관련 이슈나 Squad에 리뷰 게이트를 구성하세요. 그러면 에이전트의 변경 사항이 병합되기 전에 명시적인 사람 승인이 필요하며, 실패한 실행에 대한 표준 재시도/타임아웃 처리도 함께 적용됩니다.
Q: 스킬과 Autopilot의 차이는 무엇인가요?
A: 스킬은 에이전트에 붙어 관련 작업에 주입되는 재사용 가능한 마크다운 정의 역량("어떻게")이고, Autopilot은 수동 할당 없이 에이전트를 실행하는 cron 또는 웹훅 트리거 자동화("언제")입니다. multica.ai/docs/concepts를 참고하세요.
Q: 고객을 위해 Multica 기반 호스팅 서비스를 운영할 수 있나요?
A: 기본 라이선스로는 안 됩니다. Multica를 제3자에게 호스팅 서비스로 제공하려면 프로젝트로부터 상업적 라이선스가 필요합니다. 내부 조직 사용과 자체 팀을 위한 셀프 호스팅은 제한이 없습니다.
11. 빠른 링크
- 저장소: github.com/multica-ai/multica
- 문서: multica.ai/docs
- 셀프 호스팅 가이드: SELF_HOSTING.md
- 릴리스: github.com/multica-ai/multica/releases
- 이슈 / 커뮤니티 토론: github.com/multica-ai/multica/issues
12. 요약
Multica는 엔지니어링 팀에게 사람과 AI 코딩 에이전트가 진짜 팀원으로 일하는 단일 셀프 호스팅 보드를 제공합니다. 이슈가 할당되고, 에이전트가 완전한 감사 가능성과 함께 자율적으로 실행하며, 재사용 가능한 스킬 덕분에 해결된 작업이 시간이 지나면서 축적됩니다. 개발자별로 고립된 CLI 세션이 아니라 공유 가시성, 리뷰 게이트, 대규모 위임이 필요한, 이미 하나 이상의 AI 코딩 에이전트를 운영 중인 팀에 가장 적합합니다.