عن المشروع

Mica Code (MICA — Minimal, Intelligent, Cache-first Agent) هو وكيل برمجة بالذكاء الاصطناعي خفيف وأصلي في الطرفية، وهدفه التصميمي الأساسي هو إعادة استخدام السياق والحفاظ على معدل إصابة عالٍ في ذاكرة التخزين المؤقت. الميزات الرئيسية: - استقرار البادئة وأولوية التخزين المؤقت: الجلسة افتراضيًا append-only، مع تثبيت بادئة system/history قدر الإمكان، ما يحافظ على معدل إصابة عالٍ في ذاكرة التخزين المؤقت حتى في المحادثات الطويلة. - أصلي في الطرفية: واجهة TUI مبنية على Ink، تعطي الأولوية للوحة المفاتيح، وتعرض الوكلاء المتعددين والمهام الخلفية والحالة بشكل مركزي. - مراجع الملفات: كتابة @ تتيح البحث في ملفات مساحة العمل الحالية، واختيار الأسهم ثم الإدراج بـ Enter أو Tab. - Role كسير عمل: /role يستبدل كامل system prompt، ويمكن تهيئة شخصيات مختلفة للكتابة والمراجعة والتخطيط. - أدوات قابلة للتركيب: أدوات مدمجة للملفات والبحث وshell والويب والمهارات، مع دعم ربط السكربتات الشخصية وخدمات الفريق عبر MCP. - قابل للتراجع والضغط والتوقيت: /rewind يعود إلى عقدة محادثة سابقة ويمكنه استعادة الملفات عند وجود نقاط فحص؛ /compact افتراضيًا يستبدل نتائج الأدوات بعناصر نائبة فقط، و/compact llm يستخدم ملخص النموذج؛ /loop ينفذ المهام بشكل دوري بفواصل ثابتة. التثبيت والتهيئة: يمكن التثبيت عبر سكربت install.sh من GitHub Release وتشغيل mica. عند التشغيل الأول يُنشأ ~/.mica/config.json، ويمكن فتح صفحة التهيئة بـ /config. تدعم التهيئة مزودين متعددين، ويمكن أن يكون protocol إما openai_chat_completions أو openai_responses؛ ويمكن تهيئة get_model_url لجلب قائمة النماذج ديناميكيًا، أو تهيئة مصفوفة models ثابتة مباشرة؛ كما تدعم تهيئة mcpServers. واجهة سطر الأوامر: - mica exec: تنفيذ headless لمرة واحدة، البروتوكول متوافق مع OpenAI Codex، ويدعم --json لإخراج ThreadEvent JSONL، و--thinking، و--no-save، و--session، و--dir، و--mcp-init-timeout-ms وغيرها. - mica compact: ضغط السياق لجلسة موجودة، ويدعم --force، و--prune-only، و--tool-results-only، ويخرج JSON يتضمن تقديرات token ونسبة الضغط. - mica commit: يعيد استخدام منطق التحليل الحتمي للأمر التفاعلي /commit، ويرسل طلبًا واحدًا فقط للنموذج لتوليد commit message، ثم ينفذ git add/commit/push ويخرج JSON. - mica app-server: عملية جلسة دائمة، تكشف مجموعة فرعية من بروتوكول Codex v2 App Server، وتدعم الحقن التكراري turn/steer. هذا المشروع مناسب للمطورين الذين يرغبون في استخدام مساعد برمجة بالذكاء الاصطناعي داخل الطرفية، ويهتمون بكفاءة ذاكرة التخزين المؤقت للسياق وإمكانية الاستدعاء عبر السكربتات.