askq-cli 0.1.4

package/README.md

@@ -0,0 +1,39 @@
+# askq
+
+Native GUI for AskUserQuestion-style multiple-choice prompts, for AI coding
+agents. A blocking CLI: feed it the questions JSON, the user answers in a real
+window, it prints the answers JSON to stdout and exits. Also runs as an MCP
+server.
+
+```bash
+npm install -g askq-cli
+```
+
+This installs the `askq` command. (The package is `askq-cli` because the bare
+name `askq` is blocked by npm's similarity filter; the CLI itself is `askq`.) The
+right prebuilt binary for your platform is pulled in automatically as an optional
+dependency (`askq-darwin-arm64`, `askq-linux-x64`, `askq-linux-arm64`).
+
+## Use
+
+```bash
+# CLI: pipe questions in, read answers out
+echo '{"questions":[{"question":"Pick one","header":"Demo","multiSelect":false,
+  "options":[{"label":"A","description":"first"},{"label":"B"}]}]}' | askq
+# => {"questions":[...],"answers":{"Pick one":"A"}}
+
+askq --help        # full input/output schema
+askq mcp           # run as an MCP server (stdio) exposing ask_user_question
+```
+
+## MCP
+
+Register it with any MCP client (Claude Code `.mcp.json`, Cursor
+`.cursor/mcp.json`, …):
+
+```json
+{ "mcpServers": { "askq": { "command": "askq", "args": ["mcp"] } } }
+```
+
+Source, the Claude Code plugin (PreToolUse hook + skill), and full docs:
+https://github.com/AngusFu/askq

package/bin/askq

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+// Launcher for the `askq` CLI. The actual native binary ships in a
+// per-platform optional dependency (askq-<platform>-<arch>); npm installs only
+// the one matching the host. We resolve it and exec, passing stdin/stdout/
+// stderr straight through (askq is a blocking stdio tool — questions in on
+// stdin, answers out on stdout) and proxying the exit code.
+"use strict";
+
+const { spawnSync } = require("child_process");
+
+// node platform/arch -> our subpackage suffix (they already line up:
+// darwin/linux + arm64/x64).
+const pkg = `askq-${process.platform}-${process.arch}`;
+
+let binary;
+try {
+  binary = require.resolve(`${pkg}/bin/askq`);
+} catch (_) {
+  console.error(
+    `askq: no prebuilt binary for ${process.platform}-${process.arch}.\n` +
+      `The optional dependency "${pkg}" is not installed.\n` +
+      `Supported platforms: darwin-arm64, linux-x64, linux-arm64.\n` +
+      `If you installed with --no-optional or --omit=optional, reinstall without it.`
+  );
+  process.exit(1);
+}
+
+const result = spawnSync(binary, process.argv.slice(2), { stdio: "inherit" });
+if (result.error) {
+  console.error(`askq: failed to run ${binary}: ${result.error.message}`);
+  process.exit(1);
+}
+// Forward the child's signal/exit code.
+if (result.signal) {
+  process.kill(process.pid, result.signal);
+} else {
+  process.exit(result.status === null ? 1 : result.status);
+}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "askq-cli",
+  "version": "0.1.4",
+  "description": "Native GUI for AskUserQuestion-style multiple-choice prompts (CLI + MCP server) for AI coding agents. Pops a window, prints the chosen answers as JSON.",
+  "bin": {
+    "askq": "bin/askq"
+  },
+  "files": [
+    "bin/askq"
+  ],
+  "optionalDependencies": {
+    "askq-darwin-arm64": "0.1.4",
+    "askq-linux-x64": "0.1.4",
+    "askq-linux-arm64": "0.1.4"
+  },
+  "engines": {
+    "node": ">=16"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AngusFu/askq.git"
+  },
+  "homepage": "https://github.com/AngusFu/askq#readme",
+  "bugs": {
+    "url": "https://github.com/AngusFu/askq/issues"
+  },
+  "license": "MIT",
+  "author": "AngusFu",
+  "keywords": [
+    "askuserquestion",
+    "mcp",
+    "cli",
+    "gui",
+    "tauri",
+    "claude",
+    "prompt"
+  ]
+}