OpenCove 🌌

Claude Code, Codex, 터미널, 작업 및 노트를 위한 무한 캔버스입니다.

Status

Platform

简体中文

모든 에이전트(agent), 터미널, 작업 및 노트를 하나의 무한 캔버스에 유지하세요.

병렬 작업을 한눈에 확인하고, 컨텍스트를 보이게 유지하며, 중단했던 지점부터 정확히 재개할 수 있습니다.

최신 빌드 다운로드하기 · 중국어 README 읽기

📣 중요 공지사항

OpenCove 0.4.0 버전에서는 Pixel 작업 공간, 데스크톱 스타일의 접힌 창(collapsed windows), 독립적으로 설치 가능한 플러그인 및 테마를 제공합니다. 설정(Settings)에서 확장 기능을 탐색하거나, opencove plugin guide로 자신만의 것을 만들기 시작하세요.

📖 OpenCove란 무엇인가요?

OpenCove는 매일 AI 코딩 에이전트와 함께 작업하는 사람들을 위한 **공간 개발 워크스페이스(spatial development workspace)**입니다.

작업을 탭, 사이드바, 긴 채팅 스레드 안에 묻어두는 대신, OpenCove는 사용자의 AI 에이전트, 터미널, 작업, 그리고 노트를 동일한 무한 2D 캔버스에 배치하여 작업의 전체 상태가 항상 보이도록 합니다.

이는 다음과 같은 워크플로우를 위해 구축되었습니다:

• 여러 개의 Claude Code 또는 Codex 세션을 나란히 실행하기
• 작업 계획, 노트 및 터미널 출력을 하나의 공유된 작업 공간에 유지하기
• 레이아웃, 컨텍스트 또는 실행 기록을 잃지 않고 프로젝트 전환하기

✨ 주요 특징

• 🌌 무한 공간 캔버스: 터미널, 노트, 작업, 에이전트 세션을 생각하는 방식대로 배치할 수 있습니다.
• 🤖 CLI 에이전트용 설계: Claude Code, Codex 및 유사한 터미널 네이티브 에이전트 워크플로우에 최적화되었습니다.
• 🧠 컨텍스트 가시성 유지: 계획, 실행, 결과가 선형적인 채팅 기록 속에 묻히는 대신 함께 살아있습니다.
• 💾 영속적인 작업 공간: 재시작 후에도 뷰포트, 레이아웃, 터미널 출력 및 에이전트 상태를 복원할 수 있습니다.
• 🗂️ 공간 아카이브: 이전 작업 공간 상태를 스냅샷으로 찍어 필요할 때 돌아가서 옛 컨텍스트에 진입할 수 있습니다.
• 🖼️ 풍부한 미디어와 스마트 레이아웃: 이미지를 붙여넣고, 노드를 다중 선택하며, 라벨 색상을 사용하고, 지저분한 보드를 빠르게 정리할 수 있습니다.
• 🔍 글로벌 검색 및 제어 센터: 캔버스와 터미널 출력 전반에서 검색하고, 한 곳에서 활성 세션을 관리할 수 있습니다.
• 🗂️ 작업 공간 격리: 디렉토리와 git worktree를 사용하여 프로젝트를 깔끔하게 분리합니다.

💡 OpenCove가 필요한 이유?

OpenCove는 간단한 아이디어를 중심으로 설계되었습니다. 즉, 컨텍스트가 숨겨진 것이 아니라 공간적일 때 에이전트 워크플로우에 대해 추론하기가 더 쉽다는 것입니다.

CLI 및 서버 설치

opencove CLI를 설치할 수 있는 두 가지 지원 방식이 있습니다:

• 데스크톱 앱에서: 설정(Settings) → 워커(Worker) → CLI로 이동하여 **CLI 설치(Install CLI)**를 클릭합니다.
• 데스크톱 없이: 독립 실행형 런타임 번들(opencove-server-*)과 opencove-install-v<tag>.sh / opencove-install-v<tag>.ps1와 같은 릴리스별 설치 자산을 포함하는 GitHub Release를 사용합니다. 안정 버전(Stable releases)에서는 일반적으로 최신 안정 버전을 대상으로 하는 일반적인 opencove-install.sh / opencove-install.ps1 별칭도 게시됩니다.

만약 releases/latest/download/opencove-install.sh가 404를 반환한다면, 최신 안정 버전에서 아직 독립 실행형 설치 프로그램을 게시하지 않은 것입니다. 이 경우, 일단 데스크톱 설치기를 사용하거나 해당 자산이 포함된 릴리스를 기다려야 합니다.

