@xynogen/pix-nudge
Pi extension — model-steering nudges (tools + capability)
Package details
Install @xynogen/pix-nudge from npm and Pi will load the resources declared by the package manifest.
$ pi install npm:@xynogen/pix-nudge- Package
@xynogen/pix-nudge- Version
0.1.2- Published
- Jun 18, 2026
- Downloads
- not available
- Author
- xynogen
- License
- MIT
- Types
- extension
- Size
- 30.3 KB
- Dependencies
- 0 dependencies · 1 peer
Pi manifest JSON
{
"extensions": [
"src/extension.ts"
]
}Security note
Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.
README
pix-nudge
Pi extension — model-steering nudges (tools + capability).
What it does
Registers two complementary nudge hooks. The tools nudge intercepts bash tool calls that merely reimplement a first-class tool (read, ls, grep, find, edit, write) and blocks the call once per command category per session, redirecting the model to use the proper tool instead. After the first nudge for a category, subsequent bash calls are allowed — no nag loop. The capability nudge injects an orientation block on the first prompt of each session (tool counts, MCP tools, available skills) and a short one-line reminder on every subsequent prompt, steering the model toward read_skills() and the /toolbox command for tool discovery rather than guessing. Both nudges are surgical: they name only the relevant tool, not a full inventory.
Install
pi install npm:@xynogen/pix-nudge
Also included in
@xynogen/pix-core:pi install npm:@xynogen/pix-core
Full distro
To install the complete pix suite (all packages + Pi itself):
curl -fsSL https://raw.githubusercontent.com/xynogen/pix-mono/main/scripts/install.sh | sh
License
MIT