@vanillagreen/pi-questions

Pi extension for structured multi-tab inline questions and bridge-driven replies.

Packages

Package details

extension

Install @vanillagreen/pi-questions from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@vanillagreen/pi-questions
Package
@vanillagreen/pi-questions
Version
2.1.0
Published
Oct 3, 2026
Downloads
912/mo · 275/wk
Author
vanillagreencom
License
MIT
Types
extension
Size
208.9 KB
Dependencies
0 dependencies · 2 peers
Pi manifest JSON
{
  "image": "https://raw.githubusercontent.com/vanillagreencom/kendex/main/pi-extensions/pi-questions/assets/questions-workflow.gif",
  "extensions": [
    "./extensions/questions.ts"
  ],
  "appendSystem": "./instructions.md"
}

Security note

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

README

@vanillagreen/pi-questions

A Pi extension for questions with selectable answers and free text. The agent receives your choices as the result of its question tool call.

Install

  • npm: pi install npm:@vanillagreen/pi-questions.
  • kendex: add the declaration below to the project's kendex.toml, or to ~/.config/kendex/kendex.toml for user scope. Run kendex update-pi.
[pi-extensions."@vanillagreen/pi-questions"]
source = "kendex"

Restart Pi after installation. Use kendex update-pi --check to preview the installation.

Features

  • Ask several questions in one questionnaire.
  • Support single selections, multiple selections and typed answers.
  • Show questions in the editor or a floating popup.
  • Optionally accept answers through pi-session-bridge.

How it works

The agent sends questions and choices to the question tool. The extension displays them in Pi's editor area or the host's available dialogs. You select or type answers and submit them. The tool returns the answers to the agent. A connected session bridge can also complete a pending questionnaire. Interrupting the agent cancels its open question and closes the questionnaire or Pi's own dialog. On an RPC host, the client's dialog closes only if the client honours the request's timeout or tracks the interrupt itself.

Memory use

Each question result keeps one rendered layout of at most 65,536 characters. Resizing or theme invalidation replaces it. The result component owns the cache, so disposing the session UI releases it.

Settings

The settings editor writes project values to .pi/settings.json. The default user file is ~/.pi/agent/settings.json. PI_CODING_AGENT_DIR changes the user directory. Package values are stored under kendex.extensionManager.config["@vanillagreen/pi-questions"].

Open /extensions:settings; settings appear under the Questions tab. Project settings in .pi/settings.json apply only after Pi marks the workspace trusted.

  • enabled: package toggle.
  • renderMode, popupWidth, popupMaxHeight, optionRows, defaultHeader, glyphStyle: where and how the questionnaire renders.
  • dialogTimeoutMinutes: how long a native select or input dialog waits for an answer before the question is cancelled; 30 by default, 0 for no limit, at most 35791. Pi's own dialogs close at the limit; an RPC client receives it as the request's timeout. The custom questionnaire has no timeout.
  • bridgeRepliesEnabled: whether pi-session-bridge may answer or reject a pending question.
  • answersAsUserMessage: mirror each answer into the conversation as a user message.

Maintainer notes are in DEVELOPMENT.md.

Bridge control

With pi-session-bridge installed, from any shell:

pi-bridge questions
pi-bridge answer --request-id que_example --answers '[["Stop here"]]'
pi-bridge reject --request-id que_example