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