Octane0411/open-vibe-island

Open Island – AI 코드 생성 에이전트를 위한 네이티브 macOS 컨트롤 패널

무엇인가요 – Open Island는 무료로 오픈소스인 macOS 앱으로, 노치(또는 메뉴바 상단 중앙)에 상주하며, 터미널이나 IDE에서 실행 중인 AI 코드 생성 에이전트의 상태를 실시간으로 표시합니다. 어떤 에이전트가 활성화되어 있는지 확인하고, 권한 요청을 승인하거나 거부하며, 사용 통계를 확인하고, 에이전트가 대화하고 있는 정확한 터미널/IDE 패널로 클릭 한 번으로 돌아갈 수 있습니다. 작업 흐름을 방해하지 않고 모든 기능을 이용할 수 있습니다.

왜 중요한가요 – 많은 개발자들이 Claude Code, Codex, Cursor, Gemini‑CLI 등의 도구를 사용해 명령줄에서 코드를 생성합니다. 기존의 상용 제품은 이러한 에이전트에 UI를 통합하지만, 폐쇄형이며 계정이 필요하고 대부분 클라우드에서 작동합니다. Open Island는 로컬에서 동일한 편의성을 제공하며, 텔레메트리 없이 사용자만의 소프트웨어 스택을 완전히 제어할 수 있습니다.

---

주요 기능 (README에 설명됨)

기능	제공되는 기능
노치 / 상단바 오버레이	Mac의 노치 또는 메뉴바에 항상 표시되는 작은 패널로, 코드 작성 중에도 항상 시야에 들어옵니다.
다중 에이전트 지원	13개의 에이전트(Claude Code, Codex, Cursor, Gemini‑CLI, Grok Build, Kimi CLI, OpenCode, Pi, Oh My Pi, Qoder, Qwen Code, Factory, CodeBuddy)와 호환됩니다.
다중 터미널 및 IDE 지원	15개 이상의 터미널/IDE(Terminal.app, iTerm2, WezTerm, Ghostty, tmux, Zellij, VS Code, JetBrains IDEs, Warp 등)를 감지하고, 원래 패널로 바로 이동할 수 있습니다.
실시간 세션 탐지	로컬 트랜스크립트 파일을 읽고 프로세스를 감시하여 활성 에이전트 세션을 자동으로 목록화합니다.
권한 처리	에이전트에서 오는 권한 요청 알림을 표시하며, 오버레이에서 직접 승인/거부할 수 있습니다.
사용량 대시보드	Claude Code, Codex 등 사용량을 노출하는 에이전트의 경우 최근 사용 기간(5시간 / 7일)을 표시합니다.
훅 기반 통합	각 에이전트의 훅 시스템이 작은 CLI(OpenIslandHooks)를 호출하며, 이 CLI가 Unix 소켓을 통해 JSON 이벤트를 앱으로 전달합니다.
풀스크린 없이 업데이트	Sparkle를 통해 자동 업데이트. DMG는 서명되어 있으며, 노타라이즈됨.
국제화	UI는 영어와 간체중국어로 제공됩니다.
오픈소스 및 로컬 우선	GPL‑v3 라이선스, 원격 서버 없음, 텔레메트리 없음.

---

작동 방식 (고수준 아키텍처)

1. 에이전트가 훅 발행 – AI 코드 생성 에이전트가 세션을 시작하거나 프롬프트를 받거나 도구를 사용할 때, JSON 페이로드를 stdout에 기록합니다.
2. OpenIslandHooks CLI – 훅 명령어는 JSON을 읽고 Unix 소켓을 통해 실행 중인 앱으로 전달하는 작은 Swift CLI를 실행합니다.
3. 앱 내 브리지 서버 – 페이로드를 수신하고 내부 세션 모델을 업데이트하며 UI를 새로 고칩니다.
4. 오버레이 UI – 세션 목록과 상태를 표시하며, 클릭하면 원래 터미널/IDE로 이동할 수 있습니다.
5. 이동 백 – 대상에 따라 적절한 메커니즘(iTerm2에는 AppleScript, VS Code에는 CLI code -r, Warp에는 SQLite 검색 등)을 사용해 올바른 패널을 전면에 표시합니다.

아키텍처는 4개의 Swift 패키지 타겟으로 나뉩니다:

• OpenIslandApp – SwiftUI/AppKit UI.
• OpenIslandCore – 공유 모델, IPC, 세션 지속성.
• OpenIslandHooks – 에이전트에 의해 호출되는 CLI.
• OpenIslandSetup – 각 에이전트의 설정 파일에 훅 항목을 설치/제거하는 도우미.

---

시작하기

방법	단계
다운로드 (DMG)	Releases 페이지에서 최신 릴리스를 다운로드하고, DMG를 열어(이미 노타라이즈됨) 앱을 /Applications에 드래그합니다.
Homebrew	brew install --cask open-island – 이후 업데이트는 brew upgrade --cask open-island로 수행합니다.
소스에서 빌드	```bash
git clone https://github.com/Octane0411/open-vibe-island.git
cd open-vibe-island
open Package.swift # Xcode에서 열고 Run 버튼 클릭

최초 실행 시 앱은 실행 중인 에이전트를 스캔하고, 필요한 훅 파일을 설치합니다(설정 창에서 관리 가능)하며, 실시간 세션을 표시하기 시작합니다.

---

### 누구에게 적합한가요?
- 하루 대부분을 터미널에서 보내며 AI 코드 보조 도구를 사용하는 개발자.
- 유료 클라우드 서비스 대신 **로컬에서 개인정보를 보호하는** UI를 원하는 사용자.
- 지원되는 에이전트나 터미널 중 하나를 사용하는 사용자 – README에 완전한 호환성 표가 있습니다.

---

### 커뮤니티 및 기여
- **Discord** – 지원, 기능 아이디어, 빠른 도움을 위한 활성 채팅.
- **WeChat** – 중국어 사용자를 위한 QR 코드 제공.
- 기여는 환영합니다. 가이드라인은 `CONTRIBUTING.md`를 참조하세요. 프로젝트는 표준 Swift 패키지 구조를 사용하므로, 새로운 에이전트나 터미널을 추가하기 쉽습니다.

---

### 빠른 참조 체크리스트
- ✅ 오픈소스 (GPL‑v3) – 포크하거나 수정 가능.
- ✅ 서버 없음, 텔레메트리 없음 – 모든 작업은 Mac에서 로컬로 수행.
- ✅ 네이티브 SwiftUI/AppKit – Electron 오버헤드 없음.
- ✅ 13개의 주요 AI 코드 생성 에이전트와 15개 이상의 터미널/IDE 지원.
- ✅ Sparkle를 통한 자동 업데이트.
- ✅ 국제화 (EN/zh‑CN).

---

**결론** – Open Island는 개발자가 AI 코드 생성 에이전트를 위한 가벼운, 항상 보이는 대시보드를 갖게 해주는 진정한 오픈소스 macOS 동반자로, 워크플로우를 로컬에 유지하고, 빠르며 사용자가 완전히 제어할 수 있도록 합니다.