quotabar

# QuotaBar QuotaBar는 macOS 14+용 경량 메뉴바 전용 유틸리티로, 여러 AI 코딩 및 채팅 서비스의 남은 구독 할당량을 추적합니다. **Cursor**, **ChatGPT**(Plus/Pro), **GLM**(z.ai/BigModel), **Grok**(소비자용 SuperGrok), **OpenCode Go**의 사용 한도에 대한 시각적 지표를 제공합니다. 이 앱은 상태 바에 어두운 알약 모양으로 조용히 표시되며, 백분율과 작은 막대 차트를 보여주고, 자세한 계정 관리를 위한 간결한 팝오버를 제공합니다. ## 주요 기능 - **다중 서비스 지원**: 비공식이지만 표준적인 사용량 엔드포인트를 사용하여 다섯 개의 서로 다른 AI 플랫폼의 할당량 사용량을 모니터링합니다. - **메뉴 바 통합**: macOS 상태 바에 백분율 표시가 있는 단일 아이콘을 표시합니다. 남은 할당량이 25% 미만으로 떨어지면 색상이 주황색으로 바뀝니다. - **간결한 팝오버**: 고정 크기 팝오버(320x360)는 각 제공자 또는 계정에 대한 상세 카드를 보여줍니다. 여러 계정을 위한 스크롤을 지원하며 설정 접근을 포함합니다. - **다중 계정 관리**: ChatGPT와 OpenCode Go에 대해 여러 계정을 지원합니다. 사용자는 팝오버에서 직접 활성 계정 간에 전환할 수 있으며, 상태 바는 선택한 계정의 사용량을 반영합니다. - **로컬 자격 증명 저장**: 비밀 정보는 macOS 키체인에 안전하게 저장됩니다. 비밀 정보가 아닌 환경 설정은 제한된 권한(모드 0600)으로 `~/.config/quotabar/config.json`에 저장됩니다. - **텔레메트리 없음**: 이 애플리케이션은 각 제공자의 API에서 필요한 할당량 정보를 가져오는 것 외에는 외부 서버로 사용 데이터나 텔레메트리를 전송하지 않습니다. - **개인정보 보호 중심**: 복잡한 자격 없이 로컬 파일(예: Cursor의 상태 데이터베이스)을 읽고 브라우저 쿠키를 처리할 수 있도록 비샌드박스 `LSUIElement`로 설계되었습니다. ## 지원 제공자 및 방법 ### Cursor - 로컬 Cursor 애플리케이션 데이터베이스(`state.vscdb`)에서 인증 토큰을 읽거나 붙여넣은 세션 쿠키를 허용합니다. - `cursor.com/api/usage-summary`에서 사용 데이터를 가져옵니다. - "Cursor Models"와 "Other Models" 풀을 구분합니다. ### ChatGPT (Plus / Pro) - Codex CLI(`codex login`) 또는 수동 쿠키/JSON 입력을 통한 다중 계정을 지원합니다. - `wham/usage` 엔드포인트를 사용하여 세션, 주간, 월간 한도를 가져옵니다. - Codex CLI를 사용할 수 있는 경우 공개 OAuth API를 사용하여 만료된 토큰을 자동으로 갱신합니다. ### GLM (z.ai / BigModel) - 설정 또는 환경 변수를 통해 API 키를 허용합니다. - 글로벌(`api.z.ai`) 및 중국(`open.bigmodel.cn`) 지역을 모두 지원합니다. - 모니터 API에서 할당량 한도를 가져옵니다. ### Grok (소비자용 SuperGrok) - Grok CLI가 작성한 `~/.grok/auth.json`에서 인증을 읽거나 붙여넣은 OAuth 토큰을 허용합니다. - Grok CLI 프록시 API에서 청구 및 사용 데이터를 가져옵니다. - 팀 관리 API가 아닌 소비자용 SuperGrok 요금제를 특별히 대상으로 합니다. ### OpenCode Go - 키체인에 저장된 API 키를 통한 다중 계정 지원. - `opencode.ai/zen/go/v1/usage`에서 사용량을 가져옵니다. - 표시를 위해 "사용" 백분율을 "남은" 백분율로 변환합니다. ## 설치 권장 설치 방법은 Homebrew를 통하는 것입니다: ```bash brew tap ttaatoo/quotabar https://github.com/ttaatoo/quotabar brew install --cask ttaatoo/quotabar/quotabar ``` Gatekeeper가 임시 서명된 애플리케이션을 차단하는 경우 다음을 실행해야 할 수 있습니다: ```bash xattr -dr com.apple.quarantine /Applications/QuotaBar.app ``` 그런 다음 시스템 설정 > 개인정보 보호 및 보안을 열고 **그래도 열기**를 클릭하십시오. ## 소스에서 빌드 요구 사항: macOS 14+, Xcode 15.4+ (Swift 5.9+). ```bash git clone https://github.com/ttaatoo/quotabar.git cd quotabar open QuotaBar.xcodeproj ``` Xcode에서 프로젝트를 실행하거나 명령줄을 통해 빌드하십시오: ```bash xcodebuild -project QuotaBar.xcodeproj -scheme QuotaBar -configuration Release \ MARKETING_VERSION=0.0.13 CURRENT_PROJECT_VERSION=0.0.13 \ CODE_SIGN_IDENTITY="-" CODE_SIGNING_ALLOWED=YES CODE_SIGNING_REQUIRED=NO build ``` ## 면책 조항 QuotaBar는 독립적이고 비공식적인 도구입니다. 예고 없이 변경될 수 있는 비공개 사용 엔드포인트와 상호 작용합니다. Cursor, OpenAI, z.ai, BigModel, xAI 또는 OpenCode와 제휴 관계가 없습니다. 사용자는 자신의 자격 증명을 관리하고 비공식 API 사용의 위험을 이해할 책임이 있습니다.