How does Claude Schedule run tasks in the background?

It installs a native background runner—launchd on macOS or a crontab entry on Linux—that checks for and executes due tasks every 60 seconds.

What happens if my computer is asleep when a task is scheduled?

Claude Schedule uses task coalescing; when your computer wakes up, any missed tasks will run exactly once to catch up, preventing a backlog of duplicate runs.

Does this skill require an internet connection to run?

Yes, as it triggers Claude Code to perform the tasks, an active internet connection is required at the time the task is executed to communicate with the AI model.

Can I schedule a task for a specific date and time?

Yes, you can use the 'add' command with the '--once' and '--at' flags to schedule a one-time execution for a specific timestamp.

How can I see the output of my scheduled tasks?

You can use 'claude-schedule logs ' to view the latest output, or 'claude-schedule history ' to see a table of all previous runs and their statuses.

Claude Schedule

Name: Claude Schedule
Author: mshuffett

bymshuffett

Productivity & Workflow

Automates Claude Code tasks with recurring and one-time scheduling via native system runners like cron and launchd.

About

Claude Schedule enables developers to run Claude Code autonomously in the background by leveraging native system schedulers. It allows for the creation of recurring maintenance tasks, automated repository monitoring, and one-time reminders with robust logging and persistent note-taking capabilities. By integrating with Todoist for notifications and providing a structured directory for task history, it transforms Claude from a reactive assistant into a proactive background agent capable of handling repository management and complex workflow automation without manual intervention.

Key Features

Comprehensive logging system with run history, structured JSONL logs, and log following.
Persistent task-specific and shared notes system for maintaining state and context between executions.
Built-in Todoist integration for automated task notifications and urgent alerts.
Flexible scheduling for recurring tasks (intervals from 5m to 7d) or specific one-time executions.
0 GitHub stars
Cross-platform background execution using native launchd (macOS) and cron (Linux) runners.

Use Cases

Scheduled codebase maintenance such as cleaning up merged branches or auditing dependencies.
Setting one-time future reminders for deployments or task follow-ups with automated context retrieval.
Automated repository monitoring to summarize new GitHub issues and alert developers via Todoist.

About

Key Features

Comprehensive logging system with run history, structured JSONL logs, and log following.
Persistent task-specific and shared notes system for maintaining state and context between executions.
Built-in Todoist integration for automated task notifications and urgent alerts.
Flexible scheduling for recurring tasks (intervals from 5m to 7d) or specific one-time executions.
0 GitHub stars
Cross-platform background execution using native launchd (macOS) and cron (Linux) runners.

Use Cases

Scheduled codebase maintenance such as cleaning up merged branches or auditing dependencies.
Setting one-time future reminders for deployments or task follow-ups with automated context retrieval.
Automated repository monitoring to summarize new GitHub issues and alert developers via Todoist.