pi-scheduled-tasks

A pi extension for scheduled prompts, recurring checks, and prompt-executable slash commands

Package details

← Back
extension

Install pi-scheduled-tasks from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:pi-scheduled-tasks
Package
pi-scheduled-tasks
Version
0.0.3
Published
Apr 11, 2026
Downloads
296/mo · 4/wk
Author
errfld
License
MIT
Types
extension
Size
48.2 KB
Dependencies
3 dependencies · 3 peers
Pi manifest JSON
{
  "extensions": [
    "./extensions/scheduler/index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pi-scheduled-tasks

CI Release npm version

A pi package that adds scheduled prompts and prompt-executable slash commands to pi.

It lets pi run reminders, recurring checks, cron-style tasks, and loop-style prompts without needing a polling loop.

Install

From npm

pi install npm:pi-scheduled-tasks

Project-local install:

pi install -l npm:pi-scheduled-tasks

From GitHub

pi install git:github.com/errfld/pi-scheduled-tasks

Quick examples

/loop every 15m check CI failures and summarize changes
/schedule once "tomorrow at 9am" remind me to review open PRs
/schedule cron "0 9 * * 1-5" /daily-standup

What it adds

Commands

/loop 5m check deployment
/loop every 2 hours check CI
/loop check deployment
/loop

/schedule list
/schedule delete <id>
/schedule every 30m check CI
/schedule once "in 45 minutes" check tests
/schedule cron "*/15 * * * *" check status

Model-callable tools

  • scheduled_task_create
  • scheduled_task_list
  • scheduled_task_delete

Features

  • one-shot scheduling with natural language time input
  • interval scheduling like 5m or every 2 hours
  • cron scheduling with standard 5-field expressions
  • loop-style recurring prompts with default prompt resolution
  • queued execution while pi is busy
  • session snapshot persistence and restore
  • custom scheduler status and message rendering

Default /loop prompt resolution

When /loop is used without an explicit prompt, the extension resolves the default prompt in this order:

  1. .pi/loop.md
  2. ~/.pi/agent/loop.md
  3. .claude/loop.md
  4. ~/.claude/loop.md
  5. built-in default prompt

Development

npm install
npm run ci

Useful commands:

npm test
npm run test:watch
npm run check
npm run pack:check

Release

  • push to main to run CI
  • push a tag like v0.0.3 to run the release workflow
  • tagged releases publish to npm using the repository NPM_TOKEN secret
  • published versions are installable with pi install npm:pi-scheduled-tasks

Changelog

See CHANGELOG.md.

License

MIT