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

0•

Productivity & Workflow

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

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

01Comprehensive logging system with run history, structured JSONL logs, and log following.

02Persistent task-specific and shared notes system for maintaining state and context between executions.

03Built-in Todoist integration for automated task notifications and urgent alerts.

04Flexible scheduling for recurring tasks (intervals from 5m to 7d) or specific one-time executions.

050 GitHub stars

06Cross-platform background execution using native launchd (macOS) and cron (Linux) runners.

Use Cases

01Scheduled codebase maintenance such as cleaning up merged branches or auditing dependencies.

02Setting one-time future reminders for deployments or task follow-ups with automated context retrieval.

03Automated repository monitoring to summarize new GitHub issues and alert developers via Todoist.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add mshuffett/dotfiles claude-schedule

For use in Claude.ai and ChatGPT

Download Skill