claude-email  ·  نسخه ۱ · متن‌باز
English
ارسال شماره ۰۰۱ · ایمیل ← عامل

claude-email مکاتبه‌ای با عامل‌های هوشمند

همان‌طور که به یک همکار نامه می‌نویسید، به Claude نامه بنویسید — از صندوق ورودی خودتان.

پوشش ایمیل‌محور برای خط فرمان Claude Code با رله چت MCP یکپارچه. صندوق IMAP را بررسی می‌کند، فرستنده را با GPG یا رمز مشترک تایید می‌کند، دستور را اجرا می‌کند و پاسخ را با SMTP می‌فرستد. یک پوشش، چندین عامل، و هر سرویس‌گیرنده ایمیلی.

باز کردن مخزن
۰۱

فهرست ویژگی‌ها چرا با ایمیل به یک ربات بنویسیم

  1. № ۰۱

    ایمیل به‌جای ترمینال

    هر سرویس‌گیرنده ایمیلی به یک کنترل از راه دور جهانی برای Claude Code تبدیل می‌شود. دستور را می‌فرستید، نتیجه را به‌عنوان پاسخ رشته‌ای دریافت می‌کنید. نه نصب نرم‌افزار، نه VPN.

  2. № ۰۲

    احراز هویت دوگانه

    هر پیام ورودی با From، Return-Path و یکی از دو روش GPG یا رمز مشترک چرخشی تایید می‌شود. نامه‌های بدون امضا از غریبه‌ها در همان لحظه دور ریخته می‌شوند.

  3. № ۰۳

    گذرگاه چت چند عاملی

    یک سرور MCP بر بستر SSE و SQLite (حالت WAL) به چندین عامل Claude Code اجازه می‌دهد از طریق رله پیام مشترک هماهنگ شوند. ارزان، محلی، و آن‌قدر ساده که قابل اتکا باشد.

  4. № ۰۴

    هماهنگی عامل‌ها

    هر عامل را با @agent-name هدف بگیرید، با spawn یکی تازه در مسیر پروژه به‌راه بیندازید، یا همگانی بفرستید. رشته‌بندی، بررسی زنده‌بودن و پاک‌سازی را سیستم انجام می‌دهد. هر پروژه‌ای که ارکستراتور به آن دست می‌زند سه قلاب می‌گیرد: SessionStart ردیف ثبت را مستقیم روی SQLite گذرگاه می‌نویسد (قطعی)، UserPromptSubmit هر پیام رسیده را به نوبت بعدی مدل تحویل می‌دهد، و Stop در پایان هر پاسخ عامل دوباره صندوق را زهکشی می‌کند — اگر پیامی از عامل دیگری در راه باشد، با decision:block توقف را لغو می‌کند تا پیام بلافاصله نوبت بعدی عامل شود. پیام‌های همتا که وسط یک پاسخ می‌رسند دیگر منتظر پیام بعدی کاربر نمی‌مانند. عامل‌ها با chat_message_agent می‌توانند به هم پیام بدهند — همتا به همتا، بدون عبور از کاربر.

  5. № ۰۵

    systemd سطح کاربر

    دو سرویس سبک، بی‌نیاز از sudo، بی‌نیاز از کانتینر. راه‌اندازی مجدد خودکار، ترتیب وابستگی میان ایمیل و چت، و پشتیبانی از lingering تا پس از خروج هم زنده بمانند.

  6. № ۰۶

    تست‌شده تا حاشیه‌ها

    ۹۸۰ تست، پوشش ۱۰۰٪، پایتون ۳.۱۲، کاملا تایپ‌شده، shell=False همه‌جا، و TLS با کانتکست امن. کسل‌کننده به‌عمد؛ تا بردارهای نفوذ بسته بمانند.

  7. № ۰۷

    داشبورد رصدخانه زنده

    یک داشبورد کاملا گرافیکی در /dashboard گذرگاه را به‌صورت یک رادار CRT نمایش می‌دهد: کاربر در مرکز، عامل‌ها دور یک حلقه، و هر پیام به‌صورت یک نقطه درخشان روی وتر میان فرستنده و گیرنده حرکت می‌کند. یال‌های پایدار «گرما» کانال‌های پرترافیک را برجسته می‌کنند و یک ثبت مخابرات بدنه‌ها را روی EventSource زنده پخش می‌کند. دو چهره دیگر پشت دکمه‌های بالای صفحه نشسته‌اند: یک نمودار فنیِ زنده که با هر رویداد wake_watcher یا درین هوک، کارت گام مربوطه را روشن می‌کند، و یک پنل واژه‌نامه قابل جستجو که هر سرنام و اصطلاح پروژه را فهرست کرده است. عامل‌های شبح که heartbeat آن‌ها کهنه شده از دید پنهان می‌شوند تا رادار تصویر واقعیت را بدهد.

  8. № ۰۸

    همراه اندروید (در دست ساخت)

    یک اپ بومی اندروید در یک مخزن همراه جداگانه در حال ساخت است تا بتوانید از راه تلفن همراه دستور بفرستید و به عامل‌ها پاسخ دهید، بدون اینکه در یک سرویس‌گیرنده ایمیل عمومی بنویسید. همان بستر IMAP/SMTP، بدون تغییر در سمت سرور. لینک مخزن و تصاویر به‌زودی اضافه می‌شوند.