최신 안정 버전을 위해 macOS/Linux에서는 다음 명령어를 사용하여 설치합니다:

curl -fsSL https://github.com/DeadWaveWave/opencove/releases/latest/download/opencove-install.sh | sh

Windows에서는 PowerShell을 사용합니다:

powershell -NoProfile -ExecutionPolicy Bypass -Command "Invoke-RestMethod https://github.com/DeadWaveWave/opencove/releases/latest/download/opencove-install.ps1 | Invoke-Expression"

특정 태그가 지정된 릴리스 또는 야간(nightly) 릴리스의 경우, 해당 릴리스 페이지에서 버전별 설치 자산을 사용합니다:

curl -fsSL https://github.com/DeadWaveWave/opencove/releases/download/v<version>/opencove-install-v<version>.sh | sh

powershell -NoProfile -ExecutionPolicy Bypass -Command "Invoke-RestMethod https://github.com/DeadWaveWave/opencove/releases/download/v<version>/opencove-install-v<version>.ps1 | Invoke-Expression"```

독립 실행형 설치기는 다운로드된 런타임을 릴리스의 `SHA256SUMS.txt`와 비교하여 검증한 후 추출합니다.

Web UI를 호스팅하는 헤드리스(headless) 서버의 경우, 설치 후 워커를 직접 시작합니다:

```bash
opencove worker start --hostname 0.0.0.0 --web-ui-password 'change-me'

이 명령어는 Web UI URL을 출력하고 브라우저 접근을 위한 비밀번호 로그인 기능을 활성화합니다. Web UI를 localhost 외부에 노출할 때는 항상 비밀번호를 설정해 두세요.

소스에서 빌드하기 (Building from Source)

필수 조건 (Prerequisites)

• Node.js >= 22.12.0
• pnpm 9.6.0
• (권장) 전체 에이전트 워크플로우를 경험하려면 Claude Code 또는 Codex를 전역으로 설치하세요.

빌드 지침 (Build Instructions)

# 1. 저장소 복제
git clone https://github.com/DeadWaveWave/opencove.git
cd opencove
...

더 많은 패키징 및 빌드 문서는 RELEASING.md를 참조하세요.

Web UI (실험적 기능, Experimental)

OpenCove는 실험적인 Worker 호스팅 Web UI를 포함하고 있어 브라우저(LAN의 다른 장치 포함)에서 캔버스를 열 수 있습니다.

• 설정(Settings) → 실험적 기능(Experimental) → Worker Web UI에서 **Web UI 활성화(Enable Web UI)**를 켜고 (선택적으로 고정 포트를 설정한 후), 로컬 워커를 시작하세요.
• 기본적으로는 루프백 전용(127.0.0.1)입니다. LAN 접근을 하려면 **LAN 접근(LAN Access)**을 활성화하고 Web UI 비밀번호를 설정해야 합니다.
• 개발자 참고: LAN 접근은 내장된 out/renderer 번들을 사용합니다 (HMR 없음). UI 변경 후에는 pnpm build를 실행하세요.

더 자세한 내용은:

• docs/architecture/CONTROL_SURFACE.md
• docs/runtime/WEB_UI_TROUBLESHOOTING.md

🏗️ 기술 아키텍처 (Technical Architecture)

OpenCove는 현대적이고 고성능의 웹 표준으로 구축되었습니다:

• 프레임워크(Framework): Electron + React + TypeScript (electron-vite를 통해)
• 캔버스 엔진(Canvas Engine): 부드러운 무한 캔버스 상호 작용을 위한 @xyflow/react.
• 기반 터미널(Underlying Terminal): 완전한 PTY 런타임을 구동하는 xterm.js 및 node-pty.
• 테스트(Testing): 견고한 단위 테스트 및 E2E 회귀 테스트를 위한 Vitest와 Playwright.

🤝 기여 (Contributing)

OpenCove는 오픈 소스입니다. AI 지능 시대의 IDE가 어떤 모습이어야 하는지 정의하는 데 여러분의 도움이 필요합니다.
아래 가이드를 읽어보세요:

• 기여 가이드라인 (CONTRIBUTING.md)
• 행동 강령 (CODE_OF_CONDUCT.md)
• 지원 (SUPPORT.md)
• 상표 및 브랜드 가이드라인 (TRADEMARKS.md)

💬 커뮤니티 그룹

아래 QR 코드를 스캔하여 OpenCove 커뮤니티 그룹에 가입하고 다른 사용자들과 대화하세요.