پایگاه دانش
خط فرمان
صندوق پستی شما و هر عملیات 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 میرسد که کسی آن را منتشر کند.
