OpenCherry Desktop

저장소 관리

• 추적할 저장소 등록 및 제거
• SQLite에 저장소 목록 영구 저장
• 기존 repos.json 데이터를 자동으로 가져오기
• 멀티 레포 사이드바 및 저장소별 상세 보기 제공

Git 워크플로

• 저장소 상태 스냅샷 표시
• 충돌(Conflicted), 스테이지(Staged), 비스테이지(Unstaged), 미추적(Untracked) 상태별 그룹화된 diff 표시
• 파일 단위 stage/unstage
• 스테이지된 변경사항 커밋 및 stage all + commit
• 현재 브랜치 게시(publish)
• 로컬/원격 변경사항 동기화(sync)

에이전트 감지

• sysinfo 기반 실행 중인 CLI 에이전트 자동 감지
• 지원 에이전트 분류: Claude Code, OpenCode, Codex, Gemini CLI, Aider
• Antigravity 확장 프로세스는 감지에서 제외
• Linux 스레드 중복 항목 필터링

프런트엔드 인터페이스

• 저장소 사이드바 및 추가/제거 액션
• 저장소별 상태 카드
• 커밋 메시지 입력 상자와 커밋 액션
• 커밋/게시/동기화 상태에 따라 동적으로 변하는 기본 액션 바
• 파일별 stage/unstage 액션이 포함된 그룹화 diff 렌더링
• 감지된 에이전트 패널

Windows 설치

Winget을 이용해 다음 명령으로 설치할 수 있습니다.

winget install --id 4nrry.OpenCherryDesktop --exact

또는 GitHub Release에 첨부된 NSIS 설치 파일(opencherry_<version>_x64-setup.exe)을 내려받아 실행합니다. 서명되지 않은 설치 파일이므로 첫 실행 시 Windows SmartScreen 경고가 표시될 수 있으며, 이 경우 ‘추가 정보 → 그대로 실행’을 선택하면 됩니다.

Linux 설치

Ubuntu 24.04+ 환경에서 .deb 패키지를 받아 설치하는 방식이 가장 간단합니다.

sudo apt install ./opencherry_0.0.1_amd64.deb

설치 후 애플리케이션 메뉴에서 OpenCherry를 실행하거나 /usr/bin/opencherry-desktop 바이너리를 직접 실행하면 됩니다. AppImage를 사용할 경우 FUSE(libfuse2)가 필요하며, 원커맨드 설치 스크립트를 통해 최신 AppImage를 내려받아 SHA-256을 검증한 뒤 ~/.local/bin/opencherry에 설치할 수도 있습니다.

macOS 설치

GitHub Release에서 Apple Silicon(aarch64) 또는 Intel(x86_64)용 .dmg를 내려받아 Applications 폴더로 드래그해 설치합니다. 서명 및 공증(notarize)이 되어 있지 않아 첫 실행 시 Gatekeeper가 차단할 수 있으며, 우클릭 후 ‘열기’ 또는 ‘시스템 설정 → 개인 정보 및 보안’에서 허용해야 합니다.

개발 환경에서 실행

저장소를 클론한 뒤 의존성을 설치하고 개발 셸을 띄웁니다.

pnpm -C apps/desktop install

pnpm -C apps/desktop tauri dev

검증 작업은 just check로, 테스트는 just test로 실행할 수 있습니다.

업데이트와 제거

자동 업데이트는 제공되지 않습니다. 새 버전으로 업데이트하려면 apps/desktop/src-tauri/tauri.conf.json의 version 값을 올리고 새 패키지를 다시 설치해야 합니다. Ubuntu에서는 새 .deb를 기존 패키지 위에 설치하고, 제거는 sudo apt remove open-cherry로 진행합니다.

어떤 운영체제를 지원하나요?

Ubuntu/GNOME이 1차 지원 대상이고, macOS와 Windows는 Tauri 2를 통한 보조 지원 플랫폼입니다.

어떤 AI 코딩 에이전트를 인식하나요?

Claude Code, OpenCode, Codex, Gemini CLI, Aider 5종을 자동으로 분류·감지하며, Antigravity 확장 프로세스는 제외됩니다.

자동 업데이트가 있나요?

자동 업데이트는 제공되지 않습니다. 새 버전이 나오면 .deb, .exe, .dmg, .AppImage 등 해당 플랫폼의 패키지를 수동으로 다시 설치해 업데이트합니다.

라이선스는 무엇인가요?

AGPL-3.0-or-later이며, 소스 코드는 GitHub 저장소와 LICENSE 파일을 통해 공개되어 있습니다.