Skip to content

README.md

Latest commit

 

History

History
54 lines (38 loc) · 1.77 KB

README.md

File metadata and controls

54 lines (38 loc) · 1.77 KB

loop extension

Runs a prompt or slash command on a recurring interval.

Adapted from the /loop skill in claude-code. The original relied on Claude Code's Kairos cron system; this version uses JS timers and pi.sendUserMessage() instead.

Usage

/loop [interval] <prompt>

Intervals use a number followed by a unit suffix: s (seconds), m (minutes), h (hours), d (days). If no interval is given, it defaults to 10m.

Subcommands

Command Description
/loop list Show all active loops with their IDs and fire counts
/loop stop Cancel all active loops
/loop stop <id> Cancel a specific loop by ID

Examples

/loop 5m /review
/loop 30m check the deploy
/loop 1h run the tests and report failures
/loop check the deploy            # defaults to 10m
/loop check the deploy every 20m  # trailing "every" clause
/loop list
/loop stop loop-1
/loop stop

Interval parsing

Arguments are parsed using this priority order:

  1. Leading token — if the first word matches \d+[smhd] it is the interval (e.g. 5m /review)
  2. Trailing "every" clause — if the input ends with every <N><unit>, that is the interval (e.g. check the deploy every 20m)
  3. Default — no interval found; uses 10m and the full input is the prompt

Behaviour

  • The prompt is executed immediately on the first invocation, then repeated at the given interval
  • If the agent is busy when a timer fires, the next prompt is queued as a follow-up rather than interrupting the current turn
  • Minimum interval is 10 seconds
  • Loops auto-expire after 7 days
  • All timers are cleaned up on session shutdown

Files

  • index.ts — extension entry point