@nativepi/ask-user

Lets Pi ask focused multiple-choice questions instead of guessing when a decision matters.

Packages

Package details

extension

Install @nativepi/ask-user from npm and Pi will load the resources declared by the package manifest.

npm repo home report

$ pi install npm:@nativepi/ask-user

Package: @nativepi/ask-user
Version: 1.0.0
Published: Aug 12, 2026
Downloads: 100/mo · 10/wk
Author: nonlooped
License: MIT
Types: extension
Size: 25.9 KB
Dependencies: 2 dependencies · 3 peers

Pi manifest JSON

{
  "extensions": [
    "./extensions/ask-user.ts"
  ]
}

Security note

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

README

@nativepi/ask-user

A Pi package that gives the agent an ask_user tool for resolving important ambiguity with a focused question. It has a dedicated graphical dialog in NativePi and a keyboard-driven interface in Pi's terminal.

Every question must offer at least two options and mark at least one as recommended. Recommendations remain advice only: you can choose any option, write your own answer without leaving the question, or cancel.

Install

pi install @nativepi/ask-user

Pi loads the tool automatically. No configuration is required.

Tool input

{
  "question": "Which implementation should I use?",
  "options": [
    {
      "label": "Use the existing library",
      "description": "Smaller and easier to maintain",
      "recommended": true
    },
    {
      "label": "Build a custom implementation",
      "description": "More control, but more maintenance",
      "recommended": false
    }
  ]
}

The tool waits for your choice or written answer and returns it to the agent. Cancelling is reported explicitly rather than treated as a selection. In non-interactive print and JSON modes, the tool reports that interaction is unavailable instead of guessing.