PikaTokenBar
코딩하면 포켓몬이 자랍니다
01 · Hatch
알이 깨지는 순간
메뉴바에서 실제로 일어나는 일입니다 — 토큰을 쓰면 알이 흔들리고, 임계치를 넘으면 부화합니다.
후보는 진화 계보 시작점 78종이고, 뽑기 가중치는 PokéAPI 의 실제 capture_rate 입니다 —
실제 앱과 같은 확률이라 피카츄가 나올 확률은 1.71% 뿐입니다.
부화한 포켓몬은 아래 도감에 그대로 등록됩니다.
02 · Evolve
토큰을 쓸수록 진화합니다
스크롤해 보세요. 아래 임계값은 앱이 실제로 쓰는 값입니다.
최종 진화 후 1.5B 토큰을 더 쓰면 도감에 졸업하고 새 알이 시작됩니다 — 희귀 등급 3형태 라인의 졸업 총량은 3B 토큰입니다.
03 · Dex
1세대 151종
잡지 않은 칸은 실루엣과 ??? 로만 보입니다. 잡은 칸에 마우스를 올리거나(모바일은 탭) 눌러 보세요.
이 도감은 페이지 데모용 샘플입니다 — 방문자의 실제 저장 파일이 아니고, 새로고침하면 초기화됩니다. 위에서 부화시킨 포켓몬만 여기에 추가됩니다.
04 · Item
설치
Homebrew 를 쓰신다면 이쪽이 편합니다 — brew upgrade 에 함께 묻어갑니다.
brew install --cask LuceteYang/tap/pika-token-bar
Homebrew 가 없다면 설치 스크립트를 쓰세요. 같은 명령이 업데이트도 겸합니다.
curl -fsSL https://github.com/LuceteYang/PikaTokenBar/releases/latest/download/install.sh | bash
어느 쪽이든 Gatekeeper 격리 속성까지 해제됩니다. 새 버전이 나오면 앱이 알려줍니다.
05 · Info
요구사항
- macOS 14 이상
- Apple Silicon, Intel 모두 지원
메뉴바는 원하는 대로
- 대표 포켓몬 — 도감에서 잡은 종을 골라 메뉴바에 고정할 수 있습니다. 키우는 포켓몬은 그대로 자랍니다.
- 애니메이션 품질 — 부드러움과 배터리 사이에서 세 단계 중 하나를 고릅니다.
- 포켓몬 성장률 — 알의 부화나 다음 진화·졸업까지의 진행률을 메뉴바에 % 로 띄웁니다(설정 → 메뉴바에 표시).
공식 한도, 팝업 없이
- 설정 → 고급에 claude.ai
sessionKey를 붙여넣으면 Keychain 접근 팝업 없이 공식 5시간·주간 한도를 가져옵니다. - 자동 갱신에도 적용되므로 한도가 옛 값으로 멈추지 않습니다. 키를 넣지 않으면 기존 방식 그대로 동작합니다.
- Claude·Codex 에 더해 Antigravity 2.0·IDE 의 공식 한도도 모델군별 5시간·주간으로 함께 표시합니다.
- OpenCode Go 의 5시간·주간·월간 사용 한도와 Grok CLI 의 주간 구독 크레딧도 표시합니다. 보이는 한도는 도구의 로그인·구독 상태에 따라 다릅니다.
최근 사용량을 하루씩
- 주간·월간 합계 아래에 하루당 막대 하나 — 기간은 막대 차트 제목이나 설정 → 일반에서 최근 7·14·21일 또는 이번 달 중에 고릅니다(기본 14일). 날짜 축과 주말 밑줄로 어느 막대가 어느 날인지 읽히고, 캡션은 가리킨 날(기본은 오늘)의 날짜·요일·사용량을 보여줍니다.
- 도구가 이미 써 놓은 로그에서 파생되므로, 업데이트 직후 첫 갱신에 고른 기간이 채워집니다. 오늘부터 새로 쌓기 시작하지 않습니다.
- 감지된 모든 도구의 사용량을 합산합니다. 일별을 못 주는 도구가 섞여 있어도 나머지는 그대로 표시됩니다.
- 도구가 둘 이상이면 막대가 도구별로 쌓입니다 — 도구마다 색이 고정되고 축 아래 범례에 이름이 나오며, 막대에 마우스를 올리면 그날의 도구별 내역이 보입니다.
- 차트를 클릭하면 최근 16주를 하루 한 칸으로 보는 격자로 바뀝니다 — 많이 쓴 날일수록 진하고, 격자는 막대 기간과 상관없이 16주를 보여줍니다.
포켓몬마다 개체가 다릅니다
- 도감에서 종을 열면 그 개체의 레벨·성별·성격·특성·개체값(IV)·실제 능력치·배운 기술까지 한 화면에서 볼 수 있습니다.
- 종 설명·특성·기술 이름은 선택한 언어로 표시되고, PokéAPI에 번역이 없는 항목만 영어로 남습니다.
- 도감과 포획 기록은 이름이나 번호로 검색하고, 정렬하고, 희귀도·이로치로 거를 수 있습니다. 도감 번호는 희귀도 색으로 표시되고, 상세에서 뒤로 가면 보던 도감 페이지나 포획 기록 행으로 돌아옵니다.
성장 속도는 직접 정합니다
- 설정 → 난이도에서 성장 임계와 상점 가격을 각각 10%~200%로 조절합니다. 슬라이더는 초안만 바꾸고 저장을 눌러야 적용되며, 지금까지 쌓인 진행도는 난이도를 바꿔도 그대로 유지됩니다.
- 이미 졸업시킨 진화 라인이 다시 부화하면 2배 빠르게 자랍니다.
Claude 계정이 여러 개여도 따로 봅니다
- 설정 폴더(CLAUDE_CONFIG_DIR)마다 로그인한 Claude Code 계정은 공식 한도 아래에 각자의 탭이 생기고, 게이지·이상한 사탕·알림·오늘/이번 달 토큰을 따로 보여 줍니다.
- ~/.claude-* 폴더와 export 된 CLAUDE_CONFIG_DIR 은 자동으로 찾고, 다른 위치는 설정 → 고급에서 추가합니다. 메뉴바 한도 %와 컴패니언 기분은 마지막으로 쓴 계정을 따릅니다.
- 계정마다 claude.ai 세션 키를 따로 넣을 수 있어(설정 → 고급), Keychain 없이도 그 계정의 한도가 계속 갱신됩니다.
한도는 총량이 아니라 페이스로 읽습니다
- 각 한도 막대에 고르게 썼다면 지금쯤 도달했을 지점을 얇은 눈금으로 표시합니다. 채움이 눈금을 넘으면 리셋 전에 바닥난다는 뜻입니다.
- Cursor 에 로그인돼 있으면 이번 달 포함 사용량(사용률·남은 금액·auto/API 구분)도 공식 한도에 나옵니다.
- 막대와 퍼센트는 페이스에 따라 6단계로 색이 바뀝니다 — 한참 여유로우면 파랑, 페이스대로면 초록, 한참 빠르면 빨강.
지난 한 주·한 달·한 해를 돌아봅니다
- 팝오버의 돌아보기 버튼을 누르면 이번 주·달·해를 포켓몬 도감 스타일 카드로 보여 주고, 화살표로 이전 기간으로 넘길 수 있습니다.
- 합계, 날마다의 게이지, 이전 기간 대비 변화, 최고의 날, 최장 연속, 그 기간에 졸업한 포켓몬이 나옵니다. 기록은 올해와 작년분을 로컬에 보관합니다.
- 이틀 이상 연속으로 쓰면 돌아보기 버튼 옆 불꽃에 연속 일수가 나옵니다. 오늘 첫 사용으로 이어가기 전에는 회색입니다.
플로팅 펫과 놀기
- 포인터를 올려 쓰다듬으면 하트가 뜨고, 알을 클릭하면 부화를 기도합니다. 가끔 삐져서 등을 돌리거나 작은 이벤트 말풍선을 띄웁니다 — 모두 꾸밈이라 부화 확률이나 성장에는 영향이 없습니다.
- 코딩 에이전트가
pikatokenbar://링크를 열면 펫이 반응합니다 — 작업 중엔 들썩이고, 입력이 필요하면 말풍선으로 부르고, 끝나면 커서로 달려옵니다. 훅 설정은 README 를 보세요. - 설정 → 플로팅 펫의 뒷모습 보기를 켜면 메뉴바·플로팅 펫·팝오버에서 항상 등을 보여줍니다.
세이브는 알아서 백업됩니다
- 최소 12시간마다 로컬 스냅샷을 남기고 최근 10개를 보존합니다. 설정 → 백업 & 이전에서 골라 바로 복원할 수 있고, 백업 기록은 접힌 채로 열려 펼쳐서 봅니다.
- 세이브 파일이 깨져 불러오지 못하면 따로 보관한 뒤 최신 스냅샷에서 복구합니다 — 빈 상태로 다시 시작하지 않습니다.
손이 덜 가게
- 메뉴바 아이콘을 우클릭(또는 Control-클릭)하면 팝오버를 열지 않고 오늘 합계를 보고, 새로고침·도감·설정·플로팅 펫·종료를 고릅니다.
- 상점 아이템을 여러 개 한꺼번에 사고, 가방이 비어 있으면 상점으로 바로 갑니다. 홈과 도감 상세엔 게임 색상의 타입 배지가 붙습니다.
- 도감은 스크롤 휠로 넘기고, 컴패니언 스프라이트를 클릭하면 그 도감 항목이 열립니다. UI 언어에 러시아어가 더해졌습니다.
- 설정 → 추적할 프로바이더에서 도구를 끄면 그 도구는 읽지 않고 탭·합계·포켓몬 성장·한도에서 빠집니다.
원본과 함께 쓸 수 있습니다
- 별도의 앱으로 설치됩니다 — 원본 PokeTokenBar와 나란히 실행할 수 있습니다.
- 데이터도 분리되어 있어 서로 영향을 주지 않습니다.
- 지울 것도 없습니다 — 필요 없어지면 그냥
/Applications에서 앱을 삭제하면 됩니다.
서명 안내
- 자체 서명(self-signed) 앱이며 공증(notarize)되어 있지 않습니다.
- 위 설치 스크립트가 Gatekeeper 격리 속성(quarantine attribute)을 자동으로 해제합니다.
지원 도구
- Claude Code
- Codex
- Gemini CLI
- Antigravity
- OpenCode
- Hermes Agent
- Cursor
- Grok CLI
- Copilot CLI
- Kiro CLI
- Pi Agent
- omp
- omo
- Aside
- Kimi Code
- Devin CLI
전부 로컬에서 읽으며 외부 CLI가 필요 없습니다.
로그가 기본 위치 밖에 있다면 설정 → 고급에서 프로바이더별로 스캔 폴더를 추가할 수 있습니다.