@darkrei08/setup-ai 3.0.1 → 3.0.3

package/README.md

@@ -10,30 +10,24 @@ skill — each via its **official, current** method for your OS.
 
 ## Quick start
 
+One command. No install, no clone. It opens a menu to choose what to set up:
+
 ```bash
-# no install needed — runs the launcher once, then discards it
 npx github:darkrei08/setup-ai
 ```
 
-or, once published to npm:
+Prefer non-interactive? Same command, add a flag:
 
 ```bash
-npx @darkrei08/setup-ai                    # interactive module menu
-npx @darkrei08/setup-ai --only pi,codex,opencode
-npx @darkrei08/setup-ai --all              # everything incl. optional GUI apps
-npm i -g @darkrei08/setup-ai && setup-ai   # global command
+npx github:darkrei08/setup-ai --only pi,codex,opencode   # just these
+npx github:darkrei08/setup-ai --all                      # everything
 ```
 
-The launcher (`bin/setup-ai.mjs`, zero dependencies) detects your OS and runs
-the right script: `setup-ai.ps1` on Windows (via `pwsh`), `setup-ai.sh` on
-macOS/Linux (via `bash`). With no selection flag on an interactive terminal it
-opens an arrow-key **multi-select menu** (↑/↓ move · Space toggle · `a` all ·
-Enter confirm); on a non-interactive shell it installs the core set.
+That's the whole thing. Three details worth knowing:
 
