Insights
AI가 자동으로 큐레이션·번역·정리하는 기술 동향 피드입니다.
UsageAtlas는 AI 코딩 사용량을 통합적으로 추적하는 데스크톱 대시보드입니다. 14개 도구에 걸친 코딩 기록, 할당량(allowances), 잔액(balances)을 한눈에 확인할 수 있습니다. 계정 없이도 기본적인 사용량 추적이 가능하며, 주간/일별 활동 패턴 분석 기능을 제공합니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 GitHub Claude Ecosystem의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기계정 없이 UsageAtlas를 사용하여 컴퓨터의 사용량을 추적할 수 있습니다. 만약 사용 기록 사본을 보관하고 컴퓨터를 변경하거나 분실한 후 복원하려면, 무료 계정을 생성하여 클라우드 저장(cloud save) 기능을 사용할 수 있습니다.
usageatlas.com 또는 릴리스 페이지에서 설치 파일을 받은 후 다음을 수행하세요:
모든 에셋은 릴리스의 SHA256SUMS에 SHA-256 값과 함께 나열됩니다. macOS와 Windows는 백그라운드에서 자체 업데이트를 수행합니다.
UsageAtlas는 로컬 활동을 읽고 지원되는 도구 로그인 정보를 재사용합니다. API 키나 세션이 필요한 제공업체(Providers)는 **설정(Settings) → 소스(Sources)**에서 연결할 수 있습니다.
Codex — 설치되어 로그인된 Codex CLI를 공식 로컬 앱 서버 API를 통해 사용합니다. OAuth 토큰은 절대 읽지 않습니다.
Claude — Claude 설정 디렉터리 내의 CLAUDE_CODE_OAUTH_TOKEN 또는 .credentials.json을 읽은 다음, OAuth 사용량 엔드포인트를 쿼리합니다.
Cursor — Cursor의 로컬 상태 데이터베이스에 로그인된 데스크톱 세션을 재사용하여 계정 제한과 더불어 요청별 토큰, 모델 및 비용 기록을 90일 동안 추적합니다.
OpenCode — 단계별(per-step) 토큰, 요청, 프로젝트, 모델 및 비용 분석을 위해 로컬 OpenCode 데이터베이스를 읽습니다.
Antigravity는 타임스탬프가 찍힌 토큰, 요청, 모델, 세션 및 API 가격 추정치를 위해 로컬 CLI 대화 데이터베이스를 읽습니다.
Pi / OMP는 Anthropic 및 OpenAI Codex 백엔드 사용에 대한 캐시 토큰, 프로젝트 및 API 가격 추정치를 포함하여 로컬 JSONL 세션을 읽습니다.
Muse Code는 토큰, 요청, 모델 및 세션 기록을 위해 로컬 추론(inference) 및 자동 검토 이벤트를 읽습니다. 금전적 비용은 알 수 없습니다.
Antigravity, Pi / OMP, Muse Code는 자격 증명 없이 로컬 기록을 수집합니다. 구독 할당량(subscription quotas)은 수집하지 않습니다.
지원되는 위치와 제한 사항에 대해서는 provider 설정 및 필드 매핑을 참조하십시오.
다음 7가지 통합 기능이 현재 제공업체의 허용 한도와 잔액을 읽어들입니다:
위 7가지 통합 기능은 토큰, 요청, 프로젝트 또는 비용 기록을 제공하지 않습니다. 누락된 할당량은 알 수 없는 상태로 유지됩니다. 설정(Settings)에 저장된 자격 증명은 운영 체제의 암호화된 저장소를 사용하며 클라우드 저장소에 절대 저장되지 않습니다. 자격 증명, 지원되는 형식 및 제한 사항은 할당량 제공자 설정을 참조하십시오.
제공자 데이터는 로컬 파일 및 제공자 API에서 읽어옵니다. 완료된 날짜 사용량과 용량 스냅샷은 앱 데이터 디렉터리에 있는 로컬 기록 데이터베이스에 저장됩니다. UsageAtlas에 로그인하지 않으면, 사용량 기록은 귀하의 컴퓨터에 남아 있습니다.
무료 계정을 선택하면 cloud save는 해당 계정의 사용량 합계, 예상 비용, 시간별 활동 내역, 모델 세부 정보, 제한 및 플랜 정보를 저장합니다. 또한 요청별 타임스탬프, 모델 식별자(개인 모델 이름 포함), 숫자 토큰 및 비용 측정값, 컬렉션 메타데이터, 불투명한 프로젝트 및 세션 식별자를 유지합니다. 다만, 프로젝트 및 세션 이름, 파일 경로, 프롬프트, 응답, 원본 스크립트 로그, 코딩 도구 자격 증명은 포함되지 않습니다. 클라우드 기록을 복원한다고 해서 로컬 프로젝트 경로 또는 세션 이름이 복원되는 것은 아닙니다.
선택적인 익명 설치 횟수는 cloud save와 별개입니다. 이 정보에는 사용량 수치나 계정 이름, 또는 이메일 주소가 절대 포함되지 않으며, 설정(Settings)에서 끌 수 있습니다. 진단 데이터는 표시되거나 복사되기 전에 마스킹 처리됩니다. privacy policy와 terms of use를 참조하십시오.
성공적으로 저장된 기록만 복원할 수 있습니다. 로컬 앱 데이터를 제거하거나 컴퓨터를 교체하기 전에 저장이 완료되었는지 확인하십시오. 로그아웃하면 향후 저장은 중단되지만 기존 클라우드 기록은 삭제되지 않습니다. 계정 및 클라우드 기록 삭제를 요청하려면 [email protected]으로 이메일을 보내주십시오.
요구 사항: Bun 1.3.14 및 Node.js 22.13+.
git clone https://github.com/SRX9/UsageAtlas.git
cd UsageAtlas
bun ci
...
bun run check는 lint, typecheck, 테스트 및 빌드를 실행합니다. bun run desktop:make는 Electron Forge를 사용하여 현재 플랫폼용 설치 파일을 생성하며, 서명되지 않은 빌드는 자격 증명이 필요하지 않습니다.
이 저장소는 Bun과 Turborepo 워크스페이스입니다. Electron 앱은 apps/desktop에, 공유 스키마 및 픽스처는 packages/contracts에, 빌드 도우미는 tooling에 있습니다.
릴리스를 배포하려면, apps/desktop/package.json의 버전을 올리고(bump), bun install --lockfile-only를 실행한 다음, 두 파일을 모두 main에 푸시해야 합니다. 릴리스 워크플로우는 모든 플랫폼을 빌드하고, macOS에 서명 및 공증(notarizes)하며, desktop-v<version> 태그를 지정하고, 설치 파일, SHA256SUMS, 업데이트 피드를 게시합니다. 이미 게시된 버전은 건너뜁니다. 일치하는 desktop-v<version> 태그를 푸시하거나 Release desktop을 수동으로 실행할 수도 있습니다. 수동 실행은 기본적으로 게시 없이 빌드하며, 선언된 버전을 게시하려면 publish를 활성화해야 합니다.
일반적인 CI는 리눅스에서 lint, type check, 테스트, 렌더러 빌드 및 종속성 감사(dependency audit)를 실행합니다. 문서 변경만 있는 경우 CI가 건너뜁니다. Windows와 macOS의 테스트, 패키징, 설치 프로그램 스모크 테스트는 릴리스를 빌드할 때 실행됩니다.
기여하려면 CONTRIBUTING.md를, 취약점을 비공개로 보고하려면 SECURITY.md를 참조하세요.
Peter Steinberger의 CodexBar에서 영감을 받았습니다. 차트는 Dither Kit에서 가져왔습니다(vendored).
소스 코드는 MIT 라이선스에 따라 사용할 수 있습니다. UsageAtlas 이름과 로고는 이 라이선스가 적용되지 않으므로, TRADEMARKS.md를 참조하세요.