@yukioa2z/visa-apply 3.0.2 → 3.0.3

package/README.md

@@ -4,7 +4,11 @@ Research, prepare, review, and track visa applications with current official sou
 
 [Website](https://yukioa2z.github.io/visa-apply/) · [Source](https://github.com/Yukioa2z/visa-apply)
 
-Install into your agent's skills directory with `--dest`:
+```sh
+npx @yukioa2z/visa-apply
+```
+
+Run in a terminal and pick your agent when prompted. To skip the prompt, pass your agent's skills directory:
 
 ```sh
 npx @yukioa2z/visa-apply -- --dest ~/.claude/skills   # Claude Code

package/bin/install.js

@@ -3,21 +3,32 @@
 const fs = require("fs");
 const os = require("os");
 const path = require("path");
+const readline = require("readline");
 
 const skillName = "visa-apply";
 const packageRoot = path.resolve(__dirname, "..");
 const sourceDir = path.join(packageRoot, "skill");
 
+// Known agents and the skills directory each one scans.
+const AGENTS = [
+  { label: "Claude Code", dir: "~/.claude/skills" },
+  { label: "Codex", dir: "~/.codex/skills" },
+];
+
 function usage() {
+  const lines = AGENTS.map(
+    (a) => `  ${a.label.padEnd(13)} npx @yukioa2z/visa-apply -- --dest ${a.dir}`
+  ).join("\n");
   console.log(`Install ${skillName}
 
-Choose where to install with --dest — your agent's skills directory:
-  Claude Code   npx @yukioa2z/visa-apply -- --dest ~/.claude/skills
-  Codex         npx @yukioa2z/visa-apply -- --dest ~/.codex/skills
+Pick your agent's skills directory with --dest:
+${lines}
   Other agent   npx @yukioa2z/visa-apply -- --dest <your agent's skills dir>
 
+Run with no --dest in a terminal to choose interactively.
+
 Options:
-  --dest <path>   Skill root directory (required).
+  --dest <path>   Skill root directory.
   --dry-run       Print the destination without copying files.
   --help          Show this help message.
 `);
@@ -37,37 +48,75 @@ function readOption(name) {
   return args[index + 1];
 }
 
-const args = process.argv.slice(2);
-if (args.includes("--help") || args.includes("-h")) {
-  usage();
-  process.exit(0);
+function install(destRoot, dryRun) {
+  const destDir = path.join(destRoot, skillName);
+  if (dryRun) {
+    console.log(destDir);
+    return;
+  }
+  fs.mkdirSync(destRoot, { recursive: true });
+  fs.rmSync(destDir, { recursive: true, force: true });
+  fs.cpSync(sourceDir, destDir, { recursive: true });
+  console.log(`Installed ${skillName} to ${destDir}`);
+  console.log(
+    `Try: Use $${skillName} to check your visa need and prepare an application dossier.`
+  );
 }
 
-if (!fs.existsSync(sourceDir)) {
-  console.error(`Skill source not found: ${sourceDir}`);
-  process.exit(1);
+function promptAgent() {
+  return new Promise((resolve) => {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    console.log("Which agent are you installing for?\n");
+    AGENTS.forEach((a, i) => console.log(`  ${i + 1}) ${a.label}  (${a.dir})`));
+    console.log(`  ${AGENTS.length + 1}) Other  (enter a path)\n`);
+    rl.question("Choice: ", (answer) => {
+      rl.close();
+      const n = parseInt(answer.trim(), 10);
+      if (n >= 1 && n <= AGENTS.length) {
+        resolve(AGENTS[n - 1].dir);
+      } else if (n === AGENTS.length + 1) {
+        const rl2 = readline.createInterface({ input: process.stdin, output: process.stdout });
+        rl2.question("Skills directory path: ", (p) => {
+          rl2.close();
+          resolve(p.trim() || null);
+        });
+      } else {
+        resolve(null);
+      }
+    });
+  });
 }
 
-const destOption = readOption("--dest");
-if (!destOption) {
-  console.error(
-    "No --dest given. Install into your agent's skills directory:\n"
-  );
-  usage();
-  process.exit(1);
-}
+async function main() {
+  const args = process.argv.slice(2);
+  if (args.includes("--help") || args.includes("-h")) {
+    usage();
+    return;
+  }
+  if (!fs.existsSync(sourceDir)) {
+    console.error(`Skill source not found: ${sourceDir}`);
+    process.exitCode = 1;
+    return;
+  }
 
-const destRoot = path.resolve(expandHome(destOption));
-const destDir = path.join(destRoot, skillName);
+  const dryRun = args.includes("--dry-run");
+  let dest = readOption("--dest");
 
-if (args.includes("--dry-run")) {
-  console.log(destDir);
-  process.exit(0);
-}
+  if (!dest) {
+    // No target given. Ask interactively when attached to a terminal;
+    // otherwise (agent/CI) print guidance and exit without guessing.
+    if (process.stdin.isTTY && process.stdout.isTTY) {
+      dest = await promptAgent();
+    }
+    if (!dest) {
+      console.error("No skills directory chosen.\n");
+      usage();
+      process.exitCode = 1;
+      return;
+    }
+  }
 
-fs.mkdirSync(destRoot, { recursive: true });
-fs.rmSync(destDir, { recursive: true, force: true });
-fs.cpSync(sourceDir, destDir, { recursive: true });
+  install(path.resolve(expandHome(dest)), dryRun);
+}
 
-console.log(`Installed ${skillName} to ${destDir}`);
-console.log(`Try: Use $${skillName} to check your visa need and prepare an application dossier.`);
+main();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yukioa2z/visa-apply",
-  "version": "3.0.2",
+  "version": "3.0.3",
   "description": "Install a global visa-need research and application filing skill.",
   "license": "MIT",
   "keywords": [