heartbeat

Manage scheduled background tasks on macOS using launchd and Python scripts.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/AndersonsRepo/AI-Harness --skill heartbeat-andersonsrepo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: heartbeat
Source: https://github.com/AndersonsRepo/AI-Harness/tree/main/.claude/skills/heartbeat
Command: npx skills add https://github.com/AndersonsRepo/AI-Harness --skill heartbeat-andersonsrepo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the creation, management, and execution of recurring background tasks on macOS, ensuring that essential processes run reliably without manual intervention.

Core Features & Use Cases

  • Scheduled Task Creation: Define and schedule tasks using interval-based or cron expressions.
  • Task Management: Easily list, pause, resume, and delete scheduled tasks.
  • Use Case: Set up a daily digest task that summarizes your AI's learnings and sends a report to Discord every morning at 8 AM.

Quick Start

Create a new scheduled task named 'daily-report' that runs every 24 hours with the prompt 'Generate a daily summary of key AI activities'.

Frequently Asked Questions about heartbeat

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I schedule recurring background tasks on macOS using launchd?

macOS launchd supports both interval-based and cron-based scheduling for recurring background tasks. This Skill automates the creation, execution, and management of these scheduled workflows using Python scripts.

Can I pause and resume scheduled launchd jobs without losing my configuration?

Yes, you can pause and resume scheduled launchd jobs while preserving your configurations. The Skill manages task states directly, allowing you to suspend automated workflows and reactivate them on demand.

How do I set up a cron job on macOS to run a Python script daily?

To set up a daily cron job on macOS, create a scheduled task using a cron expression and specify your Python script as the action. This Skill handles the underlying launchd integration and execution logging automatically.

How do I list and delete existing background tasks managed by launchd?

You can list and delete existing background tasks managed by launchd through the Skill's task management interface. It provides functionality to view all scheduled jobs and permanently remove unneeded tasks.

Does this launchd automation Skill work on Linux or Windows?

No, this launchd automation Skill does not work on Linux or Windows because it relies on the macOS launchd system. It is specifically designed to manage scheduled background tasks within the macOS ecosystem.