التثبيت

npm install -g @openemail/cli

الحزمة ملف واحد مجمّع بلا اعتماديات، وتضيف أمرًا واحدًا إلى PATH لديك: openemail. حزمة SDK التي تستدعي بها API مدمجة فيها، لذا تعمل CLI دائمًا مع حزمة SDK التي اختُبرت معها. يطبع openemail version إصدار الاثنين، وإصدار بيئة التشغيل.

openemail --versionopenemail --help

يجلب npx الحزمة إلى ذاكرة مؤقتة ويشغّلها، وهذا يناسب أمرًا لمرة واحدة، أو مهمة CI، أو عميل MCP يشغّل الجسر المحلي.

npx @openemail/cli --helpnpx -y @openemail/[email protected] whoaminpx -y @openemail/cli mcp serve

لا تحدّث CLI نفسها أبدًا. تتذكر يومًا واحدًا ما قاله سجل npm عن أحدث إصدار. وإذا كان ذلك أقدم، تسأل من جديد في الخلفية أثناء تشغيل أمرك، وبعد انتهاء الأمر تنتظر الجواب خُمس ثانية على الأكثر. وإن وُجد إصدار أحدث، تطبع إشعارًا على stderr بعد انتهاء أمرك:

Update available! 0.0.1 → 0.0.2Changelog: https://openemail.uk/docs/cli/changelogRun `npm i -g @openemail/cli@latest` to update. Disable this notice with OPENEMAIL_NO_UPDATE_CHECK=1

• —أمر التثبيت في الإشعار يطابق مدير الحزم الذي ثبّتّ به.
• —لا إشعار مع --help أو --version أو --json، ولا مع help أو version أو update أو completion، ولا حين لا يكون stdout أو stderr طرفية، ولا في CI.
• —اضبط OPENEMAIL_NO_UPDATE_CHECK=1 لإيقافه في كل مكان. وOPENEMAIL_DISABLE_UPDATE_NOTICE=1 يفعل الشيء نفسه.
• —الطلب الوحيد يذهب إلى سجل npm، ويُحفظ جوابه في ~/.openemail/update-check.json مدة يوم.

يتحقق openemail update فورًا متجاهلًا الذاكرة المؤقتة اليومية، ويطبع إما الأمر الذي يجب تشغيله أو أنك على أحدث إصدار.

npm i -g @openemail/cli@latest

يطبع openemail completion <shell> سكربت إكمال تلقائي لـ bash أو zsh أو fish، مبنيًا من كل أمر وأمر فرعي وخيار في إصدارك. شغّله من جديد بعد أي تحديث.

echo 'eval "$(openemail completion bash)"' >> ~/.bashrc

سجّل الخروج أولًا كي يُبطَل كل تسجيل دخول عبر المتصفح على الخادم، ثم احذف الحزمة والمجلد الذي تحفظ فيه CLI عمليات تسجيل الدخول.

openemail logout --allnpm uninstall -g @openemail/clirm -rf ~/.openemail