كل الكتابات
2026-08-11 · 10 دقيقة قراءة · plane-cli
plane-cli: عميل Plane يطبع الأمر التالي لك
Bun وثنائي واحد وتأكيدات كتابة لوكلاء الذكاء الاصطناعي ولماذا تهمّ UUID في المساعدة.
أستخدم Plane للتتبع. واجهة الويب جيدة. الـ API جيدة. ما لم يكن جيداً هو العيش في المتصفح لـ «قائمة الأخطاء العاجلة، تعليق، نقل الحالة» بينما أعيش أصلاً في الطرفية مع الوكلاء.
فكتبت plane-cli — ثنائي plane مكتفٍ ذاتياً. تجميع Bun، بلا runtime لـ Node على الهدف. سحابة أو استضافة ذاتية. MIT. منفرد.
رهان تجربة الاستخدام
معظم واجهات سطر الأوامر ترمي JSON أو جدولاً جميلاً وتتركك.
هذه تطبع كتل Next (copy-paste ready) مع UUID حقيقية. هكذا يتعلّم البشر والوكلاء القواعد دون وثائق.
المعمارية (أبقِها مملة)
| الطبقة | المهمة |
|---|---|
index.ts | الإعدادات والتوجيه والأخطاء |
cli/ | تحليل الوسائط وشجرة الأوامر ومساعدة مولّدة |
commands/ | وحدة لكل مورد؛ الأوامر كبيانات |
api/ | عميل مُنمَّط مثل api.project(id).item(id) |
render/ | كل ما يُطبع — الأوامر لا تنسّق نفسها |
config.ts / state.ts / history.ts | .planerc و.plane/ وسجل محلي |
تأكيد الكتابة (ميزة الوكلاء)
أول كتابة لكل مشروع في مجلد تتوقف وتعرض بالضبط ما سيحدث. أعد التشغيل بـ --yes.