Answer Claude Code’s questions from your iPhone

Updated

Quick answer

When Claude Code asks a multiple-choice question, it calls a tool named AskUserQuestion, and a hook can supply the answer. Monish sends the question and its options to your iPhone. You pick one, and the answer goes back to Claude Code as if you had chosen it in the terminal, where the question stays on screen in the meantime.

What AskUserQuestion is

When Claude needs a decision or a clarification, it can stop and ask instead of guessing. It does so through a built-in tool, AskUserQuestion, which carries one to four questions. Each has a short header, two to four options with a label and a description, and may allow several answers:

The tool’s input, as a hook sees it

{
  "tool_name": "AskUserQuestion",
  "tool_input": {
    "questions": [
      {
        "question": "Which branch should this go on?",
        "header": "Branch",
        "options": [
          { "label": "A new branch, feat/login", "description": "Keeps main clean" },
          { "label": "main", "description": "Ship it directly" }
        ],
        "multiSelect": false
      }
    ]
  }
}

In the terminal you pick an option, or type your own text through the Other row. The question waits until you answer: unless you set askUserQuestionTimeout to 60 seconds, 5 or 10 minutes, it never closes on its own, and that timer never starts while the session is connected to Remote Control. No permission mode answers it for you, not even bypassPermissions. In a claude -p run the tool is only offered when something can receive the prompt, so scripted runs rarely ask at all.

How a hook can answer for you

The documented way is a PreToolUse hook on AskUserQuestion. It collects the answer however it likes, then returns allow together with the questions it received and an answers object, keyed by the exact text of each question. An allow alone is not enough for this tool.

The hook’s output

{
  "hookSpecificOutput": {
    "hookEventName": "PreToolUse",
    "permissionDecision": "allow",
    "updatedInput": {
      "questions": [ ...the same questions, unchanged... ],
      "answers": { "Which branch should this go on?": "A new branch, feat/login" }
    }
  }
}

For a multiple-choice question, join the chosen labels with commas. One catch: while a PreToolUse hook waits, the terminal shows the hook running, not the question, so a hook that waits for someone elsewhere must give up as soon as you are back at the keyboard. PermissionRequest accepts the same updatedInput when a question reaches it. Monish answers through a hook in this way.

Answer from the lock screen

The notification reads Claude has a question · lumen. Open it and you see the question with each option, label and description, as Claude wrote them. Tap one and Send: the card shows You answered: A new branch, feat/login, and Claude Code continues as if you had picked it in the terminal. The question stays on screen in your terminal in the meantime, and the first answer wins.

If the session’s card is on your lock screen, it turns to the question, with up to three short options as buttons, and a notification with sound goes out. A tap on an option answers. A question with more options, or one you want to answer in your own words, opens in the app.

Several questions at once

Claude can ask up to four questions in one call. The card takes them one after another, 1 of 2, then 2 of 2, and sends all the answers together, since Claude Code expects one answer per question. When a question allows several answers, the card says Pick one or more. If you don’t answer, nothing is chosen for you: your iPhone can answer within the answer window set in the app’s Settings, 10 minutes by default, then Claude Code asks you in the terminal.

Forms from MCP servers

An MCP server can also ask you something in the middle of a tool call: a form with fields, or a link to open for a sign-in. Claude Code shows it as a dialog and runs an Elicitation hook first. The hook can answer with accept and the field values, decline or cancel; if it prints nothing, the dialog appears.

An Elicitation hook that fills in a one-field form

{"hookSpecificOutput":{"hookEventName":"Elicitation","action":"accept","content":{"env":"dev"}}}

With Monish, short forms, such as a choice, a yes or no, or a short text, arrive on your iPhone with Submit and Decline. Longer forms stay in the terminal. If you only want to know that a form is waiting, the Notification hook’s elicitation_dialog type fires once it has waited about six seconds.

When you are at the keyboard

While you’re typing in the terminal, Claude asks there as usual, and the question reaches your iPhone as a silent note. If you answer there after the push went out, the card on your iPhone closes as Answered in the terminal. One more thing about modes: auto mode nudges Claude to keep working instead of stopping for clarifications, so it asks fewer questions. It still asks when your prompt or a skill relies on it, and those questions reach your iPhone like any other.

Questions

Does a question ever time out?
Not by default: it waits until you answer. You can set askUserQuestionTimeout to 60 seconds, 5 or 10 minutes, after which Claude continues on its own judgment. With Monish, your iPhone can answer within the answer window, 10 minutes by default, then Claude Code asks you in the terminal.
Why doesn’t Claude ask questions in claude -p runs?
In non-interactive mode, Claude Code only offers AskUserQuestion when the run has a permission host to receive it, such as an Agent SDK canUseTool callback or a --permission-prompt-tool. A hook alone doesn’t bring it back.
Does Claude ask fewer questions in auto mode?
Yes. Auto mode nudges Claude to keep working without stopping for clarifications. It still asks when your prompt or a skill explicitly relies on it.
What does Claude see when I answer from my phone?
The same as a choice in the terminal: the answers field maps each question to the label you picked.

More guides

New to Monish? The home page shows what lands on your iPhone, and all guides are listed here.

Get Monish on your iPhone

Free, no account. Your 6-digit code is waiting in the app.

Download on the App Store