Agentic Inbox: ایمیل کلاینت هوشمند روی Cloudflare Workers
خلاصهٔ کاملتر
Agentic Inbox یه ایمیل کلاینت مدرن و سلفهوستده که کاملاً روی زیرساخت Cloudflare اجرا میشه. اگه دنبال یه راهحل ایمیل میگردی که نه به Gmail وابسته باشه نه به هیچ سرویس شخص ثالث دیگهای، این پروژه میتونه گزینه جالبی باشه — همه چیز زیر کنترل اکانت Cloudflare خودته.
ایمیلهای دریافتی از طریق Cloudflare Email Routing به Worker میرسن. هر mailbox توی یه Durable Object مجزا با پایگاه داده SQLite ایزولهست، یعنی دادههای mailboxها از هم کاملاً جدان. فایلهای پیوست هم توی R2 ذخیره میشن. برای ارسال ایمیل هم از Email Service بایندینگ Cloudflare استفاده میشه.
بخش جذاب ماجرا، ایجنت هوش مصنوعی داخلیشه. این ایجنت با Cloudflare Agents SDK و مدل Workers AI (مشخصاً @cf/moonshotai/kimi-k2.5) ساخته شده و ۹ تا ابزار ایمیلی داره: خوندن اینباکس، جستجوی مکالمات، ساخت پیشنویس پاسخ، و حتی ارسال ایمیل. یه قابلیت مهم اینه که ایجنت به محض رسیدن ایمیل جدید، خودکار یه پیشنویس پاسخ میسازه — ولی قبل از ارسال حتماً باید تأیید صریح کاربر باشه.
معماری پروژه اینطوریه که مرورگر با یه Hono Worker ارتباط برقرار میکنه که هم API و هم SSR رو مدیریت میکنه. درخواستهای /agents/* به یه EmailAgent Durable Object جداگانه میرن که خود ایجنت چت توشه و از طریق WebSocket با فرانتاند ارتباط داره:
Browser → Hono Worker → MailboxDO (SQLite + R2)
│
/agents/* → EmailAgent DO (AIChatAgent + Workers AI)
استک فنی پروژه هم کاملاً مدرنه: در فرانتاند از React 19، React Router v7، Tailwind CSS، Zustand، و TipTap استفاده شده. بکاند روی Hono و Cloudflare Workers هستش. برای احراز هویت هم از Cloudflare Access JWT validation استفاده میشه که در محیط پروداکشن اجباریه.
یه نکته امنیتی مهم اینه که این اپ هیچ کنترل دسترسی سطح mailbox نداره — هر کسی که از Cloudflare Access رد بشه به همه mailboxها دسترسی داره. این شامل سرور MCP روی /mcp هم میشه، که ابزارهای خارجی مثل Claude Code یا Cursor میتونن با پاس دادن mailboxId روی هر mailbox عملیات انجام بدن. پس تنها مرز امنیتی، همون پالیسی Cloudflare Access هستش.
برای دپلوی، پروژه یه دکمه «Deploy to Cloudflare» داره که R2، Durable Objects، و Workers AI رو خودکار میسازه. بعد از اون باید Cloudflare Access رو فعال کنی، Email Routing رو با یه catch-all rule تنظیم کنی، و یه mailbox بسازی. پروژه تحت لایسنس Apache 2.0 منتشر شده.
نکات کلیدی:
- ایمیل کلاینت سلفهوستد کاملاً روی Cloudflare Workers با رابط وب مدرن
- هر mailbox توی Durable Object مجزا با SQLite ایزولهست، پیوستها توی R2
- ایجنت هوشمند داخلی با ۹ ابزار ایمیلی، ساختهشده با Cloudflare Agents SDK
- قابلیت پیشنویس خودکار برای ایمیلهای دریافتی، با الزام تأیید کاربر قبل از ارسال
- پشتیبانی از MCP برای اتصال ابزارهای خارجی مثل Claude Code و Cursor
- احراز هویت از طریق Cloudflare Access؛ بدون کنترل دسترسی سطح mailbox
- استک: React 19، Hono، Cloudflare Workers، AI SDK v6، مدل kimi-k2.5




