Smart Scheduling

Never miss a lecture or a deadline with natural language reminders.

StudentSync includes a cron-backed scheduler that lets you set reminders using natural language. These are delivered directly to your Telegram or WhatsApp chat.

How to use

Simply tell the bot what you want to be reminded about and when. It handles the complex cron scheduling for you.

  • One-time: "Remind me to submit the lab in 2 hours."
  • Recurring: "Remind me every day at 9am to study OS."
  • Specific date: "Remind me on May 15th to check my grades."

Managing Tasks

You can view and cancel your scheduled tasks at any time.

  • /reminders (or "List my reminders"): Shows all active scheduled jobs.
  • /cancel <id>: Stops a specific reminder from firing.
bash
# Example interaction
User: Remind me every Monday to go to the gym.
Bot: ✅ Scheduled! I'll remind you every Monday at 09:00.

Always Awake

Reminders work best when StudentSync is running in Daemon Mode via PM2. This ensures your scheduler is always active in the background.

Implementation

The scheduling engine uses node-cron and persists jobs across restarts in the local user store. If the bot is down when a reminder is supposed to fire, it will attempt to send it as soon as it comes back online.