@xynogen/pix-nudge
v0.1.9
Published
Pi extension — model-steering nudges (tools + capability)
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) and emits a YELLOW warning notification ONCE per command category per session, redirecting the model to use the proper tool instead. The command still runs — the nudge teaches for next time, it does not block (early blocking wasted a turn via forced retry). After the first nudge for a category, subsequent bash calls in that category are silent. Bash stays available for everything else (pipes, compound commands, real shell work).
The capability nudge injects a one-time orientation block on the FIRST prompt of each session (tool counts, MCP tools, available skills) and a short one-line reminder every 10 turns, 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-nudgeAlso included in
@xynogen/pix-core:pi install npm:@xynogen/pix-core
Full distro
Source: github.com/xynogen/pix-mono
To install the complete pix suite (all packages + Pi itself):
curl -fsSL https://raw.githubusercontent.com/xynogen/pix-mono/main/scripts/install.sh | shLicense
MIT
