review-scheduler

Review Scheduler

Manage spaced repetition review reminders for the Obsidian vault.

Argument Parsing

Parse user input arguments (args) to determine which subcommand to run:

• No args or start → execute Start Flow
• stop → execute Stop Flow
• status → execute Status Check

---

Start Flow

Step 0: Platform Check

This skill requires macOS. Check the platform first:

uname -s

If the output is not Darwin, inform the user that this skill is macOS-only (requires launchd, Swift compiler, and osascript) and stop.

Step 0.5: Dependency Check

Before any action, run these checks:

which python3 && python3 --version
python3 -c "import yaml; print('PyYAML OK')"
which swiftc

If any dependency is missing, stop immediately and report to user:

• Python 3 missing: suggest brew install python3
• PyYAML missing: suggest pip3 install pyyaml
• swiftc missing: suggest xcode-select --install

Proceed only after all checks pass.

Step 1: Ask User for Scheduled Time

Use AskUserQuestion to ask:

"What time would you like to receive daily review reminders? (default 9:00, format: 08:30, 21:00)"

Parse user input into Hour and Minute. If user presses enter or says "default", use 9:00.

Step 2: Check Existing Deployment

launchctl list 2>/dev/null | grep com.obsidian-vault-kit.review

• If already running → inform user "Review scheduler is already active", ask if they want to update the scheduled time
• If user doesn't want to update → end
• If user wants to update → run Stop Flow first, then continue with deployment

Step 3: Deploy Files

1. Detect vault path: follow ../../_shared/common-steps.md "Vault Detection" section, store as $VAULT_ROOT

2. Detect vault name: take the directory name of $VAULT_ROOT

3. Create .review/ directory: mkdir -p $VAULT_ROOT/.review

4. Create reviews/ directory: mkdir -p $VAULT_ROOT/reviews

5. Deploy review_reminder.py:

   • Read references/review_reminder.py
   • Replace {{VAULT_PATH}} with the actual $VAULT_ROOT absolute path
   • Replace {{VAULT_NAME}} with the actual vault name
   • Write to $VAULT_ROOT/.review/review_reminder.py