
بقلم: يوسف | محرر أدوات الذكاء الاصطناعي · صوت تحريري بإشراف بشري
CodeBurn تحل مشكلة حقيقية يواجهها كل مطور يستخدم الذكاء الاصطناعي: أين تذهب أموالي تحديداً؟ الأداة الجديدة من AgentSeal تراقب استهلاك الرموز المميزة والتكاليف عبر سبع منصات رئيسية، وتكشف أنماط الإنفاق الخفية في كل جلسة برمجة.
تعمل CodeBurn مع Claude Code وClaude Desktop وCodex من OpenAI وCursor وOpenCode وPi وGitHub Copilot بقراءة بيانات الجلسات مباشرة من مجلدات النظام دون الحاجة لمفاتيح API أو وسطاء. تقرأ من ~/.claude/projects/ لـ Claude، و~/.codex/sessions/ لـ Codex، وقواعد بيانات SQLite لـ Cursor في ~/Library/Application Support/Cursor/User/globalStorage/state.vscdb.
الأداة تصنف النشاطات إلى 13 فئة مهام محددة بناء على أنماط استخدام الأدوات والكلمات المفتاحية: البرمجة (Edit وWrite)، التصحيح (كلمات خطأ + استخدام أدوات)، تطوير الميزات (“add”, “create”, “implement”)، إعادة التنظيم (“refactor”, “rename”, “simplify”)، الاختبارات (pytest, vitest, jest في Bash)، الاستكشاف (Read وGrep دون تعديلات)، التخطيط (EnterPlanMode وTaskCreate)، التفويض (Agent spawns)، عمليات Git، البناء والنشر، العصف الذهني، المحادثة، والمهارات العامة.
- التثبيت والتشغيل:
npm install -g codeburnأو تشغيل مباشر بـnpx codeburn، يتطلب Node.js 20+ وتثبيت better-sqlite3 تلقائياً كاعتمادية اختيارية لدعم Cursor وOpenCode - واجهة التحكم التفاعلية:
codeburnللوحة الرئيسية (افتراضياً 7 أيام)،codeburn todayلبيانات اليوم،codeburn monthللشهر، مع إمكانية التنقل بالأسهم والاختصارات 1-2-3-4-5 - تخصيص المنصة:
codeburn report --provider claudeلـ Claude فقط،--provider cursorلـ Cursor،--provider copilotلـ GitHub Copilot، مع إمكانية التبديل بالضغط علىpفي الواجهة - تقارير مخصصة:
codeburn report -p 30daysلنافزة 30 يوماً متحركة،codeburn report -p allلكل الجلسات المسجلة،codeburn report --refresh 60للتحديث كل 60 ثانية - التصدير والحالة:
codeburn exportلملفات CSV تشمل اليوم و7 أيام و30 يوماً،codeburn export -f jsonلـ JSON،codeburn status --format jsonلملخص سريع - إدارة العملات:
codeburn currency GBPللجنيه الإسترليني،codeburn currency JPYللين الياباني، يدعم 162 عملة ISO 4217 مع أسعار صرف من البنك المركزي الأوروبي - شريط القوائم لـ macOS:
codeburn install-menubarلتثبيت إضافة SwiftBar تظهر تكلفة اليوم مع تحديث كل 5 دقائق وقائمة منسدلة بتفاصيل النشاط
الميزة الفريدة في CodeBurn هي حساب معدل النجاح من المحاولة الأولى (1-shot rate) لكل فئة نشاط. للأنشطة التي تتضمن تعديل الكود، تكتشف الأداة دورات المحاولة والتصحيح (Edit → Bash → Edit) وتحسب نسبة المحاولات الناجحة بلا إعادة. معدل 90% في البرمجة يعني أن الذكاء الاصطناعي نجح من المحاولة الأولى في 9 من 10 مرات.
تعرض اللوحة الرئيسية متوسط التكلفة لكل جلسة وأغلى خمس جلسات عبر كل المشاريع، مع مخططات يومية للتكلفة، وتفاصيل حسب المشروع والنموذج (Opus/Sonnet/Haiku/GPT-5/GPT-4o/Gemini) والنشاط مع معدل النجاح، والأدوات الأساسية، وأوامر Shell، وخوادم MCP.
التسعير يُجلب من LiteLLM مع تخزين مؤقت لـ 24 ساعة في ~/.cache/codeburn/، ويغطي رموز الإدخال والإخراج وكتابة التخزين المؤقت وقراءته والبحث الشبكي. يشمل مضاعف الوضع السريع لـ Claude وقيم احتياطية مرمزة لكل نماذج Claude وGPT-5 لمنع أخطاء التسعير.
Cursor يخفي النموذج المستخدم في وضع “Auto”، لذا تقدر CodeBurn التكلفة بأسعار Sonnet مع تسمية “Auto (Sonnet est.)” في اللوحة. طريقة عرض Cursor تظهر لوحة اللغات (مستخرجة من كتل الكود) بدلاً من لوحات الأدوات الأساسية/Shell/MCP لأن Cursor لا يسجل استدعاءات الأدوات الفردية. التشغيل الأول على قاعدة بيانات Cursor كبيرة قد يستغرق دقيقة، لكن النتائج تُخزن مؤقتاً والتشغيلات اللاحقة فورية.
GitHub Copilot يسجل رموز الإخراج فقط في حالة الجلسة، لذا تظهر صفوف تكلفة Copilot أقل من تكلفة API الفعلية. النموذج يُتتبع عبر أحداث session.model_change، والرسائل قبل أول تغيير نموذج تُتجاهل لتجنب الإسناد الخاطئ.
نظام الإضافات يجعل إضافة منصة جديدة مجرد ملف واحد، حيث تنفذ كل منصة اكتشاف الجلسات وتحليل JSONL وتطبيع الأدوات وأسماء عرض النماذج. ملف src/providers/codex.ts يقدم مثالاً للتنفيذ.
CodeBurn تكشف أنماطاً مهمة: إذا كان معدل إصابة التخزين المؤقت < 80% فقد تكون المحفزات غير مستقرة، كثرة استدعاءات Read تعني إعادة قراءة نفس الملفات، معدل نجاح منخفض (30% في البرمجة) يشير لدورات إعادة محاولة، هيمنة Opus 4.6 على مهام صغيرة تعني نموذج قوي للغاية، وهيمنة فئة المحادثة تعني أن الوكيل يتحدث بدلاً من العمل.




