aircon-scheduler

Aircon Scheduler

Create and manage cron jobs for automated aircon control via REST API.

Prerequisites

• Sharp Aircon API running at http://localhost:3000
• cron available (standard on macOS/Linux)

Verify API is running before creating schedules:

curl -s http://localhost:3000/

Cron Tag Convention

All entries MUST include #aircon tag for identification:

30 22 * * * curl -s ... #aircon sleep-phase1

Sub-tags: sleep-phase1..sleep-phase5, morning, morning-off, evening, away, return, custom-LABEL

Schedule Management

# List aircon schedules
crontab -l | grep '#aircon'

# Remove all aircon schedules
crontab -l | grep -v '#aircon' | crontab -

# Remove specific group (e.g., sleep)
crontab -l | grep -v '#aircon sleep' | crontab -

# Add multiple entries
(crontab -l 2>/dev/null; cat <<'EOF'
ENTRIES_HERE
EOF
) | crontab -

Workflow

Creating a Schedule

1. Ask user for: timing (bedtime/wake or specific times), purpose (sleep/morning/custom)
2. Read references/templates.md for season-specific templates and API commands
3. Adjust template temperatures for current season (consult smart-aircon skill for optimal values if unsure)
4. Show generated cron entries for user review
5. After approval, install and verify with crontab -l | grep '#aircon'

Modifying a Schedule

1. List current: crontab -l | grep '#aircon'
2. Remove target group: crontab -l | grep -v '#aircon GROUP' | crontab -
3. Add updated entries

Notes

• cron runs with minimal PATH; curl is typically at /usr/bin/curl
• Append >/dev/null 2>&1 before tag to suppress cron mail
• Weekend-only: use * * * * 0,6 for day-of-week
• Each cron entry runs independently; one failure does not affect others
• Season changes require updating schedule temperatures manually
• For one-time recommendations, use the smart-aircon skill instead