AIDotNet/OpenCowork

OpenCowork – 다중 에이전트 AI 협업용 데스크톱 플랫폼

무엇인가요 – OpenCowork는 Electron으로 구축된 오픈소스 데스크톱 애플리케이션으로, 대규모 언어 모델(Large Language Model) 기반 에이전트가 당신의 컴퓨터에 존재하는 파일, 쉘, 리포지토리에 직접 작업할 수 있도록 합니다. 에이전트는 파일 읽기/편집, 명령 실행, 웹 탐색, 다른 에이전트와의 협업이 가능하며, 모든 작업은 시각적으로 확인 가능한 도구 호출 승인을 통해 당신이 완전히 제어할 수 있습니다.

왜 중요한가요 – 대부분의 채팅 기반 AI 도구는 코드나 로그를 복사-붙여넣기 해야 하며, 이로 인해 컨텍스트가 손실되고 오고가는 대화가 반복됩니다. OpenCowork는 에이전트를 작업과 함께 실행하여 로컬 파일 시스템, 완전한 쉘(SSH 포함), 검색 가능한 코드 그래프에 네이티브 접근을 제공합니다. 이로 인해 AI는 단순한 분리된 챗봇이 아니라 진정한 동료가 됩니다.

핵심 기능 (README에 설명됨)

기능	제공되는 기능
다중 에이전트 설계	하위 에이전트, 에이전트 팀 생성 및 세션 목표 설정 가능. 단일 채팅 박스가 아니라 공통 런타임을 공유하는 여러 에이전트를 오케스트레이션할 수 있습니다.
메시징 채널 통합	Feishu, DingTalk, Discord, QQ, Telegram, WeCom, WeChat 공식, WhatsApp 등과 연결 가능. 팀이 이미 사용하는 채널에 업데이트를 전달할 수 있습니다.
런타임 스택	Electron + React 19 UI ↔ 좁은 Preload 브리지 ↔ Electron Main (호스트 게이트웨이) ↔ .NET 11 네이티브 AOT 워커 (에이전트 루프, 도구 실행, SQLite 저장, CodeGraph 인덱싱을 담당).
다섯 가지 세션 모드	`chat` (일반 대화), `clarify` (코드 전 계획), `cowork` (파일, 쉘, 브라우저, 하위 에이전트에 대한 완전한 접근), `code` (Monaco 에디터를 사용한 페어 프로그래밍), `acp` (아키텍처 리더의 설계 및 위임).
도구 상자	• 파일 및 쉘 (읽기/쓰기, glob, grep, Bash, SSH) • 브라우저 자동화 (이동, 클릭, 추출) • 작업 및 팀 관리 • 계획 모드 • 목표 기반 메모리 (`SOUL.md`, `USER.md`, `MEMORY.md`) • Cron 작업 • MCP 서버 (stdio, SSE, HTTP) • 스킬 마켓플레이스 및 확장 • CodeGraph (tree-sitter 기반 코드베이스 인덱싱).
워크스페이스 UI	칸반 태스크 보드, 스케줄/일회성 작업, 리소스 탐색기, 스킬/페르소나 패널, WebDAV 동기화, 미디어 파이프라인용 노드 그래프 캔버스, 시각적 CodeGraph 보기, 전용 SSH 터미널.
국제화	i18next를 통해 16개 언어로 번역됨.
데스크톱 펫 및 라이프사이클 훅	선택적 마스코트 및 사용자 정의 시작/종료 동작용 훅.

아키텍처 개요

Renderer (React 19)  ←→  Preload  ←→  Main (Electron 호스트)  ←→  네이티브 워커 (.NET 11 AOT)
      UI 및 승인              IPC, 윈도우, 채널, cron, SSH          에이전트 루프, 도구, SQLite, CodeGraph
CLI (Ink TUI) ────────────────────────────────────────────────────────────────────────→ 동일한 네이티브 워커

Renderer – 상태만 표시하며 에이전트 로직은 실행하지 않습니다.
Preload – 렌더러에 안전한 API를 노출하는 얇은 contextBridge.
Main – 윈도우, 자격 증명, 메시징 플러그인 관리 및 네이티브 워커 생성.
네이티브 워커 – LLM 제공자 루프, 도구 실행, SQLite에 데이터 저장, CodeGraph 유지 관리의 권위 있는 프로세스.

데스크톱 UI와 터미널 기반 CLI(cowork)는 동일한 네이티브 워커와 통신하여 에이전트, 제공자, 작업에 대한 단일 진실원을 보장합니다.

시작하기 (README에서의 빠른 시작)

사전 요구 사항 – Node ≥18, npm ≥9, .NET 11 SDK (Preview 7 이상, 네이티브 AOT 지원 필요). CodeGraph 사전 프로세스가 필요하므로 하위 모듈 포함 클론이 필요합니다.
```
git clone --recurse-submodules https://github.com/AIDotNet/OpenCowork.git
cd OpenCowork
```

의존성 설치 및 개발 모드 실행

npm install
npm run dev   # 핫리로드 기능 포함 Electron 시작

배포용 빌드 – 제공된 스크립트(npm run build:win, build:mac, build:linux) 사용. GitHub 릴리스 페이지에도 사전 빌드된 설치 프로그램 제공.

CLI 대안 – 글로벌 npm 설치 후 터미널에서 동일한 워커 실행 가능:

npm install -g @aidotnet/opencowork
cowork          # TUI 클라이언트 시작
cowork --doctor # 진단

모든 설정, 제공자, 에이전트, 스킬 정의는 ~/.open-cowork/ 아래에 있으며, 데스크톱 앱과 CLI 간에 공유됩니다.

일반적인 사용 사례

자율적 코딩 – 신뢰하는 리포지토리 내에서 에이전트가 리팩터링, 디버깅, 커밋을 직접 수행하도록 할 수 있습니다.
스케줄된 작업 – Cron 기반 에이전트가 로그나 시스템 상태를 모니터링하고 Feishu, Discord 등에 알림을 전송합니다.
연구 및 보고서 생성 – 웹 탐색, 데이터 스크래핑, CSV/Excel 파일 처리, 문서 생성 가능.
원격 관리 – 앱 내 SSH 터미널을 열어 UI를 벗어나지 않고도 다른 호스트에서 명령을 실행할 수 있습니다.
설계 및 미디어 파이프라인 – "Draw" 노드 그래프 캔버스와 내장 확장 기능을 사용해 제품 설계, 창작 생산, 동영상 생성 등에 활용.

문서 및 커뮤니티

공식 문서 – https://open-cowork.dev
리포지토리 내 가이드 – AGENTS.md (에이전트 규칙), cli/README.md (CLI 사용법), docs/architecture/ 아래 아키텍처 문서.
기여 방법 – feat(scope): … 커밋 스타일 따르기, PR 열기 전에 npm run typecheck 및 npm run lint 실행.
후원자 및 감사 – 몇몇 개인 후원자를 명시하며, RoutinAI(LLM 게이트웨이)와 GeneralUpdate(자동 업데이트 라이브러리)에 감사의 말 전달.

라이선스

Apache License 2.0 – 상업적/비상업적 사용 모두 자유롭게 가능하며, 일반적인 특허 부여 및 출처 표기 요구 사항 있음.

결론 – OpenCowork는 대규모 언어 모델의 능력을 개발자의 기존 워크플로우와 연결하는 완전한 로컬 실행 다중 에이전트 플랫폼으로, 풍부한 데스크톱 UI와 터미널 클라이언트를 제공하면서도 모든 데이터를 사용자 기계에 보관합니다.