TOKENPHAGE

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

👾 TokenPhage란?

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

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

gpu · dark	claude · light
`https://api.tokenphage.com/badge/kobenlys?theme=gpu&mode=dark`	`https://api.tokenphage.com/badge/kobenlys?theme=claude&mode=light`
grass-claude · light
`https://api.tokenphage.com/badge/kobenlys?theme=grass-claude`
grass-claude · dark
`https://api.tokenphage.com/badge/kobenlys?theme=grass-claude&mode=dark`

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

📦 아래는 빠른 시작 요약이에요.
화면별 자세한 사용법·인증 절차·자동 동기화 설정은 👉 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-username>)](https://github.com/TOKENPHAGE)

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

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

TokenPhage는 토큰 "수치"만 봅니다 — 여러분의 프롬프트·코드·파일 내용은 읽지도, 보내지도 않습니다.

📖 로컬에서 읽는 것 — Claude Code(~/.claude/…)·Codex(~/.codex/…)·opencode(~/.local/share/opencode/…) 사용 기록에서 날짜·모델·토큰 개수만 추출합니다. 대화 내용·소스코드·파일명·프로젝트명은 파싱 대상이 아닙니다.
☁️ 서버로 보내는 것 — 날짜별·모델별 토큰 합계와 익명 기기 식별자(무작위 UUID)뿐입니다. (예: 2026-07-19 · claude-sonnet-5 · input 12,345 …)
🔑 로그인 — 비밀번호·OAuth 없이 공개 Gist 소유권으로만 인증합니다. GitHub 사용자명(공개 정보)과 Gist ID만 서버에 전달됩니다.
💾 로컬 저장 — 인증 토큰·기기ID·동기화 상태는 ~/.tokenphage/config.json(소유자 전용 0600)에 보관됩니다.
🗑️ 삭제 — 대시보드 → Reset all data로 서버 데이터를 언제든 전부 지울 수 있습니다.

요약: 무엇을 얼마나 썼는지(토큰 수) 만 집계하고, 무엇을 만들었는지(내용) 는 절대 보지 않습니다.

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

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