Schedule recurring AI agent prompts using intervals or cron expressions. Use when users need to run prompts periodically, automate agent tasks on a schedule,...
Schedule AI agent prompts to run at intervals or cron schedules.
Use this skill when the user:
npm install -g acp-loop
Run prompts at fixed intervals:
# Every 5 minutes
acp-loop --interval 5m "check logs for errors"
# Every 30 seconds, stop after 10 iterations
acp-loop --interval 30s --max 10 "quick health check"
# Every hour, timeout after 8 hours
acp-loop --interval 1h --timeout 8h "hourly report"
Run prompts on cron schedules:
# Daily at 3am
acp-loop --cron "0 3 * * *" "nightly cleanup"
# Every Monday at 9am
acp-loop --cron "0 9 * * 1" "weekly standup summary"
# Every 5 minutes (cron style)
acp-loop --cron "*/5 * * * *" "monitor status"
| Option | Description | Example |
|---|---|---|
--interval <duration> | Fixed interval (30s, 5m, 1h) | --interval 5m |
--cron <expression> | Cron expression | --cron "0 9 * * *" |
--agent <name> | Agent to use (default: codex) | --agent claude |
--max <n> | Max iterations | --max 10 |
--timeout <duration> | Max total runtime | --timeout 2h |
--until <string> | Stop when output contains | --until "DONE" |
--quiet | Minimal output | --quiet |
# Run until task reports completion
acp-loop --interval 1m --until "All tests passed" "run test suite"
# Run exactly 5 times
acp-loop --interval 10s --max 5 "check deployment status"
# Run for max 1 hour
acp-loop --interval 5m --timeout 1h "monitor build"
# Every day at midnight
acp-loop --cron "0 0 * * *" "generate daily report"
# Use Claude instead of Codex
acp-loop --interval 10m --agent claude "review code changes"
# Use Gemini CLI
acp-loop --interval 5m --agent gemini-cli "check status"
--interval OR --cron, not bothcroner (handles laptop sleep/wake better than node-cron)/loop command has bugsZIP package — ready to use