منصوبے کے بارے میں

cc-grass ایک چھوٹا Node.js کمانڈ لائن ٹول ہے جو مقامی Claude Code سرگرمیوں کو GitHub طرز کے کنٹریبیوشن گراف میں تبدیل کرتا ہے، جو ایک اسٹینڈ الون SVG کے طور پر رینڈر ہوتا ہے، جس میں خانے سبز کے بجائے اورنج رنگ کے ہوتے ہیں۔ یہ ~/.claude/projects کے تحت JSONL فائلوں کے طور پر محفوظ سیشن ٹرانسکرپٹس کو پڑھتا ہے، اور اگر ~/.codex موجود ہو، تو OpenAI Codex CLI کے ذریعے ~/.codex/sessions سے سیشن رول آؤٹس کو بھی پڑھتا ہے۔ README میں اس کی وجہ واضح طور پر بتائی گئی ہے: Claude Code پہلے ہی /usage Stats کے تحت ٹرمینل کے اندر ایک استعمال کا گراف بناتا ہے، لیکن وہ منظر مقامی رہتا ہے۔ cc-grass اسی بنیادی ڈیٹا کو ایک ایسی فائل کے طور پر دوبارہ رینڈر کرتا ہے جسے آپ GitHub پروفائل README، پورٹ فولیو پیج یا کسی بھی دوسری جگہ کمٹ اور ایمبیڈ کر سکتے ہیں۔ README سے لیے گئے نفاذ اور ڈیزائن کے نوٹس: - زیرو رن ٹائم ڈیپینڈنسیز: صرف Node کے fs، path اور os ماڈیولز۔ کوئی ccusage نہیں، کوئی API کالز نہیں۔ macOS، Linux اور Windows پر Node 18 یا اس سے نیا ورژن درکار ہے۔ - ایک انکریمنٹل کیش کا مطلب ہے کہ بار بار چلانے پر صرف نئی یا تبدیل شدہ سیشن فائلوں کو دوبارہ پارس کیا جاتا ہے۔ اسے --no-cache کے ذریعے بند کیا جا سکتا ہے، اور کیش ڈائریکٹری ڈیفالٹ طور پر ~/.cache/cc-grass ہے۔ - SVG بالکل GitHub کے لے آؤٹ کی نقل ہے: 10 بائی 10 خانے، 3px گیپس، گول کونے، پیر/بدھ/جمعہ کی قطاروں کے لیبل، ماہانہ ہیڈرز اور Less/More لیجنڈ۔ - آؤٹ پٹ ایک واحد SVG ہے، یا --html فلیگ کے ذریعے ایک سادہ HTML صفحہ ہے۔ یہ پروجیکٹ جان بوجھ کر کوئی ڈیمن، شیڈولر یا بنڈل شدہ GitHub Actions ورک فلو فراہم نہیں کرتا؛ شیڈولنگ صارف پر چھوڑ دی گئی ہے، اور README ایک crontab مثال دکھاتا ہے جو فائل کو دوبارہ تیار کرتا ہے اور صرف تب کمٹ کرتا ہے جب اس میں واقعی تبدیلی آئی ہو۔ آپشنز میں میٹرک کا انتخاب (prompts، sessions یا tokens، ڈیفالٹ tokens)، --since اور --until کے ذریعے تاریخ کی حد، ڈارک یا لائٹ تھیم، ایک اوور رائیڈنگ ہیڈر اسٹرنگ، متبادل Claude اور Codex ڈیٹا ڈائریکٹریز، Codex ڈیٹا کو خارج کرنا، سب ایجنٹ ٹرانسکرپٹس کو خارج کرنا، اور کیش لوکیشن کو تبدیل کرنا شامل ہے۔ ٹوکن اکاؤنٹنگ: روزانہ کے ٹوکن کاؤنٹ ہر انٹری کے لیے ان پٹ، آؤٹ پٹ، کیش تخلیق اور کیش ریڈ ٹوکنز کا مجموعہ ہے، یعنی ہر وہ چیز جس کے لیے API بل کرے گی۔ سب ایجنٹ فائلیں ڈیفالٹ طور پر شامل ہیں؛ انہیں خارج کرنے سے وہ اعداد و شمار سامنے آتے ہیں جو Claude Code /usage میں دکھاتا ہے۔ Codex سیشنز کو token_count ایونٹس میں cumulative total_token_usage ویلیوز سے ڈیلٹاس کا استعمال کرتے ہوئے گنا جاتا ہے، تاکہ ڈپلیکیٹ ایونٹس دو بار نہ گنے جائیں۔ HTML آؤٹ پٹ ہر ماڈل کے لیے تخمینہ شدہ API لاگت بھی دکھاتا ہے جو کہ فی ملین ٹوکن ریٹس پر مبنی ہوتی ہے؛ جن ماڈلز کی ریٹ معلوم نہیں ہوتی وہاں not-available قیمت کا نشان ظاہر ہوتا ہے، اور README میں ذکر ہے کہ سبسکرپشن صارفین اصل میں یہ رقم ادا نہیں کرتے۔ دو احتیاطیں ایمانداری سے بیان کی گئی ہیں۔ پہلا، ہر خانے کے ہوور ٹول ٹپس SVG ٹائٹل عناصر کا استعمال کرتے ہیں؛ یہ اسٹینڈ الون SVG ویورز اور HTML آؤٹ پٹ میں کام کرتے ہیں، لیکن GitHub README میں ایمبیڈ ہونے پر نہیں، کیونکہ GitHub اسے ایک تصویر کے طور پر پیش کرتا ہے اور براؤزرز وہاں ٹائٹلز کو نظر انداز کر دیتے ہیں۔ دوسرا، نمونہ SVG اور لنک شدہ انٹرایکٹو صفحہ مصنف کی حقیقی سرگرمی دکھاتے ہیں، اس لیے README مشورہ دیتا ہے کہ آپ اپنا گراف شائع کرتے وقت محتاط رہیں۔ ایک پروگرامیٹک API بھی فراہم کی گئی ہے: parseClaudeProjects اور renderSvg کو اپنے کوڈ میں وہی چارٹ بنانے کے لیے امپورٹ کیا جا سکتا ہے۔ یہ پروجیکٹ MIT لائسنس کے تحت ہے۔