-> **Windows / PowerShell**: paste each command on a **single line** — the bash
-> `\` line-continuation is not valid in PowerShell. If a runtime (node, git) was
-> just installed this run, open a **new terminal** before re-running so the
-> updated PATH is picked up.
+- **Windows PowerShell**: one command per line (no bash `\`). If node or git was just installed, open a **new terminal** so PATH refreshes.
+- **What it does**: detects your OS and runs `setup-ai.sh` (macOS/Linux) or `setup-ai.ps1` (Windows). Menu keys: ↑/↓ move · Space toggle · `a` all · Enter.
+- **Shorter name**: once it's on npm, drop `github:` → `npx @darkrei08/setup-ai` (run it from any folder except the repo's own source dir).
 
 ### npm vs npx
 

package/bin/setup-ai.mjs

@@ -106,7 +106,7 @@ function toScriptArgs(mode, csv) {
 
 // ---- interactive multi-select (gentle-ai style) ---------------------------
 function interactiveMenu() {
-  return new Promise((resolve) => {
+  return new Promise((resolve, reject) => {
     const items = menuModules.map((m) => ({ ...m, checked: m.core }));
     let cursor = 0;
     const out = process.stdout;
@@ -125,17 +125,29 @@ function interactiveMenu() {
     };
 
     const stdin = process.stdin;
-    stdin.setRawMode(true);
+    if (typeof stdin.setRawMode !== "function") {
+      return reject(new Error("stdin is not a raw-capable TTY"));
+    }
+    try {
+      stdin.setRawMode(true);
+    } catch (err) {
+      return reject(err);
+    }
     stdin.resume();
     stdin.setEncoding("utf8");
     render(true);
 
     const cleanup = () => {
-      stdin.setRawMode(false);
+      try { stdin.setRawMode(false); } catch { /* ignore */ }
       stdin.pause();
       stdin.removeListener("data", onData);
+      stdin.removeListener("end", onEnd);
     };
 
+    // If stdin closes before a choice (e.g. npx consumed it), fall back instead
+    // of hanging or exiting silently.
+    const onEnd = () => { cleanup(); reject(new Error("stdin closed before a choice was made")); };
+
     const onData = (key) => {
       if (key === "\x03" || key === "q") { // ctrl-c / q
         cleanup();
@@ -156,6 +168,7 @@ function interactiveMenu() {
       }
     };
     stdin.on("data", onData);
+    stdin.on("end", onEnd);
   });
 }
 
@@ -165,6 +178,11 @@ function defaultSelection() {
 }
 
 async function main() {
+  // Always emit a first line so the user sees the launcher started, even if
+  // something downstream fails (this is what "npx returns to prompt silently"
+  // needed).
+  console.log(`setup-ai launcher · ${process.platform}`);
+
   if (has("--help") || has("-h")) return runScript(toScriptArgs("help"));
   if (has("--list")) return runScript(toScriptArgs("list"));
   if (has("--all")) return runScript(toScriptArgs("all"));
@@ -174,18 +192,36 @@ async function main() {
 
   if (has("--yes") || has("-y")) return runScript(toScriptArgs("yes"));
 
-  // No selection flag: interactive menu if we have a TTY, else core defaults.
+  // No selection flag: try the interactive menu; fall back cleanly if the
+  // terminal/stdin can't drive it (common under some npx/CI shells).
+  let chosen = null;
   if (process.stdin.isTTY && process.stdout.isTTY) {
-    const chosen = await interactiveMenu();
-    if (!chosen.length) {
-      console.log("Nothing selected — exiting.");
-      process.exit(0);
+    try {
+      chosen = await interactiveMenu();
+    } catch (err) {
+      console.log(`\n(interactive menu unavailable: ${err.message})`);
+      chosen = null;
     }
-    return runScript(toScriptArgs("only", chosen.join(",")));
+  } else {
+    console.log("No interactive terminal detected.");
+  }
+
+  if (!chosen) {
+    console.log("Installing the CORE set. Customize with:");
+    console.log("  npx github:darkrei08/setup-ai --only pi,codex,opencode");
+    console.log("  npx github:darkrei08/setup-ai --all        (everything)");
+    console.log("  npx github:darkrei08/setup-ai --list       (see modules)\n");
+    chosen = defaultSelection();
   }
 
-  console.log("No TTY detected — installing the core module set. Use --only/--all to customize.");
-  return runScript(toScriptArgs("only", defaultSelection().join(",")));
+  if (!chosen.length) {
+    console.log("Nothing selected — exiting.");
+    process.exit(0);
+  }
+  return runScript(toScriptArgs("only", chosen.join(",")));
 }
 
-main();
+main().catch((err) => {
+  console.error(`setup-ai launcher error: ${err?.message || err}`);
+  process.exit(1);
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@darkrei08/setup-ai",
-  "version": "3.0.1",
+  "version": "3.0.3",
   "description": "Cross-OS installer for an AI coding toolchain (pi, codex, antigravity, opencode, herdr, gentle-ai, engram, Engineering Excellence) with an interactive module menu.",
   "type": "module",
   "bin": {

package/setup-ai.ps1

@@ -33,7 +33,15 @@ param(
 $ErrorActionPreference = 'Stop'
 Set-StrictMode -Version Latest
 
-$ScriptVersion = "3.0.1"
+# Render child-process UTF-8 output (npx skills box-drawing, banners) correctly
+# instead of mojibake on the default Windows console codepage.
+try {
+    [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+    $OutputEncoding = [System.Text.Encoding]::UTF8
+    if (Get-Command chcp -ErrorAction SilentlyContinue) { chcp 65001 | Out-Null }
+} catch { }
+
+$ScriptVersion = "3.0.3"
 $ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
 $LogDir = Join-Path $ScriptDir "logs"
 New-Item -ItemType Directory -Force -Path $LogDir | Out-Null
@@ -208,9 +216,10 @@ function Mod-Go {
 function Mod-Ee {
     Write-Log INFO "ee" "start" "Engineering Excellence"
     if (-not (Test-Cmd npx)) { Write-Log WARN "ee" "npx_missing" "npx not found; install node first"; return }
-    $agents = @{ pi = ".pi"; claude = ".claude"; gemini = ".gemini"; cursor = ".cursor"; antigravity = ".antigravity" }
+    # Keys are `skills` CLI agent names (claude-code, gemini-cli), not dir names.
+    $agents = @{ pi = ".pi"; 'claude-code' = ".claude"; 'gemini-cli' = ".gemini"; cursor = ".cursor"; antigravity = ".antigravity"; codex = ".codex"; opencode = ".config\opencode" }
     $any = $false
-    foreach ($a in @('pi','claude','gemini','cursor','antigravity')) {
+    foreach ($a in @('pi','claude-code','gemini-cli','cursor','antigravity','codex','opencode')) {
         if (Test-Path (Join-Path $HOME $agents[$a])) {
             Invoke-Step -Phase "ee" -Optional -Action {
                 npx --yes skills@latest add $EE_Slug --skill $EE_Skill --global --agent $a --copy --yes

package/setup-ai.sh

@@ -26,7 +26,7 @@
 set -Eeuo pipefail
 IFS=$'\n\t'
 
-SCRIPT_VERSION="3.0.1"
+SCRIPT_VERSION="3.0.3"
 
 SCRIPT_DIR="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd)"
 LOG_DIR="${SCRIPT_DIR}/logs"
@@ -602,16 +602,20 @@ mod_ee() {
 
     # Install the skill for every detected agent using the modern skills CLI
     # (replaces the old git-clone-and-move). Agents are detected by their config dir.
+    # Keys are the `skills` CLI agent names (claude-code, gemini-cli, ...), which
+    # differ from the config-dir basename; values are the dir we detect them by.
     local agent dir
     local -A agent_dir=(
         [pi]="${HOME}/.pi"
-        [claude]="${HOME}/.claude"
-        [gemini]="${HOME}/.gemini"
+        [claude-code]="${HOME}/.claude"
+        [gemini-cli]="${HOME}/.gemini"
         [cursor]="${HOME}/.cursor"
         [antigravity]="${HOME}/.antigravity"
+        [codex]="${HOME}/.codex"
+        [opencode]="${HOME}/.config/opencode"
     )
     local installed_any=0
-    for agent in pi claude gemini cursor antigravity; do
+    for agent in pi claude-code gemini-cli cursor antigravity codex opencode; do
         dir="${agent_dir[$agent]}"
         [[ -d "${dir}" ]] || continue
         run_optional "engineering-excellence" \