---

name: ask-user-questions description: Ask clarifying questions to users via interactive TUI. Use when you need user input on preferences, implementation choices, or ambiguous instructions. license: MIT metadata: author: paulp-o version: "3.3.1"

Ask User Questions

Use this tool when you need to ask the user questions during execution. This allows you to:

Gather user preferences or requirements Clarify ambiguous instructions Get decisions on implementation choices as you work Offer choices to the user about what direction to take. Usage notes:

Users will always be able to select "Other" to provide custom text input Use multiSelect: true to allow multiple answers to be selected for a question Recommend an option unless absolutely necessary, make it the first option in the list and add "(Recommended)" at the end of the label For multiSelect questions, you MAY mark multiple options as "(Recommended)" if several choices are advisable Do NOT use this tool to ask "Is my plan ready?" or "Should I proceed?"

Usage

# Ask questions via CLI
npx auq ask '{"questions": [...]}'

# Or pipe JSON input
echo '{"questions": [...]}' | npx auq ask

Parameters

{
  "questions": [
    {
      "prompt": "Which authentication method would you like to use?",
      "title": "Auth",
      "options": [
        {"label": "JWT (Recommended)", "description": "Stateless, scalable"},
        {"label": "Session cookies", "description": "Traditional, server-side"}
      ],
      "multiSelect": false
    }
  ]
}

Field	Type	Required	Description
questions	array	Yes	1-5 question objects
questions[].prompt	string	Yes	Full question text
questions[].title	string	Yes	Short label (max 12 chars)
questions[].options	array	Yes	2-5 options with label and optional description
questions[].multiSelect	boolean	Yes	Allow multiple selections