pi-umbra-help
Two commands over the pi-umbra family: /umb-help lists what is installed and how to configure it, /umb-doctor reports the faults that would otherwise stay silent.
Package details
Install pi-umbra-help from npm and Pi will load the resources declared by the package manifest.
$ pi install npm:pi-umbra-help- Package
pi-umbra-help- Version
0.1.6- Published
- Oct 4, 2026
- Downloads
- 729/mo · 26/wk
- Author
- grknbyk
- License
- MIT
- Types
- extension
- Size
- 22.3 KB
- Dependencies
- 0 dependencies · 1 peer
Pi manifest JSON
{
"extensions": [
"./extensions"
]
}Security note
Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.
README
pi-umbra-help
/umb-help shows what pi-umbra has installed, and /umb-doctor shows what is broken.
pi install npm:pi-umbra-help/umb-help
- Every
/umb-*command loaded in this session, with its description. - The active theme.
- Your
piUmbraThemeblock from~/.pi/agent/settings.json, as written.
It reads the live session, so it lists only the umbra packages you have.
/umb-doctor
Reports the faults that give no error of their own:
| Check | Why |
|---|---|
| a bundle patch is missing | after a pi update, the shimmer and /umb-loop stop without a word |
| two skills share a name | ~/.pi/agent/skills, <project>/.pi/skills and ~/.agents/skills are read in that order and the first copy wins, even when a later one is newer |
| the terminal kept its own background | the theme is not shown in full; it says where to set the colour in your terminal |
| no truecolor announced | COLORTERM is not set and the terminal is not a known truecolor one, so colours may band |
| the theme is not an umbra one | only a note; everything still works |
A patch is reported only when the package that needs it is installed. The fix it suggests is
to run that package's patch.mjs and restart pi. With nothing to report, it says
umb-doctor: nothing to report.
The patch check looks in the pi that is running. Set PI_UMBRA_PI to point it at another
one.
MIT.