@staff0rd/assist 0.958.0 → 0.960.0

package/README.md

@@ -288,7 +288,7 @@ Rules are `- **<code>** — **<title>** — <text>` bullets, the title optional,
 
 ### Hooks
 
-- `assist cli-hook` - PreToolUse hook auto-approving CLI commands from `allowed.cli-reads` / `allowed.cli-writes`, and denying reads of `~/.assist/restricted`
+- `assist cli-hook` - PreToolUse hook auto-approving CLI commands from `allowed.cli-reads` / `allowed.cli-writes`, denying reads of `~/.assist/restricted`, and (with `sessions.askQuestion` on) denying `AskUserQuestion` in assist sessions in favour of `assist ask-question`
 - `assist cli-hook add <cli>` - Discover a CLI's commands and auto-permit read-only ones
 - `assist cli-hook check <command> [--tool <tool>]` - Check whether a command would be auto-approved
 - `assist cli-hook deny` - List all deny rules
@@ -357,6 +357,7 @@ Rules are `- **<code>** — **<title>** — <text>` bullets, the title optional,
 - `assist prompts` - Show the most frequently denied tool calls
 - `assist chart [--title <title>]` - Draw a terminal line chart of a `label value` series piped in on stdin, one pair per line
 - `assist ask --title <title> --body <markdown|->` - Put a plan, summary or proposed decision in the session's web preview pane and wait for the user to approve or reject it; `--body -` reads stdin
+- `assist ask-question --json <file|->` - Ask `AskUserQuestion` questions (1-4, each with 2-4 options, plus an Other free-text answer) as a form in the session's web preview pane and wait for the answers; prints the same result text as the built-in tool, exits non-zero when dismissed, and outside an assist session or with `sessions.askQuestion` off (the default) exits non-zero so Claude uses the built-in tool
 - `assist show --body <markdown|-> [--title <title>]` - Render markdown in the session's web preview pane so long links, paths and code can be clicked and copied unbroken; `--body -` reads stdin
 
 ### Project setup

package/claude/advice/ask-question.md

@@ -0,0 +1,6 @@
+---
+title: Asking questions
+when: askQuestion
+---
+
+In an assist session (`ASSIST_SESSION=1`), don't use the built-in AskUserQuestion tool; the user answers from the session's web preview pane, which can't drive the terminal prompt. Write the same AskUserQuestion input as JSON (`{"questions": [...]}`, 1-4 questions each with `question`, `header`, `multiSelect` and 2-4 `options` of `label`, `description` and optional `preview`) to a scratch file and run `assist ask-question --json - < <file>` as a background task, doing no other work until it returns. It opens as a form in the preview pane and blocks until answered. Answering exits 0 and prints the same answer text AskUserQuestion returns; dismissing exits non-zero, meaning the user declined to answer. To revise a still-pending question, re-run it directly; the earlier task then exits 0 as superseded — ignore its result. Outside an assist session it exits non-zero, so use AskUserQuestion.

package/claude/settings.json

@@ -26,6 +26,10 @@
 				"matcher": "Read|Grep|Glob",
 				"hooks": [{ "type": "command", "command": "assist cli-hook" }]
 			},
+			{
+				"matcher": "AskUserQuestion",
+				"hooks": [{ "type": "command", "command": "assist cli-hook" }]
+			},
 			{
 				"matcher": "Edit|Write|MultiEdit",
 				"hooks": [{ "type": "command", "command": "assist edit-hook" }]