@guwidoe/pi-prompt-suggester

Intent-aware next-prompt suggestion extension for pi

Package details

← Back
extension

Install @guwidoe/pi-prompt-suggester from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@guwidoe/pi-prompt-suggester
Package
@guwidoe/pi-prompt-suggester
Version
0.3.8
Published
Apr 20, 2026
Downloads
1,397/mo · 151/wk
Author
guwidoe
License
MIT
Types
extension
Size
662.2 KB
Dependencies
0 dependencies · 3 peers
Pi manifest JSON
{
  "extensions": [
    "./dist/index.js"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

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

npm package

Global install:

pi install npm:@guwidoe/pi-prompt-suggester

Project-local install:

pi install -l npm:@guwidoe/pi-prompt-suggester

Pin a version if needed:

pi install npm:@guwidoe/pi-prompt-suggester@0.1.30

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
  • choose which ghost-editor key accepts a suggestion
  • 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
  • by default, press Space on an empty editor to accept the full suggestion
  • you can change the ghost accept key in /suggesterSettings or via suggestion.ghostAcceptKeys

Common commands

  • /suggesterSettings — main settings UI
  • /suggester or /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 also configure which key accepts ghost suggestions. Supported values are:

  • "space"
  • "right"
  • or both

You can edit them via:

  • /suggesterSettings

Or:

  • /suggester instruction set [project|user]
  • /suggester model ...
  • /suggester thinking ...
  • /suggester config set suggestion.maxSuggestionChars <number>
  • /suggester config set suggestion.ghostAcceptKeys ["space","right"]

Example:

{
  "suggestion": {
    "ghostAcceptKeys": ["space", "right"]
  }
}

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: