femto/acp-loop
skills/acp-loop/SKILL.md
Schedule recurring AI agent prompts using intervals or cron expressions. Use when users need to run prompts periodically, automate agent tasks on a schedule, or set up recurring workflows. Triggers on "schedule prompt", "run every", "cron", "recurring", "periodic", "interval", "loop prompt".
data-ai
Updated Apr 4, 2026
$ install --global
skillsauthnpx skillsauth add femto/skills acp-loopInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 24, 2026, 7:51 AM3.3s1 file scanned
SKILL.md
- name:
- acp-loop
- description:
- Schedule recurring AI agent prompts using intervals or cron expressions. Use when users need to run prompts periodically, automate agent tasks on a schedule, or set up recurring workflows. Triggers on "schedule prompt", "run every", "cron", "recurring", "periodic", "interval", "loop prompt".
acp-loop: Recurring Prompt Scheduler
Schedule AI agent prompts to run at intervals or cron schedules.
When to Use This Skill
Use this skill when the user:
- Wants to run a prompt repeatedly at fixed intervals
- Needs cron-style scheduling for agent tasks
- Wants to automate recurring AI workflows
- Asks about scheduling, looping, or periodic execution of prompts
Installation
npm install -g acp-loop
Quick Start
Interval Mode
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"
Cron Mode
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"
Options Reference
| 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 |
Common Patterns
Conditional Stop
# Run until task reports completion
acp-loop --interval 1m --until "All tests passed" "run test suite"
Limited Runs
# Run exactly 5 times
acp-loop --interval 10s --max 5 "check deployment status"
Time-Boxed Execution
# Run for max 1 hour
acp-loop --interval 5m --timeout 1h "monitor build"
Daily Scheduled Task
# Every day at midnight
acp-loop --cron "0 0 * * *" "generate daily report"
Using Different Agents
# 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"
Important Notes
- Mutually exclusive: Use either
--intervalOR--cron, not both - Cron library: Uses
croner(handles laptop sleep/wake better than node-cron) - Stop: Press Ctrl+C to stop the loop
- Agent support: Works with any ACP-compatible agent (codex, claude, gemini-cli)
Why acp-loop?
- Claude Code's built-in
/loopcommand has bugs - Works with any ACP-compatible agent, not just Claude
- Proper cron expression support
- Better handling of laptop sleep/wake cycles
Resources
- GitHub: https://github.com/femto/acp-loop
- npm: https://www.npmjs.com/package/acp-loop
Related Skills
femto/worldbook-webmcp
tools
VerifiedTrustedCommunity
Discover and use Worldbook WebMCP browser-page tools from a current page URL. Use when an agent needs site-specific browser automation tools without relying on mcp-chrome.
SKILL.mdUpdated May 12, 2026
femto/worldbook
tools
VerifiedTrustedCommunity
AI's Knowledge Base CLI - Query and manage world knowledge for AI agents. Use when users want to search knowledge, add knowledge sources, or interact with the worldbook knowledge base. This is a CLI-first approach that treats AI agents as first-class citizens.
SKILL.mdUpdated Apr 4, 2026
femto/new-tag
tools
VerifiedTrustedCommunity
Bump version in package.json and push a new tag to both minion-mind and minion-mind-releases repos. Use when the user says "new tag", "bump version", "release new version", or wants to create a new release tag.
SKILL.mdUpdated Apr 4, 2026
femto/browser-automation
tools
VerifiedTrustedCommunity
Control Chrome browser with AI using MCP protocol. Use when users want to automate browser tasks, take screenshots, fill forms, click elements, navigate pages, search browsing history, manage bookmarks, or perform any browser-based automation. Works with your existing Chrome browser and login sessions.
SKILL.mdUpdated Apr 4, 2026