CodeIsland 소개
CodeIsland는 MacBook의 노치(Notch) 영역에 상주하면서 AI 코딩 에이전트들이 지금 무엇을 하고 있는지 실시간으로 보여주는 macOS 앱입니다. Claude Code가 권한 승인을 기다리는지, Codex가 작업을 끝냈는지 확인하려고 창을 오가는 일을 없애는 것이 목표입니다. 여러 에이전트를 동시에 띄워 두고 일하는 개발자라면 각 세션의 상태를 화면 상단 한 곳에서 파악할 수 있습니다.
동작 원리는 유닉스 소켓 기반 IPC입니다. Claude Code, Codex, Gemini CLI, Cursor, Copilot, Cline, OpenCode는 물론 TraeCli, Qoder, Factory, CodeBuddy, Kimi Code CLI, Pi(Oh My Pi)까지 총 13종의 AI 코딩 도구에 훅(hook)을 자동 설치하고, 각 도구에서 발생하는 세션 시작, 도구 호출, 권한 요청 같은 이벤트를 소켓으로 받아 픽셀 아트 스타일의 컴팩트한 패널에 표시합니다. 패널에서 바로 권한을 승인하거나 거부할 수 있고, 에이전트가 던진 질문에 현재 작업 중인 앱을 떠나지 않고 답할 수도 있습니다.
Swift로 작성된 오픈소스 프로젝트이며 macOS 14(Sonoma) 이상에서 동작합니다. 세션을 클릭하면 해당 터미널 탭이나 IDE 창으로 바로 이동하는 원클릭 점프, 도구별 픽셀 아트 마스코트, 8비트 효과음 같은 요소도 갖추고 있습니다. 프로젝트 소개에 따르면 claude-island에서 영감을 받아 시작되었고, 영어와 중국어 UI를 시스템 언어에 맞춰 자동 선택합니다.
CodeIsland의 동작 방식
README의 How It Works 섹션은 이벤트가 노치 패널까지 도달하는 경로를 다음 흐름으로 설명합니다.
AI Tool (Claude/Codex/Gemini/Cursor/...)
→ Hook event triggered
→ codeisland-bridge (native Swift binary, ~86KB)
→ Unix socket → /tmp/codeisland-<uid>.sock
→ CodeIsland app receives event
→ Updates UI in real time
→ Optional local Buddy sync to iPhone / Apple Watch
CodeIsland는 각 AI 도구의 설정에 가벼운 훅을 설치합니다. 도구가 세션 시작, 도구 호출, 권한 요청 같은 이벤트를 발생시키면 훅이 JSON 메시지를 유닉스 소켓으로 보내고, 소켓을 듣고 있던 앱이 노치 패널을 즉시 갱신합니다. OpenCode의 경우에는 브리지 바이너리 없이 JS 플러그인이 소켓에 직접 연결됩니다. 훅 설치는 감지된 CLI 도구 전체에 자동으로 이루어지며, 자동 복구와 버전 추적도 지원합니다 (README §Features).
CodeIsland의 주요 기능
패널은 평소에는 노치 뒤에 접혀 있다가 필요할 때 펼쳐지는 노치 네이티브 UI입니다. 활성 세션과 도구 호출, AI 응답을 실시간으로 추적하고, 권한 요청이 오면 승인 카드가 떠서 패널에서 바로 처리할 수 있습니다. 단축키도 지원해서 ⌘⇧I로 패널을 여닫고, 설정에서 켜면 ⌘⇧A/⌘⇧D로 현재 권한 요청을 승인하거나 거부할 수 있습니다 (README §Keyboard Shortcuts).
알림 억제도 단순한 앱 단위가 아니라 탭 단위로 동작합니다. 터미널 앱을 보고 있다는 이유만으로 알림을 숨기지 않고, 해당 세션이 열린 바로 그 탭을 보고 있을 때만 알림을 억제하는 스마트 억제(smart suppress) 기능입니다. 외장 모니터 환경에서는 노치가 있는 디스플레이를 자동 감지합니다.
iPhone의 다이나믹 아일랜드(Dynamic Island)와 잠금 화면, 대기 모드(StandBy), 그리고 Apple Watch로 세션 상태를 미러링하는 동반 앱 "Code Island Buddy" 도 App Store에 무료로 공개되어 있습니다. iPhone 앱이 실행 중인 동안 Mac 앱이 로컬 네트워크로 가벼운 세션 스냅샷을 전송하고, Live Activity나 워치 갱신 같은 백그라운드 갱신에는 블루투스 요약을 사용합니다. 계정이나 외부 서버가 필요 없으며, 동반 앱의 소스 코드도 같은 저장소의 ios/CodeIslandCompanion 및 apple-companion 디렉토리에 공개되어 있습니다 (README §iPhone & Apple Watch Buddy).
세부 동작은 7개 탭으로 나뉜 설정 패널에서 조정합니다. 언어와 로그인 시 자동 실행, 표시할 디스플레이(일반), 자동 숨김과 스마트 억제, 세션 정리(동작), 패널 높이와 글자 크기(외관), 마스코트, 8비트 사운드, 훅 설치 상태 확인 및 재설치(훅) 등이 여기에 포함됩니다. 단축키도 모두 사용자 지정이 가능하며, 항상 허용이나 질문 건너뛰기, 터미널로 점프 같은 동작을 추가로 할당할 수 있습니다 (README §Settings).
CodeIsland 설치 방법
권장 설치 경로는 Homebrew입니다.
brew tap wxtsky/tap
brew install --cask codeisland
수동 설치는 Releases 페이지에서 CodeIsland.dmg 를 내려받아 응용 프로그램 폴더에 끌어다 놓으면 됩니다. 첫 실행 시 macOS 보안 경고가 뜨면 시스템 설정의 개인정보 보호 및 보안에서 열기를 허용해야 합니다. 실행하면 감지된 AI 도구들의 훅을 자동으로 설치합니다. 소스 빌드는 macOS 14 이상과 Swift 5.9 이상이 필요하며, 저장소를 클론한 뒤 swift build 또는 릴리즈용 ./build.sh 로 진행합니다 (README §Installation).
CodeIsland의 라이선스
CodeIsland는 MIT 라이선스로 공개되어 있어 개인 및 상업적 목적으로 자유롭게 사용할 수 있습니다.
CodeIsland 프로젝트 GitHub 저장소
Code Island Buddy 앱 다운로드 (App Store)
이 글은 GPT 모델로 정리한 글을 바탕으로 한 것으로, 원문의 내용 또는 의도와 다르게 정리된 내용이 있을 수 있습니다. 관심있는 내용이시라면 원문도 함께 참고해주세요! 읽으시면서 어색하거나 잘못된 내용을 발견하시면 덧글로 알려주시기를 부탁드립니다. 
파이토치 한국 사용자 모임
이 정리한 이 글이 유용하셨나요? 회원으로 가입하시면 주요 글들을 이메일
로 보내드립니다! 텔레그램(Telegram)이나 Slack/Discord/Teams/Dooray/GoogleChat 등으로도 새 글 알림을 받으실 수 있습니다. 
아래
쪽에 좋아요
를 눌러주시면 새로운 소식들을 정리하고 공유하는데 힘이 됩니다~ 