مفتوح المصدر · MIT · شريط قوائم macOS

Claude Usage Barometer

مقياس مدمج بأسلوب البطارية في شريط القوائم لاستخدامك من Claude. راقب نافذتي 5 ساعات و7 أيام تنفدان في الوقت الفعلي — مباشرةً من شريط قوائم macOS.

ما هو؟

حدودك من Claude أمام عينيك دائمًا

Claude Usage Barometer مكوِّن إضافي مجاني ومفتوح المصدر لـ SwiftBar (أو xbar) يعيش في شريط قوائم macOS لديك. يعرض شريطين بأسلوب البطارية — أحدهما لنافذة Claude المتجددة لمدة 5 ساعات والآخر لنافذة 7 أيام — لترى بنظرة واحدة بالضبط كم تبقَّى من حصتك. إنه Bash خالص دون أي خطوة بناء، ويقرأ رمز Claude Code محليًا من Keychain على macOS، ولا يرسل بياناتك إلى أي مكان أبدًا.

لماذا يهم ذلك

حدود الاستخدام غير مرئية حتى تصطدم بها

يفرض Claude نوافذ استخدام متجددة، لكن لا شيء على سطح مكتبك يخبرك كم اقتربت منها — حتى يتوقف العمل في منتصف المهمة.

لا مؤشر أصلي

لا يوجد مقياس مدمج لنافذتي 5 ساعات و7 أيام، لذا قد يصل الحد دون إنذار في منتصف الجلسة.

كلفة تبديل السياق

التحقُّق من الاستخدام يعني مغادرة عملك والبحث في لوحة معلومات — احتكاك تدفع ثمنه في كل مرة تتساءل فيها كم تبقَّى.

انقطاعات مفاجئة

الاصطدام بحد بشكل غير متوقع يكسر التدفُّق ويُعطِّل ما كنت بصدد إنجازه. يمنع المقياس القابل للملاحظة بنظرة واحدة هذه المفاجأة.

كيف يعمل

بطارية لحصتك من Claude

شريطان في شريط القوائم، وقائمة منسدلة مفصَّلة، ولون يروي القصة دون أي نقرة.

أشرطة بأسلوب البطارية

يُظهر الجزء الممتلئ ما تبقَّى والجزء الفارغ ما استُهلك. ويُفرَّغ كل شريط مع استهلاكك لحصة 5 ساعات و7 أيام.

بألوان دلالية

أخضر حتى 69% مستهلكًا، وكهرماني من 70%، وأحمر من 90% — ويتبع شريط شريط القوائم النافذة الأكثر تقييدًا.

قائمة منسدلة مفصَّلة

انقر لرؤية النسبة المتبقية لكل نافذة والعدّ التنازلي الدقيق لإعادة الضبط، إضافةً إلى وقت آخر تحديث.

يقرأ محليًا

يقرأ رمز OAuth الخاص بـ Claude Code من Keychain على هذا الـ Mac. دون حسابات ودون خوادم، ولا شيء يغادر جهازك.

الميزات

مقياس صغير بتفاصيل مدروسة

كل ما تريده من أداة في شريط القوائم، ولا شيء لا تريده.

مقياسا 5 ساعات و7 أيام

كلتا النافذتين المتجددتين بنظرة واحدة، مع النسبة المتبقية والعدّ التنازلي لإعادة الضبط في القائمة المنسدلة.

حالة بألوان دلالية

من الأخضر إلى الكهرماني إلى الأحمر مع اقترابك من الحد، فتكون الحالة واضحة دون فتح أي شيء.

متوافق مع حدود المعدل

يُخزِّن آخر قراءة صحيحة مؤقتًا ويُباعد بين استدعاءات API بـ 3 دقائق على الأقل، فيتجاوز حالات 429 العابرة بسلاسة.

مدرك للتحديثات

يتحقَّق من GitHub مرة واحدة يوميًا ويُظهر رابط "يتوفر تحديث" في القائمة المنسدلة عند صدور إصدار أحدث.

تحديث قابل للضبط

اختر فاصل تحديث من 1 أو 3 أو 5 دقائق من القائمة المنسدلة لتوازن بين الحداثة وعدد استدعاءات API.

دون بناء، Bash خالص

سهل القراءة والتدقيق والتعديل. خاص بحكم التصميم ومُصدَر بموجب ترخيص MIT.

التثبيت

سطر واحد في Terminal

يُضيف المُثبِّت jq وSwiftBar عبر Homebrew، ويُسقِط المكوِّن الإضافي، ويُشغِّله. عند التشغيل الأول، اختر "السماح دائمًا" لطلب Keychain.

curl -fsSL https://raw.githubusercontent.com/taka-avantgarde/claude-usage-barometer/main/install.sh | bash

يتطلب macOS 12+ وHomebrew وتسجيل دخول Claude Code على هذا الـ Mac.

الأسئلة الشائعة

الأسئلة المتكررة

هل Claude Usage Barometer مجاني؟

نعم. إنه مفتوح المصدر بموجب ترخيص MIT ومجاني الاستخدام. لا يحتاج سوى جلسة Claude Code التي تملكها بالفعل على جهاز Mac لديك.

ماذا أحتاج لتشغيله؟

macOS 12 أو أحدث، وSwiftBar (أو xbar)، وjq وcurl، وتسجيل دخول Claude Code على الـ Mac نفسه. ويُهيِّئ المُثبِّت من سطر واحد jq وSwiftBar نيابةً عنك.

هل رمز Claude الخاص بي آمن؟

نعم. يقرأ المكوِّن الإضافي رمز OAuth الخاص بـ Claude Code محليًا من Keychain على macOS ويستخدمه فقط لجلب بيانات استخدامك أنت. إنه Bash خالص، ولا يرسل شيئًا إلى أطراف خارجية، ولا يحتوي على أي تتبُّع.

ماذا تعني الألوان؟

يكون الشريط أخضر طالما أقل من 70% مستهلكًا، وكهرمانيًا من 70% إلى 89%، وأحمر من 90% إلى 100%. ويتبع لون شريط القوائم أيًّا من النافذتين أقرب إلى حدها.

هل يدعم xbar إضافةً إلى SwiftBar؟

نعم. يعمل كمكوِّن إضافي لـ SwiftBar أو xbar. يُوصى بـ SwiftBar وهو ما يُهيِّئه المُثبِّت من سطر واحد.

ضع حدودك من Claude في شريط القوائم

ثبِّته في سطر واحد، ثم لن تفاجئك حدود الاستخدام مجددًا أبدًا. مجاني ومفتوح المصدر.