super-ux 0.3.0 → 0.4.0

package/CHANGELOG.md

@@ -4,6 +4,20 @@ All notable changes to this project are documented in this file. The format
 follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/); versions
 follow [SemVer](https://semver.org/spec/v2.0.0.html).
 
+## [0.4.0] - 2026-07-19
+
+### Added
+
+- Interactive installer menu: bare `npx super-ux` now offers (1) skills for
+  any of 70+ agents via the `skills` CLI picker, (2) Cursor rules into a
+  project, (3) the Claude Code plugin user-globally (runs the `claude plugin`
+  CLI when available). Flag paths (`--cursor [dir] [--force]`) unchanged.
+
+### Fixed
+
+- Prompt handling with piped stdin (persistent line buffer instead of
+  sequential `rl.question`, which dropped pre-buffered answers).
+
 ## [0.3.0] - 2026-07-19
 
 ### Added

package/README.md

@@ -60,13 +60,38 @@ Then in your project: `/ux`. That's it — it installs the hard rule, seeds
 `docs/ux/`, builds the scenario base if empty, and on every later run just
 reports status and the next action.
 
+### Any agent via the skills CLI (70+ agents)
+
+```sh
+npx skills add ssheleg/super-ux            # both skills, current project
+npx skills add ssheleg/super-ux -g         # user-global
+npx skills add ssheleg/super-ux --skill ux-audit   # one skill
+```
+
+[vercel-labs/skills](https://github.com/vercel-labs/skills) discovers the
+skills through this repo's marketplace manifest and installs them for Claude
+Code, Cursor, Codex, OpenCode and others. Note: this installs the two skills
+only — the `/ux` commands and the Cursor always-on hard rule come with the
+methods below.
+
+### Interactive (pick agent + scope)
+
+```sh
+npx super-ux
+```
+
+Menu: skills for any of 70+ agents (delegates to the `skills` CLI picker —
+choose agents and global/project there), Cursor rules into a project, or the
+Claude Code plugin user-globally.
+
 ### Cursor
 
 ```sh
-npx github:ssheleg/super-ux --cursor /path/to/your/project
+npx super-ux --cursor /path/to/your/project
 ```
 
-(or clone and run `./install.sh --cursor <dir>` — same behavior.) Copies the
+(also works: `npx github:ssheleg/super-ux --cursor <dir>` straight from the
+repo, or clone and run `./install.sh --cursor <dir>` — same behavior.) Copies the
 three rules into `.cursor/rules/` and seeds `docs/ux/scenarios.md`. An
 existing scenario base is never overwritten; re-run with `--force` to update
 rules after a new release.
@@ -100,7 +125,7 @@ is semver; bump `marketplace.json` + `plugin.json` + `CHANGELOG.md` together
 чек-листом для регулярных аудитов кода (`/ux-audit`) с вердиктами
 PASS/PARTIAL/FAIL/BLOCKED и доказательствами `file:line`. Установка: в
 Claude Code — `/plugin marketplace add ssheleg/super-ux`, в Cursor —
-`npx github:ssheleg/super-ux --cursor <проект>`. Дальше одна команда — `/ux`: сама ставит
+`npx super-ux --cursor <проект>`. Дальше одна команда — `/ux`: сама ставит
 правило и базу, а при повторных запусках показывает статус и следующий шаг.
 
 ## License

package/bin/super-ux.js

@@ -1,33 +1,38 @@
 #!/usr/bin/env node
 /*
  * super-ux installer CLI.
- * Cross-platform equivalent of install.sh: copies Cursor rules into a target
- * project and seeds the docs/ux skeleton. Claude Code needs no installer —
- * see usage.
+ *
+ * No arguments: interactive menu (skills for any agent via the `skills` CLI
+ * picker, Cursor rules into a project, Claude Code plugin user-globally).
+ * Flags keep the non-interactive paths: --cursor [dir] [--force].
  */
 'use strict';
 
 const fs = require('fs');
 const path = require('path');
+const readline = require('readline');
+const { spawnSync } = require('child_process');
 
 const ROOT = path.resolve(__dirname, '..');
+const REPO = 'ssheleg/super-ux';
 
 function usage() {
   console.log(`super-ux installer
 
 Usage:
-  npx github:ssheleg/super-ux --cursor [project-dir] [--force]
-  npx super-ux --cursor [project-dir] [--force]        (once published to npm)
-
-Copies cursor/rules/*.mdc into <project-dir>/.cursor/rules/ (default:
-current directory) and seeds docs/ux/scenarios.md from templates/ if absent.
-An existing scenario base is NEVER overwritten. Existing rule files are
-skipped unless --force is given.
-
-Claude Code (no installer needed):
-  /plugin marketplace add ssheleg/super-ux
-  /plugin install super-ux@super-ux
-  Then in your project: /ux`);
+  npx super-ux                                  interactive menu
+  npx super-ux --cursor [project-dir] [--force] Cursor rules, non-interactive
+  npx super-ux --help
+
+Menu options (also available directly):
+  1. Skills for any AI agent (Claude Code, Codex, Cursor, 70+) — delegates to
+     'npx skills add ${REPO}' with its agent/global/project picker.
+  2. Cursor rules: cursor/rules/*.mdc -> <project>/.cursor/rules/ plus the
+     docs/ux skeleton. Existing scenario base is NEVER overwritten; existing
+     rule files are skipped unless --force.
+  3. Claude Code plugin (skills + /ux commands, user-global) — runs
+     'claude plugin marketplace add ${REPO}' + 'claude plugin install' when
+     the claude CLI is available, otherwise prints the /plugin commands.`);
 }
 
 function fail(message) {
@@ -73,12 +78,112 @@ function installCursor(target, force) {
   console.log(`done: ${installed} installed, ${skipped} skipped`);
 }
 
+function run(cmd, args) {
+  const result = spawnSync(cmd, args, { stdio: 'inherit' });
+  if (result.error && result.error.code === 'ENOENT') return 'missing';
+  return result.status === 0 ? 'ok' : 'failed';
+}
+
+function installSkillsCli() {
+  console.log(`Delegating to the skills CLI (agent/global/project picker)...`);
+  const status = run('npx', ['--yes', 'skills', 'add', REPO]);
+  if (status !== 'ok') fail(`'npx skills add ${REPO}' ${status}`);
+}
+
+function installClaudePlugin() {
+  const probe = spawnSync('claude', ['--version'], { stdio: 'ignore' });
+  if (probe.error && probe.error.code === 'ENOENT') {
+    console.log(`claude CLI not found. Run inside Claude Code instead:
+  /plugin marketplace add ${REPO}
+  /plugin install super-ux@super-ux`);
+    return;
+  }
+  if (run('claude', ['plugin', 'marketplace', 'add', REPO]) !== 'ok') {
+    console.log('(marketplace may already be added — continuing)');
+  }
+  if (run('claude', ['plugin', 'install', 'super-ux@super-ux']) === 'ok') {
+    console.log('Claude Code plugin installed (scope: user). Restart sessions to pick it up; then run /ux in any project.');
+  } else {
+    fail('claude plugin install failed — see output above');
+  }
+}
+
+function makePrompter() {
+  // A persistent 'line' listener with a buffer: with piped stdin, lines that
+  // arrive between two questions are kept instead of being lost (which is
+  // what plain sequential rl.question() does).
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  const buffered = [];
+  let pending = null;
+  let closed = false;
+  rl.on('line', (line) => {
+    if (pending) {
+      const resolve = pending;
+      pending = null;
+      resolve(line);
+    } else {
+      buffered.push(line);
+    }
+  });
+  rl.on('close', () => {
+    closed = true;
+    if (pending) {
+      const resolve = pending;
+      pending = null;
+      resolve('');
+    }
+  });
+  return {
+    ask(question) {
+      process.stdout.write(question);
+      if (buffered.length > 0) return Promise.resolve(buffered.shift());
+      if (closed) return Promise.resolve('');
+      return new Promise((resolve) => {
+        pending = resolve;
+      });
+    },
+    close() {
+      rl.close();
+    },
+  };
+}
+
+async function menu() {
+  const prompter = makePrompter();
+  console.log(`super-ux — scenario-driven UI development. What do you want to install?
+
+  1) Skills for any AI agent (Claude Code, Codex, Cursor, 70+ — interactive picker)
+  2) Cursor rules (always-on hard rule + docs/ux skeleton) into a project
+  3) Claude Code plugin (skills + /ux commands, user-global)
+  q) Quit
+`);
+  const choice = (await prompter.ask('Choice [1/2/3/q]: ')).trim().toLowerCase();
+  if (choice === '1') {
+    prompter.close();
+    installSkillsCli();
+  } else if (choice === '2') {
+    const dir = (await prompter.ask('Project directory [.]: ')).trim() || '.';
+    prompter.close();
+    installCursor(path.resolve(dir), false);
+  } else if (choice === '3') {
+    prompter.close();
+    installClaudePlugin();
+  } else {
+    prompter.close();
+    if (choice !== 'q' && choice !== '') fail(`unknown choice '${choice}'`);
+  }
+}
+
 function main() {
   const args = process.argv.slice(2);
-  if (args.length === 0 || args[0] === '--help' || args[0] === '-h') {
+  if (args[0] === '--help' || args[0] === '-h') {
     usage();
     return;
   }
+  if (args.length === 0) {
+    menu();
+    return;
+  }
   if (args[0] !== '--cursor') {
     console.error(`error: unknown mode '${args[0]}'`);
     usage();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "super-ux",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Scenario-driven UI development for AI agents (Claude Code + Cursor): scenario base, scenario-first hard rule, evidence-backed UX audits. This package is the installer CLI.",
   "bin": { "super-ux": "bin/super-ux.js" },
   "files": ["bin", "cursor", "templates", "README.md", "LICENSE", "CHANGELOG.md"],