Suggestions

Suggested next steps in Pi's terminal editor, phrased as requests you can send. Suggestions appear as dim text after a completed response, only while the editor is empty. They are drafts, not automatic follow-up requests.

Install

pi install npm:@howaboua/pi-suggestions

Requires Pi 1.5 or later. Included in pi-extensions and pi-stuff.

Set up

Open /suggestions, choose a model and switch suggestions on. They start off, with no model selected. The menu also offers supported reasoning levels, model search and an off switch. These settings are global; they do not change the main chat model.

Suggestions use the selected model's quota and may incur API charges. They send that provider bounded excerpts of user messages and completed assistant responses, including a compaction summary when available. Tool results, images and the main chat's hidden reasoning are excluded.

Use chat model as fallback is off by default. Switch it on in /suggestions to use the current chat model when the chosen suggestion model is unavailable or its request fails. This can cost more and take longer. A warning identifies the fallback model when it starts being used. No other model is chosen if the current chat model is missing or unavailable, and cancelled requests are not retried. The selected reasoning level is reused when supported, otherwise fallback uses the lowest supported level, including off where available.

Predictions keep a separate, in-memory conversation without tools. Later requests append new conversation turns and reuse its cache where the provider supports it. Cache hits are not guaranteed and cached tokens can still be billed. This private history never enters your chat and is discarded on a new Notes context window, Pi compaction, session navigation, model changes, switching suggestions off or shutdown. A successful switch between the chosen suggestion model and the fallback starts a fresh private conversation. Failed attempts at the chosen model do not discard a continuing fallback conversation.

Suggestions run only in interactive terminal sessions. Shepherdr-launched workers and Pi's RPC and print modes do not request them. Update Shepherdr alongside Suggestions to identify workers reliably.

Use

• Right arrow accepts the visible suggestion into the editor. Fill any placeholders, edit normally and press Enter to send.
• Tab keeps Pi's normal behaviour.
• Escape dismisses it. Typing replaces it with your own input.
• Enter alone never submits a suggestion.

Input, navigation, new responses and blocking dialogs cancel pending suggestions. Long suggestions are visually shortened to fit the editor; accepting inserts the complete draft.

Suggestions require the standard empty editor layout. Custom editors with a different layout remain usable but may not display suggestions. Settings are stored in suggestions/config.json under Pi's agent directory.

Customise suggestions

Open /suggestions and choose Instructions to edit the Markdown guidance. You can also edit suggestions/instructions.md under Pi's agent directory directly. Changes apply to the next prediction and reset its private history. They do not change the main chat's prompt.

The file starts with short defaults: suggest productive next actions, avoid repeating either participant or re-suggesting work, and skip routine requests for hashes, summaries or more verification unless they unblock progress. Add, replace or remove these instructions to suit your workflow. An empty file leaves only the built-in request-format instructions. Deleting the file restores the defaults on the next prediction or when you open Instructions.