Question Prompt - terminal-kit

cat components/question-prompt.tsx

❯

# question-prompt

Multiple-choice Q&A for ambiguous tasks. QuestionPrompt collects the answer and can show the selected option inline.

when to use — Call from ask_user or render when the agent needs a multiple-choice answer. Pass selectedId to show the chosen option.

──

examples

❯

Basic choices

Keyboard-navigable options with a built-in custom answer row.

[1/1] ↑/↓ navigate · Enter: select · last option: type custom

Which design direction should we use?

❯

Answered

After selection, QuestionPrompt marks the chosen option.

──

component api

QuestionPrompt

Prop	Type	Default	Description
question *	string	—	Question text shown above options.
options *	QuestionOption[]	—	Choices to render. Shape: { id: string; label: string; description?: string }.
selectedId	string	—	When set, the prompt hides after the user selects an option.
initialActiveIndex	number	0	Highlight this option on mount (0-based).
index	number	1	Current question index for multi-step flows (1-based).
total	number	1	Total questions in a multi-step flow.
customOptionLabel	string	"Something else…"	Label for the built-in custom answer row.
customOptionPlaceholder	string	"Type your answer"	Placeholder for the custom answer field.
onSelect	(id: string, customValue?: string) => void	—	Called when the user selects an option or submits a custom answer.
className	string	—	Additional CSS classes.

──

install

npx shadcn@latest add "https://www.terminal-kit.com/r/question-prompt.json"