@sesori/pr-monitor-pi

Pi and OMP extension that watches GitHub PRs, manages readiness, and reports into the active session

Packages

Package details

extensionskill

Install @sesori/pr-monitor-pi from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@sesori/pr-monitor-pi
Package
@sesori/pr-monitor-pi
Version
0.4.1
Published
Sep 5, 2026
Downloads
263/mo · 263/wk
Author
alexjeefo
License
MIT
Types
extension, skill
Size
154 KB
Dependencies
0 dependencies · 3 peers
Pi manifest JSON
{
  "extensions": [
    "./dist/index.js"
  ],
  "skills": [
    "./skills"
  ]
}

Security note

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

README

@sesori/pr-monitor-pi

Pi and Oh My Pi (OMP) extension that watches GitHub pull requests, manages ready-for-human-review state, and delivers [PR Monitor] reports into the active session.

Install

Pi 0.84.2 or newer:

pi install npm:@sesori/pr-monitor-pi

OMP 18.0.3 or newer:

omp plugin install @sesori/pr-monitor-pi

The package supplies the upstream entry to Pi and the OMP compatibility entry to OMP automatically. Requirements: Node.js 22.19 or newer for Pi (or the Bun runtime bundled with OMP), plus an installed and authenticated GitHub CLI (gh auth status).

Behavior

The extension registers pr_monitor actions for start, stop, flush, status, mark_ready, and unmark_ready. It reports commits, CI, reviews/comments, conflicts, and terminal state. It automatically adds readiness when the current head is clean and feedback is acknowledged, then withdraws it on later commits or relevant feedback. Every report states readiness, contains no comment bodies, and is delivered through the host's native custom message API with turn triggering enabled.

The package also supplies one monitor-pr skill. It teaches the agent to start a monitor immediately after opening a PR, handle every automatic report, use prefixed replies as acknowledgement evidence, and end the turn instead of making its own wait or polling loop.

Monitors are in memory and belong to the active agent session. Pi clears them when the current extension instance shuts down after a successful session replacement or reload. OMP clears them after its successful session-switch event. Canceled transitions leave the current monitor untouched. Neither host restores monitors after process restart.

Configuration

A trusted project uses repository .pr-monitor.json, then ${CONFIG_DIR_NAME}/pr-monitor.json (.pi in Pi and .omp in OMP), then .opencode/pr-monitor.json. Pi ignores all project-local monitor config until the project is trusted. Available settings:

  • debounceMinutes, maxCiWaitMinutes, and pollIntervalSeconds
  • ignoreCommentTag (mandatory agent-reply prefix; default <!-- pr-monitor:reply -->)
  • announceOnStart and flushOnCiFailure
  • readyLabel

See the repository README for action semantics, defaults, and development/release instructions. Durable behavior and artifact checks are in the repository's regression catalog: pull-request-monitoring.md and plugin-installation.md.

License

MIT