poketokenbar

PokeTokenBar는 AI 코딩 토큰 사용량을 포켓몬 동반자로 바꿔 게임화하는 macOS 메뉴 바 앱입니다. Claude Code, Codex, Gemini CLI, Antigravity, OpenCode, Hermes Agent, Cursor, Grok CLI, Copilot CLI, Kiro CLI, Pi Agent, omp, Aside의 사용량을 로컬 로그를 직접 읽어 추적합니다—외부 CLI가 필요 없습니다. **핵심 메커니즘:** - 🥚 **부화**: 사용한 토큰이 알을 품어 1–5세대 포켓몬(329가지 시작 가능)으로 부화하며, 공식 포획률로 가중치가 적용됩니다—전설은 희귀합니다(129분의 1). 각 부화는 25가지 성격 중 하나를 굴리고, 희귀 확률로 ✨ 이로치가 나옵니다. - ⚡ **진화**: 계속 코딩하면 실제 진화 트리(1/2/3단계, 분기)를 따라 포켓몬이 성장하며, 각 단계마다 화려한 축하 효과가 나타납니다. - 🎓 **졸업 및 수집**: 최종 형태 + 임계값에 도달하면 영구적으로 도감에 보관되고(희귀할수록 더 오래 걸림: 흔함 약 3일 → 전설 약 24일, 과다 사용 기준), 새 알이 도착합니다. - 🍬 **이상한사탕**: 5시간 또는 주간 사용 한도를 채우면 이상한사탕을 얻고, 가방에서 사용해 현재 포켓몬을 성장시킬 수 있습니다. - 🛒 **상점**: 사용한 토큰이 이상한사탕, 민트(성격 재추첨), 이로치 부적(이로치 확률 영구 상승), 알(포켓몬 알, 언커먼 알, 레어 알)을 사는 화폐가 되어 새로 시작할 수 있습니다. **기능:** - **메뉴 바**: 오늘 총 토큰 옆에 애니메이션 5세대 스프라이트(간단 형식 예: `200.7M`), 선택적으로 비용 또는 한도 퍼센트 표시. - **떠 있는 데스크톱 펫**: 동반자를 데스크톱에 원하는 크기(48–384px)로 놓을 수 있고, 호버 설명, 클릭하여 열기, 우클릭 메뉴, 말풍선 한도 알림을 지원합니다. - **도감 및 포획 로그**: 종당 한 칸(페이지당 24개, 도감 번호 순, 이로치는 ✨), 전체 진화 계보, 희귀도, 성격, 포획 날짜가 있는 포획 로그. - **공식 한도**: Claude, Codex, Antigravity의 5시간/주간 사용률을 재설정 카운트다운과 소진율 예측과 함께 추적합니다. - **모델별 분석**: 여러 모델이 세션 로그를 공유할 때 Pi Agent 사용량을 실제 모델 ID에 귀속시킵니다. - **설정**: 메뉴 바 항목, 새로 고침 간격(1–15분 또는 수동), 로그인 시 실행, Keychain 선택 해제, 임계값이 있는 한도 알림, 동반자 알림, 전체 KO/EN/JA/ES/FR/PT/DE UI 및 포켓몬 이름. - **성장 난이도**: 임계값과 상점 가격을 10%에서 200%까지 조정; 이미 졸업한 계보의 부화는 2배 빠르게 성장합니다. - **일일 차트**: 일별 토큰(및 비용)을 보여주는 간단한 월간 차트. - **추가 스캔 폴더**: 내장 경로 밖의 로그를 지정(제공자별, 와일드카드 지원). - **claude.ai 세션 키**: Keychain 접근 없이 공식 한도를 위해 선택적으로 붙여넣기. - **저전력 모드**: 메뉴 바 애니메이션이 절전 품질로 계속됩니다. - **앱 내 업데이트**: 원클릭 업데이트 확인. **지원 도구 및 추적:** | 도구 | 추적 | 공식 한도 | |---|---|---| | Claude Code | 오늘 · 5시간 블록 · 주 · 월 | ✅ 5시간 / 주간 | | Codex | 오늘 · 주 · 월 | ✅ 5시간 / 주간 | | Gemini CLI | 오늘 · 주 · 월 | — | | Antigravity | 오늘 · 5시간 블록 · 주 · 월 | ✅ 5시간 / 주간 | | OpenCode | 오늘 · 5시간 블록 · 주 · 월 | — | | Hermes Agent | 오늘 · 5시간 블록 · 주 · 월 | — | | Cursor | 오늘 · 5시간 블록 · 주 · 월 | — | | Grok CLI | 오늘 · 5시간 블록 · 주 · 월 | — | | Copilot CLI | 오늘 · 5시간 블록 · 주 · 월 | — | | Kiro CLI | 오늘 · 5시간 블록 · 주 · 월 | — (추정) | | Pi Agent | 오늘 · 5시간 블록 · 주 · 월 | — | | omp (oh-my-pi) | 오늘 · 5시간 블록 · 주 · 월 | — | | Aside | 오늘 · 5시간 블록 · 주 · 월 | — | **데이터 소스:** 각 도구의 표준 경로에서 로컬 로그(JSONL, SQLite 등)를 읽고, 종/진화 데이터와 스프라이트를 위해 PokéAPI를 사용합니다(런타임에 가져와 로컬 캐시). 공식 한도는 비공식 엔드포인트(Anthropic, codex app-server, Antigravity Google APIs)를 사용하며 Keychain 접근은 수동 새로 고침 시에만 합니다. **개인정보:** 기기 우선—사용량 업로드 없음. 외부 요청은 12개 호스트(PokéAPI, GitHub 스프라이트, Anthropic, claude.ai, cursor.com, Google APIs, 상태 페이지, GitHub 업데이트 확인)로 가지만 사용 로그, 프롬프트, 프로젝트 경로를 절대 포함하지 않습니다. Keychain은 선택 사항이며 수동 새로 고침 시에만 읽습니다. **설치:** macOS 14+ (Apple Silicon 또는 Intel). Homebrew cask(`brew install --cask chattymin/tap/poke-token-bar`), 수동 zip 다운로드, 또는 Swift 6로 소스에서 빌드. Ad-hoc/자체 서명이므로 첫 실행 시 Gatekeeper 경고가 뜹니다(우클릭 → 열기 또는 `xattr -dr com.apple.quarantine`로 해제). **라이선스:** MIT(원본 소스 코드에만 적용; 포켓몬 자산은 번들되지 않음—런타임에 가져옴). 비공식, 비상업적 포켓몬 팬 프로젝트.