Smart Scheduling

Automate recurring tasks with Claude. Jobs run on a schedule via launchd (macOS) or cron (Linux), with built-in cost caps to prevent runaway spending.

Managing Schedules

# Add a scheduled job (inline)
openpaw schedule add "weekdays 8am" --run "check email and summarize the important ones"
openpaw schedule add "daily 9pm" --run "review today's GitHub notifications"
openpaw schedule add "every 30 minutes" --run "check if any urgent emails arrived" --model haiku

# Interactive mode (prompts for all options)
openpaw schedule add

# List all jobs
openpaw schedule list

# Remove a job
openpaw schedule remove <id>

# Manually trigger a job
openpaw schedule run <id>

# Enable/disable without removing
openpaw schedule enable <id>
openpaw schedule disable <id>

# View cost usage
openpaw schedule costs

# Set daily cost cap
openpaw schedule set-cap 10.00

Schedule Syntax

Human-readable formats:

• weekdays 8am or weekdays 08:00
• daily 9pm or daily 21:00
• weekends 10am
• every 30 minutes
• every 2 hours
• monday 9am, friday 5pm, etc.
• Raw cron: 0 8 * * 1-5

Cost Control

• Daily cap: $5/day by default — jobs are skipped if the cap would be exceeded
• Per-run budget: Each job has its own budget cap (default $1.00)
• Cost tracking: All costs logged to ~/.config/openpaw/schedule-costs.json
• 30-day history: Old entries auto-pruned
• View anytime: openpaw schedule costs

Delivery Methods

• telegram — results sent directly to your Telegram (requires Telegram bridge setup)
• file — saved to ~/.config/openpaw/schedule-results/ (always saved as backup)
• notify — macOS notification via terminal-notifier

How It Works

1. Jobs are stored in ~/.config/openpaw/schedules.json
2. Each job registers as a system scheduler:
   • macOS: launchd plist in ~/Library/LaunchAgents/
   • Linux: crontab entry
3. When triggered, openpaw schedule run <id> is called
4. Claude runs with the job's prompt via the Agent SDK
5. Results are delivered to the configured channel
6. Cost is recorded

Guidelines

• Use haiku for simple, frequent checks (cheapest)
• Use sonnet for routine tasks like email summaries
• Use opus only for complex analysis (expensive)
• Test jobs manually first: openpaw schedule run <id>
• Start with a higher per-run budget and reduce once you know typical costs
• Check openpaw schedule costs to monitor spending

Common Recipes

# Morning briefing to Telegram
openpaw schedule add "weekdays 8am" --run "give me a morning briefing: check email, calendar, and any GitHub notifications" --delivery telegram

# Evening project summary
openpaw schedule add "daily 6pm" --run "summarize what I worked on today based on git commits and recent files" --delivery file

# Urgent email monitor
openpaw schedule add "every 30 minutes" --run "check for urgent emails and notify me if any" --model haiku --budget 0.25 --delivery notify