claude-nova/docs/features/questions.md

Questions

Status: Implemented · Code: Scripts/permissions.js (_askQuestions, _askOne, _askMultiple)

When Claude needs a decision it calls AskUserQuestion, which arrives as a can_use_tool request with requires_user_interaction: true.

Input

{"questions":[{
  "question":"Do you prefer tabs or spaces?",
  "header":"Indentation",
  "multiSelect":false,
  "options":[{"label":"Tabs","description":"…"},{"label":"Spaces","description":"…"}]
}]}

Answering

The host rewrites the tool input; there is no separate answer channel:

{"behavior":"allow",
 "updatedInput":{…input, "answers":{"<question text>":"<chosen label>"}}}

Keyed by the question's exact text. The CLI feeds it to the tool, which reports back "Your questions have been answered: …". Verified end to end: answering "Tabs" produced a model reply of "You chose Tabs."

Multi-select answers are joined with , .

Presentation

Each question becomes a showChoicePalette with label — description rows, asked in sequence.

• Single select appends Other…, which opens an input panel for free text.
• Multi select toggles rows with a ✓ marker and appends Done — N selected; with nothing selected that row is Other… instead.
• Dismissing a palette resolves deny with "The user dismissed the question without answering" — matching Claude Code's own Escape behaviour.

Unit-covered: multi-select, free text, dismissal, and several questions in sequence.