@monopi/extension-scheduler

Monopi scheduler pi extension.

Packages

Package details

extension

Install @monopi/extension-scheduler from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:@monopi/extension-scheduler
Package
@monopi/extension-scheduler
Version
0.6.1
Published
Aug 28, 2026
Downloads
271/mo · 27/wk
Author
ifiokjr
License
MIT
Types
extension
Size
111.3 KB
Dependencies
3 dependencies · 5 peers
Pi manifest JSON
{
  "extensions": [
    "./index.ts"
  ]
}

Security note

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

README

@monopi/extension-scheduler

The scheduler extension adds recurring checks, one-time reminders, and the LLM-callable schedule_prompt tool so pi can schedule future follow-ups like PR, CI, build, or deployment checks. Tasks run only while pi is active and idle, and scheduler state is persisted in shared pi storage using a workspace-mirrored path.

Install

pi install npm:@monopi/extension-scheduler

Scheduler commands:

  • /remind in 45m <prompt>: one-time reminder
  • /loop 5m <prompt>: recurring check on an interval
  • /loop cron '*/5 * * * *' <prompt>: recurring check on a cron schedule
  • /schedule: show upcoming tasks
  • /schedule tui: open the interactive schedule manager
  • /schedule list: list all tasks
  • /schedule enable <id> and /schedule disable <id>: enable or disable a task
  • /schedule delete <id>: delete a task
  • /schedule clear: clear all tasks
  • /schedule clear-other: clear tasks created by other instances
  • /schedule adopt <id|all>: take ownership of tasks from another instance
  • /schedule release <id|all>: release ownership of tasks

The schedule_prompt tool lets the agent schedule follow-ups itself, including continueUntilComplete retries until a success marker appears.

Ownership

The scheduler distinguishes between instance-scoped tasks and workspace-scoped tasks. Instance scope is the default for /loop, /remind, and schedule_prompt, which means tasks stay owned by one pi instance and other instances restore them for review instead of auto-running them. Workspace scope is an explicit opt-in for shared CI/build/deploy monitors that should survive instance changes in the same repository.

Attribution

This implementation is adapted from pi-scheduler by @manojlds (MIT). The scheduler API surface in this package is built on pi's schedule_prompt tooling.