@pi-unipi/updater

Auto-updater, changelog browser, and readme browser for Unipi — checks npm registry, renders CHANGELOG.md and README.md files in TUI overlays

Package details

← Back
extensionskill

Install @pi-unipi/updater from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@pi-unipi/updater
Package
@pi-unipi/updater
Version
0.1.2
Published
May 1, 2026
Downloads
not available
Author
neuron-mr-white
License
MIT
Types
extension, skill
Size
67.3 KB
Dependencies
1 dependency · 2 peers
Pi manifest JSON
{
  "extensions": [
    "src/index.ts"
  ],
  "skills": [
    "skills"
  ]
}

Security note

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

README

@pi-unipi/updater

Checks npm for new versions on session start, shows a changelog diff, and lets you update with one keypress. Also provides TUI browsers for package READMEs and the changelog.

The update overlay appears automatically when a newer version is found. Press Y to update, n to skip. Skipped versions are cached — you only get re-prompted when an even newer version appears.

Commands

Command Description
/unipi:readme [package] Browse package README files in TUI overlay
/unipi:changelog Browse CHANGELOG.md with version list and detail view
/unipi:updater-settings Configure check interval and auto-update mode

TUI Controls

Key Action
j/k or Up/Down Navigate
Enter Select/open
q/Esc Back/close
g/G Jump to top/bottom
Space Cycle options (settings)
h/l or Left/Right Cycle options (settings)

Special Triggers

On session start, updater checks the npm registry for @pi-unipi/unipi. If a newer version exists and wasn't previously skipped, it shows the update overlay with changelog diff. This runs once per session, respecting the check interval config.

Updater registers with the info-screen dashboard, showing installed version, latest version, update status, and last check time.

How Updates Work

  1. Session start triggers npm registry check
  2. Compare latest version with installed version
  3. If newer and not skipped, show update overlay
  4. User views changelog diff, presses Y to update or n to skip
  5. Update runs pi install npm:@pi-unipi/unipi
  6. Skipped version cached — re-prompted only for newer versions

Configurables

Config stored at ~/.unipi/config/updater/config.json:

{
  "checkIntervalMs": 3600000,
  "autoUpdate": "notify"
}
Option Values Default
checkIntervalMs 1800000 (30min), 3600000 (1h), 21600000 (6h), 86400000 (1d) 3600000 (1h)
autoUpdate disabled, notify, auto notify

Auto-update Modes

  • disabled — No update checks on session start
  • notify — Show overlay with changelog, user chooses Y/n
  • auto — Show countdown, auto-install after 5 seconds unless cancelled

Cache

Last-check cache at ~/.unipi/cache/updater/last-check.json:

{
  "lastCheck": "2026-05-01T12:00:00.000Z",
  "latestVersion": "0.1.16",
  "skippedVersion": "0.1.16"
}

License

MIT