@guwidoe/pi-prompt-suggester
v0.3.1
Published
Intent-aware next-prompt suggestion extension for pi
Readme
pi-prompt-suggester
pi-prompt-suggester suggests the user's likely next prompt after each assistant completion.
It uses recent conversation context plus a lightweight project intent seed so suggestions stay aligned with what the user has been doing in the current repo.
Highlights
- next-prompt suggestions as ghost text in the editor
- repo-aware suggestions grounded in project intent
- persistent custom instruction you can edit in the TUI
- project- or user-scoped behavior overrides
Install
Global install:
pi install npm:@guwidoe/pi-prompt-suggesterProject-local install:
pi install -l npm:@guwidoe/pi-prompt-suggesterPin a version if needed:
pi install npm:@guwidoe/[email protected]After install, restart pi or run /reload.
Manual settings.json entry
Add to packages in ~/.pi/agent/settings.json or .pi/settings.json:
{
"packages": [
"npm:@guwidoe/pi-prompt-suggester"
]
}Usage
Main entrypoint
Use:
/suggesterSettings
This is the main UI for normal users. It lets you:
- edit the custom instruction
- choose custom suggester/seeder models
- choose custom suggester/seeder thinking levels
- customize the maximum suggested-prompt length
- tune common behavior settings
- reset overrides
Everyday behavior
- after an assistant completion, the extension may suggest the next user prompt
- when the editor is empty and the suggestion is compatible, it appears as ghost text
- press
Spaceon an empty editor to accept the full suggestion
Common commands
/suggesterSettings— main settings UI/suggesteror/suggester status— inspect current status/suggester reseed— refresh project intent in the background
Advanced commands
Most users do not need these, but they are available:
/suggester instruction .../suggester model .../suggester thinking .../suggester config .../suggester seed-trace ...
Configuration
The most useful settings are the custom instruction, custom suggester/seeder models, custom suggester/seeder thinking levels, and the maximum suggested-prompt length.
You can edit them via:
/suggesterSettings
Or:
/suggester instruction set [project|user]/suggester model .../suggester thinking .../suggester config set suggestion.maxSuggestionChars <number>
Overrides can be stored at:
- user:
~/.pi/suggester/config.json - project:
.pi/suggester/config.json
If you want the full config surface, see:
Docs
For implementation details, architecture, and maintainer-oriented notes, see:
