claude-hud شريط حالة (statusline) لـ Claude Code صُمّم ليجيب عن سؤالين في الجلسات الطويلة: كم بقي من نافذة السياق، وماذا يفعل Claude الآن؟ يقرأ بيانات Claude Code وسجل الجلسة على جهازك، ويطبع حتى أربعة أسطر ملوّنة في الطرفية، ولا يعمل في claude.ai أو Codex.
ماذا يعرض كل سطر
- سطر الجلسة: اسم النموذج، وشريط من عشر خانات لنسبة امتلاء السياق يبقى أخضر دون 70٪ ويصفرّ من 70٪ ويحمرّ من 85٪. ثم أعداد ملفات CLAUDE.md والقواعد في .claude/rules وخوادم MCP وأحداث الخطافات (hooks) في إعدادات المستخدم والمشروع، ومدة الجلسة. وعند 85٪ يضيف عدد رموز الإدخال (input) والذاكرة المؤقتة (cache)، وعند 95٪ تحذيرًا أحمر بكلمة COMPACT.
- سطر الأدوات: حتى أداتين جاريتين مع هدف كل منهما: مسار الملف في Read وWrite وEdit، والنمط في Glob وGrep، والأمر في Bash. ثم أكثر أربع أدوات مكتملة تكرارًا بين آخر عشرين استدعاء، مع عدد مرات كل منها.
- سطر الوكلاء: الوكلاء الفرعيون قيد العمل وآخر اثنين اكتملا، بحد أقصى ثلاثة، مع نوع الوكيل والنموذج ووصف مختصر في 40 حرفًا.
- سطر المهام: المهمة الجارية من قائمة Claude للمهام مع عدد المنجز من الإجمالي، أو عبارة تعلن اكتمالها كلها.
ثلاثة تعديلات يحتاجها مع Claude Code الحالي
قارنتُ الشيفرة بتوثيق Claude Code الحالي، فوجدتُ ثلاثة فروق:
- نسبة السياق: تقرأ الشيفرة context_window رقمًا، ويرسله Claude Code الآن كائنًا فيه used_percentage وcurrent_usage، فتظهر النسبة NaN% ويبقى الشريط فارغًا ولا يعمل تنبيها 85٪ و95٪ حتى تعدّل src لتقرأ من داخل هذا الكائن.
- الوكلاء: تبحث الشيفرة عن أداة Task، واسمها الآن Agent، فلا يظهر سطر الوكلاء حتى تضيف الاسم الجديد في src/transcript.ts.
- المهام: أداة TodoWrite معطّلة افتراضيًا لصالح TaskCreate وTaskUpdate، فلا يظهر سطر المهام إلا بعد ضبط متغير البيئة CLAUDE_CODE_ENABLE_TASKS=0.
أما اسم النموذج والعدّادات ومدة الجلسة وسطر الأدوات فتعتمد على حقول ما زالت قائمة.
الضبط في ثلاث خطوات
- فُكّ ضغط الملف في مجلد ثابت لا يحتوي مساره على مسافات. النسخة المبنية جاهزة في plugin/dist، وبعد أي تعديل في plugin/src شغّل npm install ثم npm run build داخل plugin.
- أضف إلى ~/.claude/settings.json المفتاح statusLine، واجعل فيه type بقيمة command، وcommand بقيمة node متبوعًا بالمسار الكامل لملف plugin/dist/index.js، ثم أعد تشغيل Claude Code. على ويندوز اكتب المسار بشرطات مائلة للأمام، مثل D:/tools/claude-hud/plugin/dist/index.js.
- إن لم يظهر الشريط فشغّل الأمر نفسه في الطرفية: ظهور عبارة [claude-hud] Initializing يعني أن Node يقرأ الملف، وإن ظهر خطأ فراجع المسار.
أو حمّل مجلد plugin بالأمر claude --plugin-dir واستدعِ /claude-hud:setup ليعطي Claude التعليمات نفسها، ثم ضع في الإعدادات مسارًا كاملًا بدل المتغير CLAUDE_PLUGIN_ROOT الذي تستخدمه التعليمات.
المتطلبات والحدود
- Node.js 18 أو أحدث، وClaude Code بالإصدار 1.0.80 أو أحدث كما يذكر README الأصلي.
- نصوص الشريط بالإنجليزية، ويعتمد على ألوان ANSI ورموز Unicode في الطرفية.
- يُفضَّل تجربته أولًا في مشروع جانبي.
داخل الملف المضغوط
تجد مجلد plugin كاملًا: الأمر commands/setup.md والشيفرة في src ونسختها المبنية في dist وREADME الأصلي. وأرفقتُ دليلًا عربيًا وفهرسًا للمكونات وملف PROVENANCE.json بالمصدر ورمز الإيداع (commit). عدّلتُ مسار الأوامر في plugin.json إلى ./commands ليقبله Claude Code، واحتفظتُ بالأصل في upstream-originals.
الترخيص MIT. النسخة من مستودع buildwithclaude لـ davepoon، وهي مبنية على claude-hud الأصلية لـ Jarrod Watts.
