intelligent-scheduler

Schedule tasks intelligently. Handle priorities, time zones, and conflicts automatically — never miss a deadline or double-book again.

What It Does

Manage your agent's time like a pro:

• Task scheduling — Add tasks with deadlines and priorities
• Priority queues — Critical tasks always come first
• Conflict detection — Auto-detect overlapping commitments
• Timezone handling — Schedule across multiple time zones seamlessly
• Smart rescheduling — Auto-fill gaps and optimize your calendar

Quick Start

# 1. Schedule a high-priority task
node scheduler.js add "Review PR #42" --time "14:00" --priority high

# 2. Check for conflicts today
node scheduler.js check-conflicts --date today

# 3. View prioritized queue
node scheduler.js queue --sort priority

# 4. Convert meeting time for remote team
node scheduler.js convert "14:00 Asia/Shanghai" --to "America/New_York"
# → 01:00 EDT (next day)

Common Use Cases

📋 Daily Task Prioritization

# Add tasks with priorities
node scheduler.js add "Fix critical bug" --priority critical
node scheduler.js add "Update documentation" --priority medium
node scheduler.js add "Research new library" --priority low

# View queue sorted by priority
node scheduler.js queue --sort priority
# → 1. Fix critical bug (critical)
# → 2. Update documentation (medium)
# → 3. Research new library (low)

🌍 Multi-Timezone Meeting Coordination

# Schedule meeting in your timezone
node scheduler.js add "Client call" --time "2024-03-15 09:00" --tz "America/New_York"

# Check what time that is for your teammate in Tokyo
node scheduler.js convert "2024-03-15 09:00 America/New_York" --to "Asia/Tokyo"
# → 22:00 JST (same day)

⚠️ Prevent Double-Booking

# Add two overlapping events
node scheduler.js add "Team standup" --time "09:00" --duration 30
node scheduler.js add "Client call" --time "09:15" --duration 45

# Detect conflicts
node scheduler.js check-conflicts --date today
# → CONFLICT: "Team standup" (09:00-09:30) overlaps "Client call" (09:15-10:00)

🔄 Auto-Optimize Schedule

# Fill gaps and reschedule around priorities
node scheduler.js auto-reschedule --fill-gaps --respect-priority
# Moves low-priority tasks to fill empty slots
# Keeps critical tasks at preferred times

All Commands

Priority Levels

critical > high > medium > low > deferred

Use critical for outages and deadlines. Use deferred for "someday" tasks.

Configuration

// .scheduler/config.json
{
  "timezone": "Asia/Shanghai",
  "workHours": { "start": "09:00", "end": "18:00" },
  "bufferMinutes": 15,
  "rules": [
    "No meetings before 10:00 on Mondays",
    "Reserve Friday afternoons for deep work",
    "Critical tasks always scheduled first"
  ]
}

Examples

Schedule with dependency:

node scheduler.js add "Review PR" --time "14:00" --priority high
node scheduler.js add "Deploy after review" --time "16:00" --depends "Review PR"

Filter today's tasks:

node scheduler.js queue --filter today

Respect work hours:

node scheduler.js add "Urgent task" --time "20:00" --respect-work-hours false