@kirmad/askuserquestion

OpenCode plugin that provides a native GUI dialog for asking users questions. Works cross-platform with prebuilt binaries for macOS, Linux, and Windows.

Features

• Native GUI dialogs (not browser-based)
• Cross-platform support (macOS, Linux, Windows)
• Single-select and multi-select questions
• Custom "Other" option with free-text input
• Beautiful dark theme UI
• Sound notification when dialog appears

Installation

npm install @kirmad/askuserquestion

The correct platform-specific binary is automatically installed based on your OS and architecture.

Usage with OpenCode

Add to your opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["@kirmad/askuserquestion"]
}

This registers the AskUserQuestion tool automatically.

Tool: AskUserQuestion

Parameters

Parameter	Type	Description
questions	Question[]	1-4 questions to ask

Question Object

Property	Type	Description
question	string	The full question text
header	string	Short label (max 12 chars)
options	QuestionOption[]	2-4 options to choose from
multiSelect	boolean	Allow multiple selections

QuestionOption Object

Property	Type	Description
label	string	Display text for the option
description	string	Explanation of what this option means

Response

{
  "status": "selected",
  "answers": {
    "Auth": "OAuth 2.0",
    "Features": ["Dark mode", "Analytics"]
  }
}

Status can be "selected", "cancelled", or "error".

Supported Platforms

Platform	Architecture	Package
macOS	Apple Silicon (M1/M2/M3)	@kirmad/askuserquestion-darwin-arm64
macOS	Intel	@kirmad/askuserquestion-darwin-x64
Linux	x64	@kirmad/askuserquestion-linux-x64
Linux	ARM64	@kirmad/askuserquestion-linux-arm64
Windows	x64	@kirmad/askuserquestion-win32-x64

Development

Building locally

cd ask-user-app
cargo build --release

Publishing

1. Add NPM_TOKEN secret to GitHub repository settings
2. Create a tag: git tag v0.1.0 && git push --tags
3. GitHub Actions will build all platforms and publish to npm

License

MIT