ericjypark/codex-island

해결하는 문제

CodexIsland는 사용자가 Claude Code 및 Codex의 AI 사용 제한을 실시간으로 추적할 수 있게 해주는 macOS 네이티브 오버레이입니다. 여러 공급업체의 사용 할당량을 수동으로 확인해야 하는 번거로움을 해결하며, 이러한 지표를 MacBook의 노치(또는 메뉴 막대)에 직접 통합하여 지속적이고 낮은 간섭으로 가시성을 제공합니다.

작동 방식

이 앱은 로컬 우선 오버레이로 작동합니다. Claude Code 및 Codex 명령줄 도구(~/.codex/auth.json 또는 macOS Keychain 등)에서 기존 인증 정보를 읽어와 공급업체의 사용량 엔드포인트를 호출합니다. 인증 정보 자체를 저장하지는 않지만, 로컬 SQLite 데이터베이스를 유지하여 토큰 수와 사용 기록을 장기적으로 추적합니다.

대상 사용자

5시간 및 주간 사용량을 모니터링하고, 로컬 로그를 기반으로 API 비용을 추정하며, macOS에서 장기적인 AI 소비 패턴을 시각화하고자 하는 Claude Code 및 Codex 개발자와 파워 유저를 위한 도구입니다.

주요 특징

• 노치 네이티브 디자인: 하드웨어 노치와 일치하는 Dynamic Island 스타일의 오버레이를 제공하며, 노치가 없는 디스플레이를 위한 대체 모드도 지원합니다.
• 다중 공급업체 추적: Claude와 Codex의 사용량을 5시간 및 7일 단위로 모니터링합니다.
• 비용 추정: Claude Code, Codex CLI, OpenCode의 로컬 세션 로그를 사용하여 예상 지출 및 토큰 처리량을 계산합니다.
• 사용량 시각화: 연간 활동을 보여주는 기여도 스타일의 달력과 누적 차트가 포함된 공유 가능한 사용량 카드를 제공합니다.
• 개인정보 보호 중심: 원격 측정, 충돌 보고, 프록시 서비스가 없으며 모든 집계 및 렌더링은 기기 내에서 수행됩니다.
• 사용자 지정 알림: 제한에 가까워지면 아일랜드 색상을 변경하는 경고 및 임계값 설정을 지원합니다.