당신이 AI를 얼마나 굴렸는지, 프로필 한 장으로 증명하세요.

토큰을 쌓을수록 마스코트가 진화하는 GitHub README 배지 👾

---

👾 TokenPhage란?

GitHub 잔디가 당신의 커밋을 보여주듯, TokenPhage는 Claude Code·Codex·opencode로 태운 토큰을 당신의 AI 활용 스탯으로 보여줍니다.

누적 토큰·모델별 집계·30일 히트맵을 배지 한 장에 담고, 토큰을 쌓을수록 마스코트가 Lv.1 → Lv.5로 진화합니다. README에 한 줄 붙이면 끝 — 그다음은 매일 자동으로 갱신됩니다.

gpu · dark	claude · light
[](https://github.com/TOKENPHAGE)	[](https://github.com/TOKENPHAGE)
grass-claude · light
[](https://github.com/TOKENPHAGE)

🎫 그 외 다양한 배지(베타 테스터 배지 · 마스코트 레벨 · 색상 모드)를 보고 싶다면 → 배지 카탈로그(BADGES.md)

🎫 배지 한 장에 담기는 정보

• 🔥 누적 토큰 사용량
• 📅 최근 30일 히트맵
• 📊 모델별 집계
• 👾 레벨 마스코트
• ➕ 그 외 다양한 정보 (ETC)

✨ 배지에 담기는 정보와 기능은 테마마다 다르며, 앞으로 새로운 테마가 계속 추가됩니다. ✨

---

🚀 시작하기 & 사용법

📦 아래는 빠른 시작 요약이에요.
화면별 자세한 사용법·인증 절차·자동 동기화 설정은 👉 tokenphage-cli 레포 에 정리돼 있습니다.

1️⃣ 설치 — Node.js 20.17+

npm install -g tokenphage@latest

2️⃣ 실행하고 로그인

tokenphage

실행하면 대화형 화면(TUI)이 뜹니다. Authenticate with Gist 를 고르면 공개 Gist 소유권만으로 로그인되고(비밀번호·OAuth 불필요), 첫 동기화까지 자동으로 끝납니다.

3️⃣ 배지 붙이기 — GitHub 프로필이나 레포 README에 한 줄:

[![Tokenphage](https://api.tokenphage.com/badge/<your-github-name>)](https://github.com/TOKENPHAGE)

로그인 후에는 같은 화면에서 지금 동기화 · 매일 04:00 자동 동기화 켜기/끄기 · 데이터 초기화(Reset) 를 모두 다룰 수 있어요.

💡 로그인 직후, Claude Code가 오래된 기록을 자동 삭제(cleanupPeriodDays)해 과거 토큰이 누락되지 않도록 기록 영구 보존을 켤지 물어봅니다. Yes로 두면 모든 토큰이 빠짐없이 집계됩니다.

---

🎨 테마 & 레벨

배지는 쿼리 파라미터로 외형(테마·색상)을 바꿀 수 있습니다. 테마마다 담기는 정보와 표현 방식이 다르며(마스코트 진화 · 잔디 그리드 등), 새 테마는 계속 추가됩니다.

[![Tokenphage](https://api.tokenphage.com/badge/<your-github-name>?theme=claude&mode=dark)](https://github.com/TOKENPHAGE)

🎫 사용 가능한 theme · mode 값과 테마별 미리보기는 → 배지 카탈로그(BADGES.md)

⏱️ 배지는 60분간 캐시됩니다. 방금 동기화했다면, 최신 수치가 배지에 반영되기까지 최대 1시간 걸릴 수 있어요.

---

_{MIT License · 토큰을 먹일수록 마스코트는 자랍니다 👾}