ask-user-questions

AUQ - Ask User Questions is a tool that lets your AI assistants ask clarifying, multiple-choice or single-choice questions (with an optional 'Other' input) and then wait for human answers in a separate CLI window. It supports multi-agent workflows and can be integrated into MCP clients, OpenCode plugins, or Agent Skills. When used via the MCP server, you can trigger AUQ from your workflow and have humans interact with the question prompts without disrupting long-running AI tasks. The command-line interface presents a text-based UI for answering questions, while the underlying server coordinates question queues, rejection handling, elaboration requests, and optional auto-suggestions.

To use it through MCP, install the AUQ MCP server package and configure the server entry in your Claude/Curor/OpenCode or agent setup to point to the MCP server as shown in the integration guides. Once started, you can initiate AUQ sessions from your AI workflow, and the human operator can respond via the CLI window or the configured UI, enabling a smooth human-in-the-loop experience across multiple agents and tasks.

Prerequisites:

• Node/Bun environment to run the MCP server wrapper (AUQ is distributed as an MCP server package).
• Access to the integration method you prefer (MCP server, OpenCode plugin, or Agent Skills).

Installation steps:

1. Install the AUQ MCP server globally (recommended for CLI accessibility):

bun add -g auq-mcp-server

2. If you prefer a project-local install, you can add it to your project:

bun add auq-mcp-server

3. Start the MCP server via the command used in your integration. For Claude/Code environments, the common entry is:

bunx -y auq-mcp-server server

4. Verify the setup in your integration by issuing the configured MCP command (e.g., /mcp in Claude Code) to ensure the server responds and can be reached by your AI agent(s).

Prerequisites note: If bunx or bun is not the preferred launcher, you can adapt to your environment using the equivalent npx/pnpm/yarn wrapper if supported by your toolchain.

Tips and common considerations:

• The MCP configuration uses the server name ask-user-questions. Ensure this matches your integration mapping (e.g., Claude Code, Codex CLI, or other MCP clients).
• If you encounter long-running session timeouts, you may need to extend tool timeouts in your integration configuration (examples in the README show increasing timeout values for some clients).
• Sessions and history are typically stored globally per AUQ setup, so ensure your environment permissions (filesystem) allow persistent session storage.
• When integrating with multiple agents, AUQ supports multi-agent interoperability but ensure your workflow manages queueing and response handling appropriately to avoid race conditions.
• If you use OpenCode plugin or Agent Skills, follow the respective configuration details to ensure AUQ can be invoked from within those environments.