Schedule tasks, manage priorities, resolve conflicts, and handle time zones. Auto-optimizes your agent's workload and prevents double-booking.
---
description: Schedule tasks, manage priorities, resolve conflicts, and handle time zones. Auto-optimizes your agent's workload and prevents double-booking.
keywords: task scheduler, priority queue, calendar management, timezone conversion, conflict detection, schedule optimization, deadline tracking
name: intelligent-scheduler
triggers: schedule task, add to calendar, check conflicts, reschedule, priority queue, timezone convert
---
# 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
```bash
# 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
```bash
# 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
```bash
# 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
```bash
# 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
```bash
# 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
| Command | Purpose |
|---------|---------|
| `add "task" --time X` | Schedule a task |
| `queue --sort priority` | View prioritized task list |
| `promote "task" --to critical` | Change task priority |
| `check-conflicts --date X` | Find scheduling conflicts |
| `convert "time" --to TZ` | Convert between time zones |
| `auto-reschedule` | Optimize schedule automatically |
---
## Priority Levels
```
critical > high > medium > low > deferred
```
Use `critical` for outages and deadlines. Use `deferred` for "someday" tasks.
---
## Configuration
```json
// .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:**
```bash
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:**
```bash
node scheduler.js queue --filter today
```
**Respect work hours:**
```bash
node scheduler.js add "Urgent task" --time "20:00" --respect-work-hours false
```
don't have the plugin yet? install it then click "run inline in claude" again.