chattymin/PokeTokenBar

해결하는 문제

PokeTokenBar는 macOS 메뉴바 앱으로, AI 코딩 토큰 사용량을 게임화된 포켓몬 수집 경험으로 바꾸는 도구입니다. 지루한 대시보드나 브라우저 탭을 확인하는 대신, 사용자가 실제로 사용하는 여러 AI 도구(예: Claude Code, Cursor, Gemini CLI 등)의 토큰 사용량을 기반으로 성장하는 포켓몬 동반자와 포켓몬 도감을 채워나갈 수 있습니다.

작동 방식

이 앱은 다양한 AI 코딩 도구의 로컬 로그 및 SQLite 데이터베이스에서 직접 토큰 사용량 데이터를 읽어옵니다. 오늘의 사용량, 비용, 공식 사용 제한(5시간 제한 또는 주간 제한 등)을 계산한 후 게임화 시스템에 매핑합니다:

• 알 부화 및 진화: 토큰 사용량이 알을 부화시키고, 지속적인 코딩은 실제 진화 라인에 따라 진화를 유도합니다.
• 보상: 사용 제한에 도달하면 '희귀 사탕'을 얻을 수 있으며, 이는 성장을 가속화하는 데 사용할 수 있습니다.
• 경제 시스템: 사용한 토큰은 앱 내 상점에서 통화로 사용되며, 반짝이는 캐릭터(희귀 부화 확률 증가)나 민트(성격 재랜덤화)와 같은 아이템을 구매할 수 있습니다.
• 시각화: 동반자는 메뉴바에 고정되거나, 떠다니는 데스크톱 펫으로도 사용할 수 있습니다.

대상 사용자

macOS에서 다양한 AI 코딩 보조 도구를 사용하는 개발자 중, 토큰 소비와 할당량 제한을 시각적이고 보상적인 방식으로 모니터링하고 싶은 사람.

주요 특징

• 광범위한 도구 지원: Claude Code, Codex, Gemini CLI, Antigravity, OpenCode, Hermes Agent, Cursor, Grok CLI, Copilot CLI, Kiro CLI, Pi Agent, omp, Aside 등 지원.
• 로컬 데이터 읽기: 외부 CLI 필요 없음. 로컬 세션 파일 및 데이터베이스에서 직접 읽기.
• 공식 제한 추적: 지원되는 도구의 5시간 제한 및 주간 사용량을 모니터링하며, 리셋 카운트다운과 소비 속도 예측 제공.
• 심층적인 게임화: 완전한 포켓몬 도감, 반짝이는 포켓몬, 성격 랜덤화, 토큰 사용량 기반 상점 포함.
• 사용자 정의 가능: 로그용 사용자 정의 스캔 폴더 및 성장 난이도 조정 가능.