इस प्रोजेक्ट के बारे में

# 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 Keychain में सुरक्षित रूप से संग्रहीत किए जाते हैं। गैर-गुप्त प्राथमिकताएँ `~/.config/quotabar/config.json` में प्रतिबंधित अनुमतियों (मोड 0600) के साथ सहेजी जाती हैं। - **कोई टेलीमेट्री नहीं**: एप्लिकेशन संबंधित प्रदाताओं के API से आवश्यक कोटा जानकारी प्राप्त करने के अलावा बाहरी सर्वरों को कोई उपयोग डेटा या टेलीमेट्री नहीं भेजता है। - **गोपनीयता-केंद्रित**: एक गैर-सैंडबॉक्स्ड `LSUIElement` के रूप में डिज़ाइन किया गया है ताकि जटिल एंटाइटलमेंट्स के बिना स्थानीय फ़ाइलें (जैसे Cursor की स्टेट डेटाबेस) पढ़ सके और ब्राउज़र कुकीज़ को संभाल सके। ## समर्थित प्रदाता और विधियाँ ### 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 से बिलिंग और उपयोग डेटा प्राप्त करता है। - विशेष रूप से उपभोक्ता SuperGrok योजनाओं को लक्षित करता है, टीम प्रबंधन API को नहीं। ### OpenCode Go - Keychain में संग्रहीत 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 ad-hoc हस्ताक्षरित एप्लिकेशन को अवरुद्ध करता है, तो आपको यह चलाने की आवश्यकता हो सकती है: ```bash xattr -dr com.apple.quarantine /Applications/QuotaBar.app ``` फिर System Settings > Privacy & Security खोलें और **Open Anyway** पर क्लिक करें। ## स्रोत से निर्माण आवश्यकताएँ: 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 का उपयोग करने के जोखिमों को समझने के लिए जिम्मेदार हैं।