প্রকল্প সম্পর্কে

# QuotaBar QuotaBar হলো macOS 14+ এর জন্য একটি হালকা, শুধুমাত্র মেনু-বার ভিত্তিক ইউটিলিটি, যা কয়েকটি AI কোডিং ও চ্যাট পরিষেবার অবশিষ্ট সাবস্ক্রিপশন কোটা ট্র্যাক করে। এটি **Cursor**, **ChatGPT** (Plus/Pro), **GLM** (z.ai/BigModel), **Grok** (ভোক্তা SuperGrok) এবং **OpenCode Go**-এর ব্যবহারের সীমার একটি ভিজ্যুয়াল সূচক প্রদান করে। অ্যাপটি স্ট্যাটাস বারে একটি গাঢ় পিল হিসেবে বিচক্ষণভাবে কাজ করে, একটি শতাংশ ও ছোট বার চার্ট দেখায়, এবং বিস্তারিত অ্যাকাউন্ট ব্যবস্থাপনার জন্য একটি কমপ্যাক্ট পপওভার থাকে। ## প্রধান বৈশিষ্ট্য - **মাল্টি-সার্ভিস সমর্থন**: পাঁচটি ভিন্ন AI প্ল্যাটফর্মের কোটা ব্যবহার মনিটর করে, তাদের অনানুষ্ঠানিক কিন্তু মানক ব্যবহার এন্ডপয়েন্ট ব্যবহার করে। - **মেনু বার ইন্টিগ্রেশন**: macOS স্ট্যাটাস বারে একটি আইকন ও শতাংশ সূচক দেখায়। অবশিষ্ট কোটা ২৫%-এর নিচে নামলে রঙ কমলা হয়ে যায়। - **কমপ্যাক্ট পপওভার**: একটি নির্দিষ্ট আকারের পপওভার (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 ইনপুটের মাধ্যমে মাল্টি-অ্যাকাউন্ট সমর্থন করে। - Session, Weekly এবং Monthly সীমা আনতে `wham/usage` এন্ডপয়েন্ট ব্যবহার করে। - Codex CLI উপলব্ধ থাকলে পাবলিক OAuth API ব্যবহার করে মেয়াদোত্তীর্ণ টোকেন স্বয়ংক্রিয়ভাবে রিফ্রেশ করে। ### GLM (z.ai / BigModel) - সেটিংস বা এনভায়রনমেন্ট ভেরিয়েবলের মাধ্যমে API কী গ্রহণ করে। - Global (`api.z.ai`) এবং China (`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` থেকে ব্যবহার আনে। - প্রদর্শনের জন্য "used" শতাংশকে "remaining"-এ রূপান্তর করে। ## ইনস্টলেশন প্রস্তাবিত ইনস্টলেশন পদ্ধতি হলো 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 ``` তারপর 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 ব্যবহারের ঝুঁকি বোঝার জন্য দায়ী।