컴백부터 K-뷰티까지 — K-컬쳐의 모든 것을 메일로 받아보세요메일로 받아보기

METAL MEDIA

murongg/TokPeek

★ 8SwiftMIT

AI 코딩 도구가 얼마나 많은 토큰을 썼는지 메뉴바에서 바로 보는 맥 앱

TokPeek은 로컬에 저장된 AI 세션 로그를 읽어서 토큰 사용량과 예상 비용을 macOS 메뉴바에서 보여주는 앱이다. 모든 계산은 서버로 보내지 않고 사용자의 맥에서 처리되며, 오늘/7일/30일/90일/전체 기간별로 사용량과 모델별, 클라이언트별 비중을 볼 수 있다. Swift로 만든 앱이 내부적으로 Rust로 작성된 tokscale-core 라이브러리를 호출해 실제 파싱과 집계를 수행한다.

무엇을 하는 레포인가

  1. 세션 파일 탐색, 파싱, 요금 계산, 집계까지 전부 로컬에서 실행되어 사용 내역이 서버로 전송되지 않는다
  2. SwiftUI 메뉴바 앱이 JSON 형식으로 Rust로 작성된 tokpeek-core-ffi 라이브러리와 통신하는 구조로, Swift 쪽은 별도로 파일을 파싱하거나 계산하지 않고 결과만 받아서 보여준다
  3. 일일 예산, 주간 예산, 월간 예산을 설정하면 사용량이 80%, 100%에 도달했을 때 로컬 알림을 준다
  4. macOS 14 이상에서 동작하며 애플 실리콘과 인텔 맥 모두 지원하는 유니버설 앱으로 배포되고, Apple 공증과 서명을 거친다
  5. Sparkle을 통해 서명된 업데이트를 확인하며 설치 전 항상 사용자 확인을 받는다

왜 중요한가

AI 코딩 도구를 여러 개 쓰면서 토큰 비용이 얼마나 나가는지 감이 안 잡히는 개발자에게, 데이터를 외부로 보내지 않으면서도 한눈에 사용량과 비용을 확인할 수 있는 방법을 제공한다. 오픈소스로 공개되어 있어 요금 계산 로직이나 세션 파싱 방식을 직접 확인하고 검증할 수 있다.

이 레포의 용어

  • MenuBarExtra · macOS 메뉴바에 상주하는 아이콘/메뉴를 만드는 SwiftUI 기능
  • C ABI · 서로 다른 언어(Swift, Rust)가 함수를 호출할 수 있도록 맞춘 공통 규칙
  • tokscale-core · AI 세션 로그를 읽어 토큰 사용량과 비용을 계산하는 Rust 라이브러리
  • Sparkle · macOS 앱의 자동 업데이트를 서명된 형태로 안전하게 처리하는 프레임워크
  • Universal 2 · 애플 실리콘과 인텔 맥 모두에서 실행되도록 두 아키텍처를 하나로 합친 앱 빌드 형식

레포 원문 소개 (영문)

Native, local-first macOS menu bar app for tracking AI token usage, estimated costs, daily trends, clients, and models. Powered by tokscale-core.

GitHub에서 보기

주목받는 레포

레포 전체 보기 →

METAL MEDIA 최신 기사