오픈 소스 · MIT · macOS 13+ · Apple 공증 네이티브 앱

AI Usage Barometer

Claude, Codex, Gemini 사용량을 실시간 모니터링하는 세련된 macOS 배터리형 게이지. 메뉴 막대, Dock 아이콘, 플로팅 바에서 잔여 한도와 리셋 시점을 한눈에 확인하세요.

AI Usage Barometer — Menu bar, Dock icon, and Floating bar
소개

3대 AI 사용 한도를 항상 시야 안에

AI Usage Barometer는 엔지니어 필수 3대 AI(Claude, Codex, Gemini / Antigravity Desktop 2.0 & IDE)의 5h·1w 사용 한도를 한곳에서 확인하는 Apple Developer ID 서명·공증 네이티브 macOS 앱으로, 메뉴 막대·Dock 아이콘·플로팅 바를 지원합니다.

개발자에게 필요한 이유

갑작스러운 사용량 한도 도달로 인한 흐름 중단을 없애세요

Claude, Codex, Gemini의 사용량은 롤링 윈도우 방식입니다. 작업 중 대시보드를 일일이 확인하는 것은 몰입을 끊습니다. 항상 시야에 머무는 게이지가 돌발 차단을 방지합니다.

여러 도구에 흩어진 사용량

Claude, Codex, Gemini 한도가 여러 도구에 흩어져 있어 한 번에 통합 확인할 수 있는 기본 도구가 없었습니다.

확인을 위한 잦은 컨텍스트 스위칭

남은 쿼터를 확인할 때마다 웹 콘솔이나 터미널 명령을 오가는 마찰이 개발 몰입(Flow)을 해칩니다.

예고 없는 급작스러운 작업 중단

중요한 버그 수정이나 배포 직전에 한도에 도달하면 작업이 몇 시간 동안 멈추게 됩니다. 상시 게이지가 이를 예방합니다.

동작 원리

3대 AI에 최적화된 배터리형 멀티 게이지

서비스 고유 컬러, 1줄 컴팩트 뷰, 정확한 리셋 카운트다운, 100% 로컬 무해 조회.

배터리형 사용량 바

채워진 블록은 잔여량, 점은 소비된 양입니다. Claude, Codex, Gemini 상태를 한 줄에 미려하게 표시합니다.

3단계 서비스 전용 팔레트

Claude 오렌지(#C66D28), Codex 시안(#1A8BA6), Gemini 에메랄드(#158F6A)가 사용량에 따라 경고 및 위험색으로 부드럽게 전환.

3가지 배치 모드

메뉴 막대, Dock 아이콘(화면 공간 0px 차지), 항상 위에 떠 있는 플로팅 바 중 원하는 위치를 자유롭게 선택.

안전한 100% 로컬 연동

macOS Keychain 및 Antigravity 로컬 RPC에서 로컬로 안전하게 읽어옵니다. 계정 생성이나 원격 서버 통신이 없습니다.

주요 기능

전문 개발자를 위해 타협 없이 설계된 도구

가볍고 빠르며 견고한 보안과 macOS 네이티브의 품격.

Claude · Codex · Gemini 3대 AI 지원

Claude Code(5h & 1w), Codex CLI(동적 롤링 윈도우), Gemini(Antigravity 데스크톱 2.0 & IDE) 3대 AI 사용량을 통합 모니터링.

서비스 전용 고대비 컬러 팔레트

Claude 오렌지(#C66D28), Codex 시안(#1A8BA6), Gemini 에메랄드(#158F6A) 전용 벡터 렌더링으로 즉각 상태 식별.

메뉴 막대 · Dock 아이콘 · 플로팅 바

메뉴 막대뿐 아니라 화면을 1px도 차지하지 않는 Dock 아이콘 게이지, 자유롭게 드래그하는 플로팅 바 지원.

Apple 공증 네이티브 Mac 앱

Xcode나 Homebrew 없이 즉시 실행되는 Apple Developer ID 서명 및 공증 네이티브 Mac 앱.

자동 업데이트 감지 & 1클릭 업그레이드

GitHub Releases 업데이트를 자동 감지해 메뉴에서 바로 원클릭으로 간편하게 최신 버전으로 업데이트.

속도 제한 보호 및 스마트 캐싱

스마트 캐싱 및 지수 백오프로 API 호출을 최소화하여 일시적인 429 오류 발생 시에도 정상 값을 유지.

설치 방법

터미널에 1줄 복사 & 실행

Apple 공식 공증 네이티브 Mac 앱을 터미널 명령어 한 줄로 간편하게 설치하세요.

네이티브 Mac 앱 버전

Recommended · Apple Notarized

Homebrew나 Xcode가 전혀 필요 없습니다. Apple의 공식 서명과 공증을 받아 경고 없이 즉시 실행되며 메뉴 막대, Dock 아이콘, 플로팅 바 위치를 자유롭게 선택할 수 있습니다.

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/taka-avantgarde/ai-usage-barometer/main/install-app.sh)"

macOS 13(Ventura) 이상 필요. Intel 및 Apple Silicon(Universal Binary) 지원.

자주 묻는 질문

자주 묻는 질문

AI Usage Barometer는 무료인가요?

네. MIT 라이선스 오픈 소스로 완전 무료입니다. Mac에 이미 존재하는 Claude Code, Codex CLI, Antigravity(Gemini) 세션만을 이용하므로 추가 비용이 발생하지 않습니다.

Homebrew나 Xcode를 설치해야 하나요?

아니요. Homebrew나 Xcode가 전혀 필요 없는 Apple 공식 서명·공증 독립형 네이티브 Mac 앱으로, 메뉴 막대·Dock 아이콘·플로팅 바 3가지 표시를 모두 지원합니다.

내 인증 정보와 토큰은 안전한가요?

네, 완전히 안전합니다. Claude Code 토큰은 macOS Keychain에서, Codex는 로컬 CLI에서, Gemini는 Antigravity 로컬 RPC/SQLite에서 기기 내부에서만 읽어옵니다. 외부 전송이나 텔레메트리는 일절 없습니다.

각 AI의 색상은 무엇을 의미하나요?

Claude는 오렌지(#C66D28), Codex는 시안(#1A8BA6), Gemini는 에메랄드(#158F6A)로 렌더링됩니다. 사용량 70% 미만은 정상, 70~89%는 경고, 90~100%는 위험(빨강 계열)으로 바뀝니다. 채워진 블록은 잔여량, 점은 소진량을 나타냅니다.

Gemini(Antigravity) 연동은 어떻게 동작하나요?

Antigravity 데스크톱 앱 2.0 및 Antigravity IDE(VS Code 기반) 모두 완벽 지원합니다. 외부 API 호출 없이 언어 서버 Connect RPC, SQLite(state.vscdb), 캐시의 3단계 폴백으로 안전하고 신속하게 조회합니다.

Claude, Codex, Gemini 한도를 데스크톱에 두세요

한 줄 명령어로 설치하고, 다시는 예기치 않은 사용량 한도 초과로 작업이 중단되지 않도록 하세요. 무료 및 오픈 소스.