ccron

Schedule claude -p execution on macOS with launchd.

Register scheduled claude -p tasks with a single command. Handles all the tricky launchd setup automatically.

Usage

Run directly with bunx:

bunx @mrsekut/ccron <command> [options]

Claude Code Skill

Install the ccron skill so Claude Code can register tasks from natural language:

bunx skills add mrsekut/ccron

Then tell Claude: "Schedule a daily summary to Slack at 5pm on weekdays" and it will handle the rest.

Quick Start

# Register a task
ccron add \
  --name daily-summary \
  --schedule "15 17 * * 1-5" \
  --prompt "日次サマリーを作成して #daily-summary チャンネルに投稿して" \
  --mcp-config ~/mcp.json

# Verify setup
ccron test daily-summary

# List all tasks
ccron list

Commands

| Command | Description | | --------------------- | ---------------------------------- | | ccron add | Register a new scheduled task | | ccron list | List tasks with launchd status | | ccron show <name> | Show detailed task info | | ccron run <name> | Manually trigger and tail log | | ccron test <name> | Run environment checks | | ccron log <name> | Show logs (--follow for tail) | | ccron edit <name> | Edit config, regenerate and reload | | ccron auth <name> | Re-authenticate MCP servers | | ccron remove <name> | Remove task and logs |

Schedule Format

Standard cron expression: "minute hour * * day-of-week"

15 17 * * *     Every day at 17:15
15 17 * * 1-5   Weekdays at 17:15
0 22 * * 5      Every Friday at 22:00
0 9 * * 1,3,5   Mon/Wed/Fri at 9:00

Step values (*/5) and minute/hour ranges are not supported (launchd limitation).

MCP

Pass your own MCP config JSON file via --mcp-config:

ccron add --name my-task --schedule "0 9 * * *" --prompt "hello" --mcp-config ~/mcp.json