Ask User Tool

What is it?

The Ask User tool is Yukkai's built-in way to pause and check with you before proceeding. Instead of guessing what you want or making assumptions, Yukkai can present a question — optionally with predefined answer choices — and wait for your response before continuing.

Think of it as a conversational checkpoint: Yukkai hits "pause," asks you something, then resumes based on your answer.

How it works

When Yukkai encounters a situation where it needs your input, it sends you a question directly in the chat. You can reply with a free-text answer or select from a list of predefined options if Yukkai provided any.

Here's the flow:

1. Yukkai recognizes ambiguity — A task has multiple valid paths, a destructive action is about to happen, or a preference needs to be confirmed.
2. A question is sent — Yukkai asks you directly, optionally with suggested answers.
3. You respond — Type your answer or pick from the options shown.
4. Yukkai continues — Your response is incorporated and the task proceeds.

The tool has two parameters:

Parameter	Type	Required	Description
question	string	Yes	The question to ask you
options	array	No	A list of predefined answer choices (optional)

How to use it

You don't need to do anything special — Yukkai uses this tool automatically when it needs your input. However, you can encourage Yukkai to ask you by being explicit in your requests.

When Yukkai will ask you

Yukkai typically uses this tool in these scenarios:

• Clarification — Your request could be interpreted in multiple ways and Yukkai wants to make sure it picks the right one.
• Confirmation — A task is about to modify files, send a message, or perform something irreversible, and Yukkai wants your go-ahead.
• Choice — There are several valid options (e.g., which design to use, which file to edit) and Yukkai wants you to decide.
• Missing information — A key detail is needed before Yukkai can proceed (e.g., a name, a date, a preference).

How to respond

When Yukkai asks you a question:

• If options are provided, you can simply pick one (e.g., "Option A" or just type the option text).
• If no options are given, reply freely with whatever answer makes sense.
• You can always add context to your answer — Yukkai will take the extra detail into account.

Examples

Example 1: Choosing between options

You ask Yukkai to create a new project, and it responds:

Which language would you like for this project?

1. Swift

2. TypeScript

3. Python

You reply: "Swift" — and Yukkai proceeds with a Swift project setup.

Example 2: Confirmation before a destructive action

You ask Yukkai to delete old backup files, and it responds:

I found 12 backup files matching "old_". Should I delete all of them?

You reply: "Yes, go ahead" or "Just the ones from 2023" — Yukkai adjusts accordingly.

Example 3: Free-form clarification

You ask Yukkai to "schedule a meeting next week," and it responds:

What day and time works best for you next week?

You reply: "Tuesday at 2pm, 1 hour" — Yukkai creates the calendar event with those details.

Example 4: Missing information

You ask Yukkai to send a message to someone, and it responds:

What should the message say?

You reply: "Hey, can we push the deadline to Friday?" — Yukkai sends it.

Tips & best practices

Tell Yukkai when to ask

If you want Yukkai to always confirm before certain actions, you can set a persistent rule. For example:

• "Always ask me before deleting files."
• "Confirm with me before sending messages on Telegram."
• "Ask me which version to use when there are multiple options."*

These rules are remembered across sessions, so Yukkai will consistently check with you.

Be specific in your answers

The more precise your response, the better Yukkai can act. Instead of:

"Yes"

Consider:

"Yes, but only for the production branch"

This extra context helps Yukkai make smarter decisions.

You can always override

Even if Yukkai presents predefined options, you're not locked into them. Feel free to type a completely different answer — Yukkai will adapt to what you say, not just what it suggested.

Don't worry about being asked too much

Yukkai is designed to only ask when it genuinely needs your input. It won't interrupt you for every small decision — only when the outcome depends on your choice.