۰۲

سازوکار چگونه یک نامه به یک وظیفه بدل می‌شود

دو سرویس systemd سطح کاربر کار را پیش می‌برند. claude-email صندوق IMAP را هر چند ثانیه بررسی می‌کند، فرستنده را تایید می‌کند، دستور را از متن ایمیل بیرون می‌کشد، و آن را از راه claude --print اجرا می‌کند. نتیجه به‌صورت پاسخ رشته‌ای بازمی‌گردد.

claude-chat یک گذرگاه پیام MCP خالص است. عامل‌ها ثبت می‌شوند، پیام می‌فرستند و از راه ابزارهای MCP روی SSE پرس‌وجو می‌کنند. سرویس ایمیل در همین گذرگاه، آواتار شماست — دستورهای ایمیلی را به عامل‌ها می‌راند و پاسخ‌ها را به‌صورت ایمیل بیرون می‌آورد.

به‌جای چت‌بات، به یک مرکز تلگراف قدیم فکر کنید: اپراتورها ترافیک را جابه‌جا می‌کنند، هر پیام امضا می‌شود، هر پرش ثبت می‌شود.

Email Client ↓ IMAP Poll (claude-email) ↓ Verify sender (GPG / shared secret) ↓ ├─ Direct → claude --print ────────→ SMTP reply └─ Chat → MCP bus (claude-chat) ↓ Agents respond ────────→ SMTP reply
۰۳

شروع کار نصب و ارسال نخستین نامه

مخزن را کلون کرده و نصب‌کننده را اجرا کنید:

git clone https://github.com/cocodedk/claude-email.git
cd claude-email
cp .env.example .env    # تنظیم IMAP/SMTP و AUTHORIZED_SENDER
bash install.sh         # ساخت venv + هر دو سرویس systemd

نصب‌کننده یک محیط مجازی پایتون می‌سازد، وابستگی‌ها را نصب می‌کند و هر دو سرویس claude-email و claude-chat را به‌عنوان سرویس‌های سطح کاربر با ترتیب وابستگی درست ثبت می‌کند.

# بررسی وضعیت سرویس
systemctl --user status claude-email
systemctl --user status claude-chat

# دنبال کردن لاگ
journalctl --user -u claude-email -f

از آن لحظه به بعد، هر ایمیلی که به نشانی پیکربندی‌شده بفرستید — از فرستنده امضاشده، در قالب خواسته‌شده — توسط Claude اجرا می‌شود و پاسخش به همان نخ برمی‌گردد. می‌توانید دستور را از گوشی، صندوق ورودی، یا mutt بنویسید. بدون نیاز به برنامه.