Interactive Questions with the Question Tool

Use the question tool to ask users structured, interactive questions with selectable options instead of plain yes/no or free-text prompts. This produces a numbered option list the user navigates with arrow keys and confirms with Enter.

Core Rule

Never ask a yes/no question in plain text when the answer can be expressed as a set of options. Always use the question tool with explicit choices.

Wrong:

"Do you want to proceed? (yes/no)"

Right: use the question tool with options such as "Proceed" and "Cancel".

When to Use the Question Tool

Use it whenever you need the user to make a decision: