کالسو (Calso) ✦

تقویم شمسی + مدیریت کارها، شخصی و لوکال — با سرور MCP برای اتصال به AI.

🔗 صفحه ورود و نصب روی گوشی: soroush83faraz.github.io/calso

دو نسخه دارد:

• نسخه آفلاین (PWA) — soroush83faraz.github.io/calso/app: مستقیم از گیت‌هاب اجرا می‌شود، دیتا در خود دستگاه (IndexedDB)، بدون اینترنت هم کار می‌کند، از کروم قابل نصب روی گوشی. سورس بک‌اند مرورگری: web/src/local/

• نسخه لوکال — سرور Node + SQLite روی کامپیوتر خودت با MCP و نوتیف ویندوز (پایین‌تر)

• Todo به سبک Microsoft To Do: روز من + پیشنهادها، مهم، لیست‌ها با رنگ/ایموجی، گروه‌بندی، زیرتسک (Steps)، یادداشت، ضمیمه فایل، ددلاین/یادآوری/تکرار (شمسی!)، مرتب‌سازی و درگ‌اند‌دراپ، جستجو، انجام‌شده‌ها، دارک مود

• تقویم: شمسی + میلادی، مناسبت‌ها و تعطیلات رسمی ایران، رویدادها، سوییچ شمسی/میلادی، خروجی PDF ماهانه، تبدیل تاریخ، محاسبه سن، فاصله دو تاریخ، ساعت جهانی، قطب‌نما (روی گوشی)

• نوتیفیکیشن: توست ویندوز + پوش گوشی از طریق ntfy

• MCP: ۱۷ ابزار برای اینکه AI تسک بسازد، برنامه‌ات را بخواند و روزت را برنامه‌ریزی کند

اجرا

# بار اول (نصب وابستگی‌ها + بیلد رابط):
npm run setup

# هر بار:
npm start          # یا دابل‌کلیک روی start-calso.bat

بعد باز کن: http://localhost:4820 از گوشی (همان وای‌فای): آدرس IP سیستم را که موقع اجرا چاپ می‌شود باز کن، مثلا http://192.168.1.5:4820

نصب روی گوشی (مثل یک اپ)

اپ را در کروم گوشی باز کن → منوی ⋮ → Add to Home screen. آیکون کالسو به صفحه اصلی اضافه می‌شود. راهنمای کامل: صفحه ورود

اجرای خودکار با روشن شدن ویندوز (اختیاری)

Win+R → بنویس shell:startup → Enter → یک Shortcut از start-calso.bat داخل آن پوشه بگذار.

اتصال به AI (MCP)

claude mcp add calso -- node "C:\Users\Lenovo\projects\calso\mcp\server.js"

بعد در Claude Code می‌توانی بگویی:

• «فردا ساعت ۵ یادم بنداز برم خرید»
• «برنامه این هفته‌ام چیه؟»
• «روزم رو برنامه‌ریزی کن»
• «تسک‌های مهم عقب‌افتاده‌ام رو بذار توی روز من»

نوتیف گوشی (ntfy)

1. اپ ntfy را نصب کن (گوگل‌پلی یا F-Droid)
2. ساده‌ترین راه: در تنظیمات کالسو، سرور را https://ntfy.sh و تاپیک را یک اسم یکتا بگذار (مثل calso-soroush-x7k2) و در اپ ntfy همان تاپیک را Subscribe کن
3. بدون اینترنت/برای وای‌فای خانه: باینری ویندوز ntfy را دانلود و با ntfy serve --listen-http :8090 اجرا کن؛ در کالسو سرور را http://IP-سیستم:8090 بگذار و در اپ گوشی هم Default server را همین آدرس بده
4. دکمه «تست نوتیف گوشی» در تنظیمات را بزن

ساختار

server/   Express API + SQLite + زمان‌بند یادآوری + نوتیف
mcp/      سرور MCP (stdio) — همان دیتابیس
web/      رابط React (RTL، وزیرمتن، تم روشن/تیره)
server/data/events.json   مناسبت‌های ایران (از پروژه متن‌باز persian-calendar)

دیتای تو فقط در server/data/calso.db روی همین سیستم است — هیچ‌چیز جایی آپلود نمی‌شود.