Tokenova — AI 코딩으로 쓴 토큰이 매일 하나의 우주가 되는 트레이 앱

Tokenova — 매일 새로운 우주가 열리는 코딩 트래커

Tokenova — AI 코딩으로 쓴 토큰이 매일 하나의 우주가 되는 트레이 앱

저녁공작료 하루를 Claude Code로 코딩하고 나면 궁금해지는 게 하나 있다. 오늘 내가 진짜 얼마나 토큰을 소비했을까. 대시보드를 띄우자니 무겁고, 빌링 페이지를 열자니 일하는 흐름이 끊긴다. 이 문제를 깔끔하게 해결한 앱이 있다. 바로 Tokenova다.

---

Tokenova란 무엇인가

Tokenova는 메뉴바(macOS) 또는 시스템 트레이(Windows·Linux)에 작은 행성 아이콘 하나로 떠 있는 Tauri 앱이다. 백그라운드에서 Claude Code, Codex CLI, OpenCode가 남기는 로컬 로그를 읽어 그날의 토큰 사용량을 별과 행성으로 그려준다. 자정이 지나면 그 우주는 닫히고, 새 캔버스가 열린다. 매일 매일이 다른 우주인 셈이다.

---

동작 방식을 이해하자

별 시스템

누적 토큰 20만 개마다 별이 하나씩 뜬다. 첫 별이 뜨면 별도로 업적도 하나해된다. 별의 모양은 12종이며, 시드로 결정되어 매번 다르다.

행성 시스템

아래 두 조건 중 하나라도 만족하면 행성이 강제 트리거된다:

• 단일 세션이 100만 토큰을 넘으면서 끝남

• 한 세션이 2000만 토큰을 누적함

31종 카탈로그에서 등급 룰렛으로 추첨된다. 확률은 다음과 같다:

등급	확률
Common	70%
Rare	20%
Epic	8%
Legendary	1.9%
Mythic	0.1%

Mythic에 해당하면 화면 가득 슬라이드 인 되는 풀스크린 오버레이가 뜬다. 다이슨 구체나 블랙홀이 뜨면 OS가 직접 트레이 알림으로 알려준다. 의외로 작은 보상이 된다.

은하 레이아웃

매일 시드에 따라 6종 레이아웃 중 하나를 그린다:

• 나선

• 타원

• 불규칙

• 쌍성단

• 산개

• 핵중심

같은 시드는 같은 모양으로 재현되므로, 과거 우주를 갤러리에서 다시 열어도 똑같이 보인다.

별자리 기능

Today 탭에서 별을 클릭으로 직접 잇는다. 2개부터 등록 가능하며, 이름은 자동 생성하거나 직접 붙일 수 있다. 코덱스에 영구 보관된다.

잠든 우주

토큰을 한 톨도 안 쓴 날은 별 캔버스 대신 부드러운 달과 별이 뜬다. 별도의 "잠든 우주" 업적도 존재한다.

---

왜 이걸 쓰면 재미있는가

매일 다른 모양

시드 + 레이아웃 + 룰렛 결과가 그날의 우주를 결정한다. 어제는 나선이었는데 오늘은 핵중심. 같은 5000줄을 짜도 별 분포가 매번 달라서 갤러리를 넘기는 재미가 있다.

등급 확률의 도파민

Mythic 0.1%에 해당하는 행성이 뜨면 화면 가득적 오버레이가 등장한다. 이를 노리고 일하는 건 아니지만, 모르게 본 게 그 자체로 작은 보상이 된다.

365일 갤러리

1주, 1개월, 1년 히트맵으로 자신의 코딩 리듬을 볼 수 있다. 잠든 날, 폭주한 날, 거대 은하가 만들어진 날이 다 캔버스로 보존되어 있고, 클릭하면 그날의 우주가 다시 재생된다.

---

기술적 구현

지원 도구별 모니터링

Tokenova는 세 채널을 동시에 모니터링한다:

• Claude Code: ~/.claude/projects/*.jsonl을 notify로 watch

• Codex CLI: ~/.codex/sessions/YYYY/MM/DD/*.jsonl을 watch

• OpenCode: opencode.db SQLite를 5초 간격으로 폴링

세 채널을 동일한 TokenEvent로 정규화해 SQLite 한 곳에 저장한다. UI는 거기서 읽어 그린다.

외부 전송 없음

외부로 토큰 사용량을 전송하는 코드는 없다. 인터넷 연결은 자동 업데이트 확인을 위해 GitHub Releases를 조회할 때만 사용한다. 모든 데이터는 로컬 SQLite에 보관된다.

기술 스택

• Tauri 2

• Rust

• Vanilla TypeScript + Canvas (프레임워크 없음)

• 메모리 사용량: 트레이 popover 기준 80MB 안팎

지원 플랫폼

macOS, Windows, Linux 모두 지원한다. 자동 시작은 OS 부팅 시 백그라운드 실행으로 켤 수 있으며, 첫 실행 시 기본으로 활성화된다.

---

설치 및 사용 방법

GitHub Releases에서 각 플랫폼별 설치 파일을 제공한다:

• macOS DMG

• Windows NSIS

• Linux AppImage / deb

현재 Apple Developer 프로그램 승인 대기 중이라 macOS DMG는 "신뢰할 수 없는 개발자" 경고가 뜬다. Gatekeeper 우회를 위해 앱 우클릭 → 열기를 선택하거나, 시스템 설정 → 개인 정보 보호 및 보안 → "확인 없이 열기"를 실행하면 된다. 승인 완료 후에는 이 단계가 사라질 예정이다.

Windows는 SmartScreen에서 "추가 정보 → 실행"을 클릭해야 한다. 첫 설치 후에는 인앱 자동 업데이트가 새 버전을 알아서 알려준다.

---

라이선스 및 데이터

모든 데이터는 로컬 SQLite에 보관되며, 외부 서버는 없다. 라이선스는 FSL-1.1-ALv2다. 개인과 사내 사용 모두 자유로우며, 2년 뒤 Apache 2.0으로 자동 전환된다.

한국어와 영어 UI를 즉시 전환할 수 있다. 행성 30종, 별 형태 14종, 모든 UI 문자열이 양쪽으로 로컬라이즈되어 있다.

---

함께 보면 좋은 도구

Tokenova와 비슷한 목적의 다른 도구들도 있다:

• CodeBurn: AI 코딩 도구 토큰 사용량과 비용을 추적하는 TUI 대시보드

• Tessera: 여러 AI 코딩 에이전트 세션을 한 곳에서 관리하는 오픈소스 워크스페이스

• SwiftCast: Claude Code에서 AI 프로바이더 전환 및 사용량 모니터링 도구

---

정리하며

Tokenova가 코딩 습관을 바꿔주진 않다. 화면 가장자리에 작은 우주 하나가 떠 있을 뿐이다. 그 우주가 매일 다르게 자라는 걸 보는 게 의외로 일을 지속하게 만든다. 매일 밤 새로운 우주가 탄생한다는 사실이, 코딩하는 일에 작은 설렘을 더한다.

AI 코딩 도구를 매일 사용하는 개발자라면 한 번 써볼 만하다. 무료이며, 로컬에서만 동작해서 개인정보 걱정도 없다.

저장소: https://github.com/jkapa0417/tokenova

---

📚 출처

• GeekNews — Tokenova

• GitHub — jkapa0417/tokenova

---

📚 출처

• https://news.hada.io/topic?id=29619