| name | configure-updater |
| description | Guide for using and configuring the Unipi updater — auto-update, changelog browser, and readme browser. |
Configure Updater
The @pi-unipi/updater package provides auto-update checking, a changelog browser, and a readme browser.
Commands
/unipi:readme [package]
Browse README.md files for all unipi packages.
- No argument — Opens a list of all packages with their versions. Select one to read its README.
- With argument (e.g.,
/unipi:readme workflow) — Opens that package's README directly.
/unipi:changelog
Browse the root CHANGELOG.md in a TUI overlay.
- Shows version list with dates and status labels (✓ Current, ↑ New)
- Select a version to view its changelog details (Added, Fixed, Changed sections)
- Follows Keep a Changelog format
/unipi:updater-settings
Configure the updater module.
Settings:
- Check Interval — How often to check npm for updates (30min / 1h / 6h / 1d)
- Auto Update — What happens when an update is found:
disabled — No update checks on session start
notify — Show update overlay, user chooses to update or skip
auto — Auto-install after 5-second countdown (press n to cancel)
Config File
Config stored at ~/.unipi/config/updater/config.json:
{
"checkIntervalMs": 3600000,
"autoUpdate": "notify"
}
Cache
Last-check cache at ~/.unipi/cache/updater/last-check.json:
- Tracks when the last npm check was performed
- Stores the latest version found
- Remembers skipped versions (user pressed
n to skip)
- Re-prompts only when a newer version than the skipped one appears
Navigation
All TUI overlays support:
j/k or ↑/↓ — Navigate
Enter — Select/open
q/Esc — Back/close
g/G — Jump to top/bottom
Space — Cycle options (settings)
h/l or ←/→ — Cycle options (settings)