قاعدة المعرفة
سطر الأوامر
صندوق بريدك وكل عملية في API، من طرفية أو من سكربت.
التفاصيل
- الأمر
openemail، ويُثبَّت من npm باسم@openemail/cli. هو ملف واحد بلا اعتماديات ويحتاج إلى Node.js 20.12 أو أحدث. يثبّتهnpm i -g @openemail/cli، ويشغّلهnpx @openemail/cli <command>دون تثبيت. - هناك طريقتان لتسجيل الدخول. يفتح
openemail loginمتصفحك، حيث تختار مساحة العمل والأذونات ومدة الوصول، وكل تسجيل دخول عبر المتصفح تطبيق مرتبط يمكنك إزالته من الحساب → التطبيقات المرتبطة. أما مفتاح API، المحفوظ بـopenemail login --with-tokenأو المضبوط فيOPENEMAIL_API_KEY، فلا يفتح متصفحًا أبدًا ولا يطلب رمزًا أبدًا، ولذلك يناسب السكربتات وCI. - تسجيل الدخول عبر المتصفح يتصرف باسمك، لذا يطلب أي تغيير حساس، مثل إضافة خطاف ويب أو إزالة نطاق، رمز التحقق نفسه الذي يطلبه تطبيق الويب. يغطي رمز واحد تسجيل الدخول ذاك لمدة 60 دقيقة، ويطلبه
openemail verifyقبل أن يعمل السكربت. - تعمل
inboxوsearchوreadوreplyوsendعلى صندوق البريد كما يفعل التطبيق، بصيغة البحث نفسها والمرفقات والإرسال المجدول والتراجع والترجمة. وتقبلarchiveوstarوsnoozeوسائر إجراءات المحادثات عدة معرّفات محادثات دفعة واحدة. - كل طريقة في SDK أمرٌ،
openemail <resource> <verb>، فكل ما تستطيعه REST API يستطيعه سطر الأوامر. ويستدعيopenemail apiأي مسار مباشرة، بتسجيل الدخول نفسه. - تجلب
ai translateوai composeوai summarizeميزات الذكاء الاصطناعي إلى الطرفية. ويطبعopenemail mcp configالإعداد لـ Claude Code وClaude Desktop وCursor وVS Code وWindsurf وCodex، ويتيحopenemail mcp serveلمثل هذا العميل إعادة استخدام تسجيل دخول سطر الأوامر. - صُمِّم للسكربتات: تذهب البيانات إلى stdout وكل ما عداها إلى stderr، ويطبع
--jsonبصيغة JSON فقط، ويمر--allعلى كل صفحة من القائمة، ولكل نوع من الإخفاق رمز خروج خاص، ولا يُطرح أي سؤال في CI أو دون طرفية. ويُنشئopenemail tempصندوقًا مؤقتًا دون حساب ودون مفتاح، وينتظرtemp watch --firstأول رسالة فيه. - ما ينقص: الفوترة، وإنشاء مساحات العمل والتبديل بينها، وأمان الحساب، وتصدير البيانات، وكتابة أحداث التقويم، وإعادة التوجيه، وربط مزوّد DNS تحتاج إلى جلسة متصفح، لذا لا يقوم بها سطر الأوامر بعد، ويفتح
openemail openبدلًا من ذلك الصفحة الصحيحة في تطبيق الويب. ومثل SDK، ليس له مسار إصدار آلي، فتصل النسخة إلى npm حين ينشرها أحدهم.
