When requirements are unclear, give Pi a way to ask you focused questions instead of guessing.
ask lets Pi present up to four multiple-choice questions, one at a time, while it is working.
Use it in Pi
Nothing to invoke.
Ask Pi to clarify uncertainty as it works, for example: Ask me about any choices that affect the implementation.
Pi can use its ask_user_question tool to offer choices, accept a free-text answer, and continue with your decision.
Choose an option or choose Other (free text) to write your own answer.
You can add a note in the full-screen Pi interface.
Canceling a question stops that agent turn so Pi waits for new direction.
Interactive Pi sessions can show these questions.
Print and JSON modes receive an unavailable result unless a separate connected question provider handles the request.
During a native voice call
Questions remain in the ordinary Pi interface.
Native voice does not claim questions, submit spoken answers or approve options on your behalf.
Answer in Pi; the original executor tool continues in the same session.
<img src="assets/banner.svg" alt="ask" height="70">
# ask
When requirements are unclear, give Pi a way to ask you focused questions instead of guessing.
`ask` lets Pi present up to four multiple-choice questions, one at a time, while it is working.

## Use it in Pi
Nothing to invoke.
Ask Pi to clarify uncertainty as it works, for example: `Ask me about any choices that affect the implementation.`
Pi can use its `ask_user_question` tool to offer choices, accept a free-text answer, and continue with your decision.
Choose an option or choose `Other (free text)` to write your own answer.
You can add a note in the full-screen Pi interface.
Canceling a question stops that agent turn so Pi waits for new direction.
Interactive Pi sessions can show these questions.
Print and JSON modes receive an unavailable result unless a separate connected question provider handles the request.
## During a native voice call
Questions remain in the ordinary Pi interface.
Native voice does not claim questions, submit spoken answers or approve options on your behalf.
Answer in Pi; the original executor tool continues in the same session.
Install through [Installation](../../README.md#install).
<!-- config:start -->
<!-- config:end -->