@pi-unipi/updater

@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