summaryrefslogtreecommitdiff
path: root/pi/agent/extensions/loop-scheduler/README.md
diff options
context:
space:
mode:
authorPaul Buetow <paul@buetow.org>2026-03-22 21:28:48 +0200
committerPaul Buetow <paul@buetow.org>2026-03-22 21:28:48 +0200
commit5e817371a43ba468e5f216230d504b6124c85e95 (patch)
tree1062a05bb733ef5c04405a619deb52b72c6084a6 /pi/agent/extensions/loop-scheduler/README.md
parentfc8a5aefff7c8421c579df1ba8391fdde411d731 (diff)
fix
Diffstat (limited to 'pi/agent/extensions/loop-scheduler/README.md')
-rw-r--r--pi/agent/extensions/loop-scheduler/README.md124
1 files changed, 0 insertions, 124 deletions
diff --git a/pi/agent/extensions/loop-scheduler/README.md b/pi/agent/extensions/loop-scheduler/README.md
deleted file mode 100644
index 78a6635..0000000
--- a/pi/agent/extensions/loop-scheduler/README.md
+++ /dev/null
@@ -1,124 +0,0 @@
-# Loop Scheduler
-
-Session-scoped recurring prompts for Pi.
-
-This extension adds a Claude-Code-style `/loop` command for interactive Pi
-sessions. It schedules a prompt to be re-sent on an interval while the current
-Pi process stays open.
-
-## Commands
-
-- `/loop 10m <prompt>`
- Run a prompt every 10 minutes.
-- `/loop <prompt>`
- Run a prompt every 10 minutes using the default interval.
-- `/loop <prompt> every 2h`
- Alternative trailing interval form.
-- `/loop list`
- Show the active loop jobs.
-- `/loop cancel <id>`
- Cancel one loop job.
-- `/loop cancel all`
- Cancel all loop jobs.
-
-Supported units:
-
-- `s`
-- `m`
-- `h`
-- `d`
-
-Examples:
-
-- `5s`
-- `10m`
-- `2h`
-- `1d`
-- `every 2 hours`
-- `hourly`
-- `daily`
-
-## Usage Flows
-
-### Flow 1: Poll something on an interval
-
-Start Pi in the repo, then run:
-
-```text
-/loop 10m check whether the deployment finished and summarize what changed
-```
-
-Pi will keep re-injecting that prompt every 10 minutes while the session stays
-open.
-
-### Flow 2: Loop another command
-
-The scheduled prompt can itself be a slash command or workflow:
-
-```text
-/loop 20m /work-on-tasks highest-impact 1
-```
-
-or:
-
-```text
-/loop 30m /subagent Review the current working tree for concrete regressions only
-```
-
-### Flow 3: Check what is scheduled
-
-```text
-/loop list
-```
-
-This prints the current loop IDs, cadence, next due time, and prompt preview.
-
-### Flow 4: Cancel a loop
-
-Cancel one loop:
-
-```text
-/loop cancel ab12cd34
-```
-
-Cancel everything:
-
-```text
-/loop cancel all
-```
-
-## Busy-Agent Behavior
-
-Loop jobs do not spam turns while Pi is busy.
-
-- if a job becomes due while the agent is running, it is marked pending
-- when the current work finishes, the next pending loop fires once
-- missed intervals do not stack into a catch-up storm
-
-## Session Model
-
-This extension is session-scoped, not durable scheduling.
-
-- loop jobs live only in the current Pi process
-- closing Pi ends all loop jobs
-- `/reload` or a restart drops the active schedules
-- this is for active coding sessions, not unattended automation
-
-## Good Uses
-
-- poll build or deployment status
-- re-run a review command every N minutes
-- check Taskwarrior progress during a work session
-- periodically ask for a summary while you are coding
-
-## Bad Uses
-
-- long-term unattended automation
-- guaranteed exact-time scheduling
-- anything that must survive terminal exit or Pi restart
-
-## Notes
-
-- `/loop` is intended for interactive or RPC sessions that remain open.
-- It is not useful in one-shot `pi -p` mode because the process exits before
- later runs can fire.