avtc-pi-ask-user-question

A question tool for the agent — single/multi-select or free-text, with subagent forwarding and attention alerts.

Packages

Package details

extension

Install avtc-pi-ask-user-question from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:avtc-pi-ask-user-question
Package
avtc-pi-ask-user-question
Version
1.0.5
Published
Jul 17, 2026
Downloads
896/mo · 896/wk
Author
avtc
License
MIT
Types
extension
Size
173.3 KB
Dependencies
1 dependency · 0 peers
Pi manifest JSON
{
  "extensions": [
    "./index.ts",
    "../avtc-pi-ui-components/index.ts"
  ],
  "allowedCodeDeps": []
}

Security note

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

README

avtc-pi-ask-user-question

A question tool for the agent — single/multi-select or free-text, with subagent forwarding and attention alerts.

Features

  • Single & multi-select — pick one option or check several; each option has a label and description
  • Free-text "Other" — every question has a row to type a custom answer
  • Multiline free-text (Ctrl/Shift/Cmd+Enter = newline)
  • Multi-question tabs — up to four questions in one dialog, each with a short header
  • Subagent forwarding — questions from subagent avtc-pi-subagent sessions are bridged avtc-pi-subagent-ui-bridge to the root UI as a single unified dialog
  • Attention alerts — integrates with avtc-pi-notification to notify you when the agent is waiting
  • Dialog coordination — uses avtc-pi-ui-components dialog coordinator to prevent overlapping dialogs across extensions.

Tools

Tool Description
ask_user_question Ask the user 1–4 structured questions (single-select, multi-select, or free-text) and wait for answers

What it looks like

Single-select

Single select question

Multi-select, multiple questions, and multiline free-text

Multi-select with checkboxes across tabbed questions, including a multiline free-text answer

Submit review

Submit tab showing all answers

Installation

pi install npm:avtc-pi-ask-user-question

Usage

Once installed, the tool is available to the agent automatically. Ask it to clarify something before proceeding — it calls ask_user_question, you answer in the TUI, and it continues with your answers:

Help me scaffold a new web app. Ask me what you need to know first.

Key bindings

Key Action
↑ ↓ Move cursor
Enter Select / confirm / submit
Space Toggle (multi-select)
Tab Open the free-text editor (on the "Other" row)
← → Switch tabs
Esc Cancel (or discard free-text)

Full suite

Check out the full suite of related extensions, avtc-pi — deterministic feature development, subagent delegation, working-memory, behavioral learning, parallel-work guardrails, durable decisions, notifications, and more.

Developed with Z.ai — get 10% off your subscription via this referral link.

Attribution

Inspired by Claude Code's AskUserQuestion tool. Fork of ghoseb/pi-askuserquestion.

License

MIT