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

PokeTokenBar एक macOS मेनू बार ऐप है जो आपके टोकन खर्च को पोकीमोन साथी में बदलकर AI कोडिंग टोकन उपयोग को गेमिफाई करता है। यह Claude Code, Codex, Gemini CLI, Antigravity, OpenCode, Hermes Agent, Cursor, Grok CLI, Copilot CLI, Kiro CLI, Pi Agent, omp और Aside से उपयोग ट्रैक करता है—सीधे लोकल लॉग पढ़कर, किसी बाहरी CLI की ज़रूरत नहीं। **मुख्य मैकेनिक्स:** - 🥚 **Hatch**: आपके जलाए टोकन एक अंडे को सेते हैं जो Gen 1–5 के पोकीमोन में फूटता है (329 संभावित शुरुआत), आधिकारिक कैप्चर दरों से भारित—लेजेंडरी दुर्लभ (1-in-129)। हर हैच 25 नेचर्स में से एक रोल करता है, साथ में ✨ Shiny की दुर्लभ संभावना। - ⚡ **Evolve**: लगातार कोडिंग आपके पोकीमोन को उसके असली इवोल्यूशन ट्री (1/2/3 चरण, ब्रांचिंग) से बढ़ाती है, हर चरण पर फ्लैश सेलिब्रेशन के साथ। - 🎓 **Graduate & collect**: अंतिम रूप + थ्रेशोल्ड उसे स्थायी रूप से आपके Pokédex में संग्रहित करता है (दुर्लभ में ज़्यादा समय: भारी उपयोग पर ~3 दिन सामान्य → ~24 दिन लेजेंडरी), और नया अंडा आता है। - 🍬 **Rare Candy**: 5-घंटे या साप्ताहिक उपयोग सीमा भरें तो Rare Candy मिलती है, जिसे Bag से खर्च करके अपने मौजूदा पोकीमोन को बढ़ा सकते हैं। - 🛒 **Shop**: आपके इस्तेमाल किए टोकन Rare Candy, Mint (नेचर री-रोल), Shiny Charm (शाइनी ऑड्स स्थायी रूप से बढ़ाता है), या अंडों (Pokémon Egg, Uncommon Egg, Rare Egg) के लिए मुद्रा हैं। **फीचर्स:** - **Menu bar**: आज के कुल टोकन के बगल में एनिमेटेड Gen-V स्प्राइट (कॉम्पैक्ट फॉर्मेट जैसे `200.7M`), वैकल्पिक लागत या सीमा प्रतिशत डिस्प्ले के साथ। - **Floating desktop pet**: अपने साथी को किसी भी आकार (48–384px) में डेस्कटॉप पर लाएँ, होवर कॉलआउट, क्लिक-टू-ओपन, राइट-क्लिक मेनू, और स्पीच-बबल सीमा अलर्ट के साथ। - **Pokédex & Catch log**: प्रति प्रजाति एक सेल (प्रति पेज 24, डेक्स-नंबर क्रम, शाइनी के लिए ✨), साथ में पूरी इवोल्यूशन लाइन, दुर्लभता, नेचर और कैप्चर तिथि वाला कैच लॉग। - **Official limits**: Claude, Codex और Antigravity की 5-घंटे/साप्ताहिक उपयोगिता रीसेट काउंटडाउन और बर्न-रेट पूर्वानुमान के साथ ट्रैक करें। - **Per-model breakdown**: जब कई मॉडल एक सेशन लॉग साझा करते हैं तो Pi Agent उपयोग असली मॉडल IDs को आवंटित होता है। - **Settings**: मेनू-बार आइटम, रीफ्रेश अंतराल (1–15 मिनट या मैनुअल), लॉगिन पर लॉन्च, Keychain ऑप्ट-आउट, थ्रेशोल्ड के साथ सीमा अलर्ट, साथी नोटिफिकेशन, और पूर्ण KO/EN/JA/ES/FR/PT/DE UI व पोकीमोन नाम। - **Growth difficulty**: थ्रेशोल्ड और शॉप कीमतें 10% से 200% तक समायोजित करें; पहले से ग्रेजुएट लाइनों से हैच 2× तेज़ बढ़ते हैं। - **Daily chart**: प्रति दिन टोकन (और लागत) दिखाने वाला कॉम्पैक्ट मासिक चार्ट। - **Additional scan folders**: बिल्ट-इन पाथ के बाहर के लॉग की ओर इंगित करें (प्रति-प्रोवाइडर, वाइल्डकार्ड के साथ)। - **claude.ai session key**: Keychain एक्सेस के बिना आधिकारिक सीमाओं के लिए वैकल्पिक पेस्ट। - **Low Power Mode**: मेनू-बार एनिमेशन Power saver गुणवत्ता पर जारी रहता है। - **In-app updates**: एक-क्लिक अपडेट जाँच। **समर्थित टूल्स और ट्रैकिंग:** | Tool | Tracked | Official limits | |---|---|---| | Claude Code | today · 5h block · week · month | ✅ 5h / weekly | | Codex | today · week · month | ✅ 5h / weekly | | Gemini CLI | today · week · month | — | | Antigravity | today · 5h block · week · month | ✅ 5h / weekly | | OpenCode | today · 5h block · week · month | — | | Hermes Agent | today · 5h block · week · month | — | | Cursor | today · 5h block · week · month | — | | Grok CLI | today · 5h block · week · month | — | | Copilot CLI | today · 5h block · week · month | — | | Kiro CLI | today · 5h block · week · month | — (अनुमानित) | | Pi Agent | today · 5h block · week · month | — | | omp (oh-my-pi) | today · 5h block · week · month | — | | Aside | today · 5h block · week · month | — | **डेटा स्रोत:** प्रत्येक टूल के मानक पाथ से लोकल लॉग (JSONL, SQLite, आदि) पढ़ता है, साथ ही प्रजाति/इवोल्यूशन डेटा और स्प्राइट्स के लिए PokéAPI (रनटाइम पर फेच, लोकली कैश)। आधिकारिक सीमाएँ अनौपचारिक एंडपॉइंट्स (Anthropic, codex app-server, Antigravity Google APIs) का उपयोग करती हैं, Keychain एक्सेस केवल मैनुअल रीफ्रेश पर। **प्राइवेसी:** डिवाइस-पहले—कोई उपयोग अपलोड नहीं। आउटबाउंड अनुरोध 12 होस्ट्स (PokéAPI, GitHub sprites, Anthropic, claude.ai, cursor.com, Google APIs, status pages, GitHub update check) पर जाते हैं लेकिन कभी उपयोग लॉग, प्रॉम्प्ट या प्रोजेक्ट पाथ नहीं ले जाते। Keychain वैकल्पिक है और केवल मैनुअल रीफ्रेश पर पढ़ा जाता है। **इंस्टॉल:** macOS 14+ (Apple Silicon या Intel)। Homebrew cask (`brew install --cask chattymin/tap/poke-token-bar`), मैनुअल zip डाउनलोड, या Swift 6 के साथ सोर्स से बिल्ड। Ad-hoc/self-signed, इसलिए पहले लॉन्च पर Gatekeeper चेतावनी (राइट-क्लिक → Open या `xattr -dr com.apple.quarantine` से हटाएँ)। **लाइसेंस:** MIT (केवल मूल सोर्स कोड को कवर करता है; Pokémon एसेट्स बंडल नहीं हैं—रनटाइम पर फेच)। अनौपचारिक, गैर-व्यावसायिक Pokémon फैन प्रोजेक्ट।