Claude HUD؛ نمایش زندهٔ وضعیت جلسهٔ Claude Code
خلاصهٔ کاملتر
Claude HUD یه پلاگین Claude Code ـه که یه هدف ساده داره: بهت دید بده که تو جلسهت الان دقیقاً چه اتفاقی داره میافته. یه HUD همیشهدیده زیر ورودیت میشینه و اطلاعات کلیدی رو نشون میده.
چیزهایی که میبینی شامل مسیر پروژه، سلامت context (اینکه پنجرهٔ context ت چقدر پر شده)، فعالیت ابزارها (خوندن، ویرایش و سرچ فایلها همون لحظه)، ردگیری ایجنتها (کدوم سابایجنت داره اجرا میشه و چیکار میکنه) و پیشرفت todoهاست. حالت پیشفرضش دو خطیه:
[Opus] │ my-project git:(main*)
Context █████░░░░░ 45% │ Usage ██░░░░░░░░ 25% (1h 30m / 5h)
خط اول مدل، برچسب provider (مثل Bedrock یا Vertex وقتی مطمئن تشخیص داده بشه)، مسیر پروژه و برنچ گیت رو نشون میده، و خط دوم نوار context (سبز → زرد → قرمز) و محدودیتهای مصرف. خطهای اختیاری هم داره که فعالیت ابزار، وضعیت ایجنت و پیشرفت todo رو اضافه میکنه.
راجع به اینکه چطوری کار میکنه، از statusline API بومی خودِ Claude Code استفاده میکنه؛ به گفتهٔ سازنده برای همین نه پنجرهٔ جداگانه میخواد، نه tmux، و تو هر ترمینالی کار میکنه. دادهٔ توکنها هم مستقیم از Claude Code میاد و تخمینی نیست، با اندازهٔ context گزارششده (از جمله جلسههای جدید یکمیلیونی) هماهنگ میشه و حدود هر ۳۰۰ میلیثانیه آپدیت میشه.
قابل تنظیمه: سه پریست Full، Essential و Minimal داره و بعدش میتونی تکتک عناصر رو خاموش/روشن کنی، سبک نمایش گیت رو عوض کنی یا زبان برچسبها رو تغییر بدی (انگلیسی پیشفرضه و چینی هم بهصورت opt-in هست).
روی امنیت هم تأکید کرده: به گفتهٔ سازنده HUD کاملاً محلیه، هیچ درخواست شبکهای نمیزنه، credential اسکرپ نمیکنه و API غیرمستند صدا نمیزنه؛ فقط JSON نوار وضعیت از stdin، مسیر ترنسکریپت جلسه، بعضی فایلهای پیکربندی زیر ~/.claude و متادیتای گیت رو میخونه. یه نکتهٔ امنیتی مهم هم اینه که گزینهٔ --extra-cmd بهطور پیشفرض غیرفعاله و باید صریح فعالش کنی، چون در عمل اجرای دستور دلخواه با دسترسی کاربر توئه؛ سازنده هشدار میده دستور کپیشده از منابع نامطمئن رو باهاش اجرا نکنی. برای دیدن مصرف هم باید با حساب اشتراکی لاگین باشی، نه صرفاً با API key.
نکات کلیدی:
- پلاگین Claude Code با نوار وضعیت همیشگی زیر ورودی
- نمایش مصرف context، فعالیت ابزارها، ایجنتهای فعال، todoها، مسیر پروژه و برنچ گیت
- مبتنی بر statusline API بومی؛ بدون پنجرهٔ جدا یا tmux، در هر ترمینالی
- دادهٔ توکن واقعی (نه تخمینی)، سازگار با context یکمیلیونی، آپدیت هر ~۳۰۰ms
- کاملاً محلی و بدون درخواست شبکه؛ گزینهٔ --extra-cmd بهطور پیشفرض غیرفعاله




