CLI
سجل التغييرات
كل إصدار من CLI، الأحدث أولًا.
0.0.1
الإصدار الأول: OpenEmail كله من طرفية، مع تسجيل دخول عبر المتصفح للأشخاص ومفاتيح API للسكربتات.
- تسجيل الدخول:
openemail loginفي المتصفح، يعود إلى الطرفية من تلقاء نفسه على سطح المكتب، وعبر رمز يُلصق عبر SSH أو مع--no-browser. مفاتيح API عبر--tokenأو--with-tokenأوOPENEMAIL_API_KEYأو--api-key. والملفات الشخصية عبرprofile listوuseوcurrentوremove. - رموز وصول تُجدَّد قبل أن تنتهي، بتجديد واحد في كل مرة لكل ملف شخصي، ورموز تحديث تعمل مرة واحدة: الرمز القديم الذي يُستخدم بعد أكثر من 30 ثانية من استبداله يجعل الخادم يُبطل تسجيل الدخول ذاك.
- تسجيل الدخول المحفوظ لا يذهب إلا إلى الـ API الذي سجّل الدخول إليه. ويُرفض
httpغير المشفّر إلا علىlocalhostو127.0.0.1و::1، ومسار الطلب الذي سيخرج من أصل الـ API يتوقف بـinvalid_path. - رموز التحقق قبل التغييرات الحساسة مع تسجيل الدخول عبر المتصفح، تُطلب حين يحتاج إليها أمر، أو مسبقًا عبر
openemail verify. وهي تغطي REST API وأدوات MCP التي تُجري التغييرات نفسها. - يمكن لكل تسجيل دخول أن يطلب 5 رموز في الساعة و20 في اليوم. وعشرة رموز خاطئة في 24 ساعة توقف التحقق الخاص به مؤقتًا، فتقول CLI متى يُستأنف وتخرج برمز الخروج
4وstep_up_paused. whoamiوstatusوlogoutالذي يُبطل تسجيل الدخول عبر المتصفح على الخادم.- الإرسال عبر
send: نص، أو HTML، أو ملف، أو stdin، أو محررك، ومرفقات بأي حجم، وجدولة، ومهلة للتراجع، وترجمة، وقوالب، ووسوم. - صندوق البريد:
inboxوsearchوreadوreply، وarchiveوunarchiveوtrashوstarوunstarوmarkوsnoozeوunsnoozeوlabel. - صناديق الوارد المؤقتة عبر
temp newوlistوreadوwatchوdelete، دون تسجيل دخول. - أمر مورد لكل طريقة في SDK: 282 طريقة في صورة 198 أمرًا في 26 مساحة أسماء، مع استبعاد
securityمن المساعدة لأنopenemail verifyيغطيه. خيارات ذات أنواع، و--dataمن JSON أو ملف أو stdin، والتصفح عبر الصفحات بـ--allو--maxو--ndjson، والتنزيلات عبر--out، وتأكيد قبل أي شيء مدمّر. - الذكاء الاصطناعي:
ai translateوai languagesوai composeوai summarize. - MCP:
mcp configلـ Claude Code وClaude Desktop وCursor وVS Code وWindsurf وCodex، وmcp serveكجسر stdio محلي، وmcp toolsوmcp call، الذي يطلب رمز تحقق ويستدعي الأداة من جديد حين تحتاج أداة إليه. docs askوdocs openوdocs read، وopenلصفحات تطبيق الويب، وapiلأي استدعاء REST.- السكربتات:
--jsonمع غلاف أخطاء على stderr، وتدفقات NDJSON، ورموز خروج ثابتة، و--no-input، واكتشاف CI. - مساعدة لكل أمر ومجموعة، واقتراحات للأوامر والخيارات المكتوبة خطأً، وإكمال تلقائي لـ bash وzsh وfish.
- تسجيلات الدخول ورموز صناديق الوارد في
~/.openemail، لا يقرؤها سواك وتُغيَّر تحت ملف قفل، وconfig.jsonالتالف يُحفظ باسمconfig.json.bakبدل أن يُقرأ على أنه تسجيل خروج. - يُنظَّف النص القادم من الخادم قبل أن يصل إلى الطرفية، والمخرجات الموجّهة إلى قارئ بطيء تُكتب كاملة قبل أن تخرج CLI.
- إشعار تحديث يومي يوقفه
OPENEMAIL_NO_UPDATE_CHECK=1، وopenemail update. - ملف واحد مجمّع بلا اعتماديات، على Node.js 20.12 أو أحدث.
ليس في هذا الإصدار: الفوترة، ومساحات العمل، وأمان الحساب، وتصدير البيانات، وتغييرات التقويم، وإعادة التوجيه، وربط مزوّد DNS، ودردشة المساعد تبقى حاليًا في تطبيق الويب، ويأخذك openemail open إلى كل منها.
npm install -g @openemail/cliopenemail loginopenemail inbox