$ show jshchnz/claude-code-scheduler
This is a Claude Code plugin that enables scheduling recurring and one-time tasks using native OS schedulers (launchd on macOS, crontab on Linux, Task Scheduler on Windows). Users describe tasks in natural language (e.g., 'every weekday at 9am review yesterday's code'), and the plugin converts that to cron expressions, registers the task with the OS scheduler, and executes `claude -p "prompt"` at the scheduled time. It supports autonomous execution with `--dangerously-skip-permissions`, git worktree isolation for tasks that modify code (creates a branch, runs Claude, commits and pushes changes), and provides commands to list, remove, run, and view logs of scheduled tasks. The architecture is modular: platform-specific scheduler implementations inherit from a base class, cron parsing and humanization are separate utilities, and execution history is stored as JSONL files. The codebase demonstrates strong security awareness with shell escaping, input validation via Zod schemas, and careful handling of user-provided values in generated shell scripts.
The LLM identified 4 files worth highlighting for reuse:
Provides `shellEscape()` and `sanitizeForComment()` functions for safe embedding of user-provided strings in bash commands. Uses single-quote wrapping with proper escaping of internal single quotes to prevent all shell expansion (backticks, $(), semicolons, etc.). Also provides regex patterns for validating git refs, remote names, and file paths. This is a self-contained, security-critical utility that can be extracted and reused in any project that generates shell commands.
Converts natural language scheduling phrases (e.g., 'every weekday at 9am', 'daily at 6pm', 'every 15 minutes') into cron expressions. Uses regex-based pattern matching with AM/PM handling, day-of-week mapping, and step value support. Also provides `validateCron()`, `getNextRuns()`, and a set of `CRON_PRESETS`. This module is self-contained (only depends on `croner`) and can be reused in any scheduling application that needs natural language input.
Implements git worktree creation, commit/push, and removal with retry logic. Functions like `createWorktree()`, `commitAndPush()`, and `removeWorktree()` are self-contained and use `execa` to run git commands. The `commitAndPush()` function tracks whether changes were actually made before committing, avoiding empty commits. The retry logic in `removeWorktree()` handles file lock race conditions. This module can be extracted as a standalone git worktree utility for any project needing isolated branch-based execution.
Abstract base class for platform schedulers containing two notable methods: `getExecutionCommand()` which safely constructs the `claude -p 'prompt'` command using shell escaping, and `generateWorktreeScript()` which generates a complete bash script for git worktree-based task execution. The script handles worktree creation, Claude execution, commit, push, and cleanup with proper error handling and security escaping of all user-provided values. This pattern of generating self-contained execution scripts is reusable for any system that needs isolated, auditable task execution.