This project automates Claude Code tasks, such as code reviews and security audits, using natural language scheduling. It targets developers and power users seeking to automate repetitive coding workflows, even when offline, by leveraging operating system-native schedulers for reliable execution.

How It Works

Users define tasks using natural language prompts, which the Claude Code plugin interprets and registers with the host OS's native scheduler (launchd on macOS, crontab on Linux, Task Scheduler on Windows). At the scheduled time, the system executes the task via the claude -p "command" CLI. For tasks requiring file modifications or command execution, an "autonomous mode" is available, which uses the --dangerously-skip-permissions flag. Additionally, a Git worktree mode isolates changes to a dedicated branch, automatically committing and pushing them for review, thus keeping the main development branch clean.

Quick Start & Requirements

• Primary install / run command: Install via Claude Code plugin marketplace: /plugin marketplace add jshchnz/claude-code-scheduler or /plugin install scheduler@claude-code-scheduler.
• Non-default prerequisites and dependencies: Requires Claude Code v1.0.33+.
• Compatibility: Works on macOS, Linux, and Windows.
• Links: No external quick-start or documentation links are provided beyond the plugin commands.

Highlighted Details

• Tasks are defined using natural language, simplifying scheduling.
• Supports both one-time and recurring task automation.
• Autonomous execution mode allows tasks to edit files, run commands, and make commits.
• Git worktree isolation creates new branches for changes, pushing them for review and maintaining a clean main branch.
• Leverages native OS schedulers for robust, cross-platform task execution.

Maintenance & Community

The project welcomes issues and pull requests. No specific community channels (e.g., Discord, Slack), roadmap, or notable contributors/sponsorships are detailed in the README.

Licensing & Compatibility

The project is licensed under the MIT License. No specific restrictions for commercial use or closed-source linking are mentioned.

Limitations & Caveats

Requires a specific minimum version of Claude Code (v1.0.33+). The autonomous execution mode bypasses standard permission prompts, necessitating careful configuration and trust in scheduled tasks. Troubleshooting may involve ensuring the claude CLI is in the system's PATH and using absolute paths for directories.