@supercorks/skills-installer 1.5.0 → 1.7.0

package/README.md

@@ -16,9 +16,9 @@ npx @supercorks/skills-installer install
 
 ## What it does
 
-1. **Choose installation path** - Select where skills should be installed:
-   - `.github/skills/` (GitHub Copilot default)
-   - `.codex/skills/` (Codex)
+1. **Choose installation path(s)** - Select one or more locations where skills should be installed:
+   - `.github/skills/` (Copilot)
+   - `~/.codex/skills/` (Codex)
    - `.claude/skills/` (Claude)
    - Custom path of your choice
 

package/bin/install.js

@@ -9,6 +9,7 @@
 
 import { existsSync, appendFileSync, readFileSync, writeFileSync } from 'fs';
 import { resolve, join } from 'path';
+import { homedir } from 'os';
 import { 
   promptInstallType,
   promptInstallPath,
@@ -40,8 +41,14 @@ const require = createRequire(import.meta.url);
 const { version: VERSION } = require('../package.json');
 
 // Common installation paths to check for existing installations
-const SKILL_PATHS = ['.github/skills/', '.codex/skills/', '.claude/skills/'];
-const AGENT_PATHS = ['.github/agents/', '.claude/agents/'];
+const SKILL_PATHS = ['.github/skills/', '~/.codex/skills/', '.claude/skills/'];
+const AGENT_PATHS = ['.github/agents/', '.agents/agents/', '.claude/agents/'];
+
+function resolveInstallPath(path) {
+  if (path === '~') return homedir();
+  if (path.startsWith('~/')) return resolve(homedir(), path.slice(2));
+  return resolve(process.cwd(), path);
+}
 
 /**
  * Detect existing skill installations in common paths
@@ -51,7 +58,7 @@ async function detectExistingSkillInstallations() {
   const installations = [];
   
   for (const path of SKILL_PATHS) {
-    const absolutePath = resolve(process.cwd(), path);
+    const absolutePath = resolveInstallPath(path);
     const gitDir = join(absolutePath, '.git');
     
     if (existsSync(gitDir)) {
@@ -79,7 +86,7 @@ async function detectExistingAgentInstallations() {
   const installations = [];
   
   for (const path of AGENT_PATHS) {
-    const absolutePath = resolve(process.cwd(), path);
+    const absolutePath = resolveInstallPath(path);
     const gitDir = join(absolutePath, '.git');
     
     if (existsSync(gitDir)) {
@@ -208,8 +215,26 @@ async function runSkillsInstall() {
   const existingInstalls = await detectExistingSkillInstallations();
 
   // Ask where to install (showing existing installations if any)
-  const { path: installPath, isExisting } = await promptInstallPath(existingInstalls);
-  const absoluteInstallPath = resolve(process.cwd(), installPath);
+  const installTargets = await promptInstallPath(existingInstalls);
+
+  for (let i = 0; i < installTargets.length; i++) {
+    const target = installTargets[i];
+    if (installTargets.length > 1) {
+      console.log(`\n📍 Skills target ${i + 1}/${installTargets.length}: ${target.path}`);
+    }
+    await runSkillsInstallForTarget(skills, existingInstalls, target);
+  }
+}
+
+/**
+ * Install/update skills for a specific target path
+ * @param {Array<{name: string, description: string, folder: string}>} skills
+ * @param {Array<{path: string, skillCount: number, skills: string[]}>} existingInstalls
+ * @param {{path: string, isExisting: boolean}} target
+ */
+async function runSkillsInstallForTarget(skills, existingInstalls, target) {
+  const { path: installPath, isExisting } = target;
+  const absoluteInstallPath = resolveInstallPath(installPath);
 
   // Get currently installed skills if managing existing installation
   let installedSkills = [];
@@ -248,7 +273,7 @@ async function runSkillsInstall() {
 
   // Ask about .gitignore (only for fresh installs and if not already in .gitignore)
   let shouldGitignore = false;
-  const gitignorePath = resolve(process.cwd(), '.gitignore');
+  const gitignorePath = resolveInstallPath('.gitignore');
   if (!isManageMode && !isInGitignore(gitignorePath, installPath)) {
     shouldGitignore = await promptGitignore(installPath);
   }
@@ -337,8 +362,26 @@ async function runSubagentsInstall() {
   const existingInstalls = await detectExistingAgentInstallations();
 
   // Ask where to install (showing existing installations if any)
-  const { path: installPath, isExisting } = await promptAgentInstallPath(existingInstalls);
-  const absoluteInstallPath = resolve(process.cwd(), installPath);
+  const installTargets = await promptAgentInstallPath(existingInstalls);
+
+  for (let i = 0; i < installTargets.length; i++) {
+    const target = installTargets[i];
+    if (installTargets.length > 1) {
+      console.log(`\n📍 Subagents target ${i + 1}/${installTargets.length}: ${target.path}`);
+    }
+    await runSubagentsInstallForTarget(subagents, existingInstalls, target);
+  }
+}
+
+/**
+ * Install/update subagents for a specific target path
+ * @param {Array<{name: string, description: string, filename: string}>} subagents
+ * @param {Array<{path: string, agentCount: number, agents: string[]}>} existingInstalls
+ * @param {{path: string, isExisting: boolean}} target
+ */
+async function runSubagentsInstallForTarget(subagents, existingInstalls, target) {
+  const { path: installPath, isExisting } = target;
+  const absoluteInstallPath = resolveInstallPath(installPath);
 
   // Get currently installed subagents if managing existing installation
   let installedAgents = [];
@@ -377,7 +420,7 @@ async function runSubagentsInstall() {
 
   // Ask about .gitignore (only for fresh installs and if not already in .gitignore)
   let shouldGitignore = false;
-  const gitignorePath = resolve(process.cwd(), '.gitignore');
+  const gitignorePath = resolveInstallPath('.gitignore');
   if (!isManageMode && !isInGitignore(gitignorePath, installPath)) {
     shouldGitignore = await promptGitignore(installPath);
   }

package/lib/git.js

@@ -3,7 +3,7 @@
  */
 
 import { execSync, spawn } from 'child_process';
-import { existsSync, mkdirSync, rmSync, writeFileSync, readFileSync, appendFileSync } from 'fs';
+import { existsSync, mkdirSync, rmSync, writeFileSync, readFileSync, appendFileSync, readdirSync } from 'fs';
 import { join, resolve } from 'path';
 import { getRepoUrl } from './skills.js';
 import { getSubagentsRepoUrl } from './subagents.js';
@@ -71,6 +71,10 @@ export async function sparseCloneSkills(targetPath, skillFolders, onProgress = (
     if (existsSync(gitDir)) {
       throw new Error(`Directory "${targetPath}" already contains a git repository. Please remove it first or choose a different path.`);
     }
+    const entries = readdirSync(absolutePath).filter(name => name !== '.DS_Store');
+    if (entries.length > 0) {
+      throw new Error(`Directory "${targetPath}" already exists and is not empty. Choose an empty directory or an existing managed installation.`);
+    }
   }
 
   // Create target directory
@@ -328,6 +332,10 @@ export async function sparseCloneSubagents(targetPath, agentFilenames, onProgres
     if (existsSync(gitDir)) {
       throw new Error(`Directory "${targetPath}" already contains a git repository. Please remove it first or choose a different path.`);
     }
+    const entries = readdirSync(absolutePath).filter(name => name !== '.DS_Store');
+    if (entries.length > 0) {
+      throw new Error(`Directory "${targetPath}" already exists and is not empty. Choose an empty directory or an existing managed installation.`);
+    }
   }
 
   // Create target directory

package/lib/prompts.js

@@ -7,13 +7,14 @@ import * as readline from 'readline';
 
 const SKILL_PATH_CHOICES = {
   GITHUB: '.github/skills/',
-  CODEX: '.codex/skills/',
+  CODEX_HOME: '~/.codex/skills/',
   CLAUDE: '.claude/skills/',
   CUSTOM: '__custom__'
 };
 
 const AGENT_PATH_CHOICES = {
   GITHUB: '.github/agents/',
+  CODEX: '.agents/agents/',
   CLAUDE: '.claude/agents/',
   CUSTOM: '__custom__'
 };
@@ -58,48 +59,67 @@ export async function promptInstallType() {
 }
 
 /**
- * Prompt user to select installation path, showing existing installations
+ * Prompt user to select one or more installation paths, showing existing installations
  * @param {Array<{path: string, skillCount: number}>} existingInstalls - Detected existing installations
- * @returns {Promise<{path: string, isExisting: boolean}>} The selected path and whether it's existing
+ * @returns {Promise<Array<{path: string, isExisting: boolean}>>} Selected paths and whether each is existing
  */
 export async function promptInstallPath(existingInstalls = []) {
   const choices = [];
+  const existingPaths = existingInstalls.map(i => i.path);
   
   // Add existing installations at the top
   if (existingInstalls.length > 0) {
     existingInstalls.forEach(install => {
       choices.push({
         name: `${install.path} (${install.skillCount} skill${install.skillCount !== 1 ? 's' : ''} installed)`,
-        value: { path: install.path, isExisting: true }
+        value: install.path
       });
     });
     choices.push(new inquirer.Separator('── New installation ──'));
   }
   
   // Standard path options
-  const standardPaths = [SKILL_PATH_CHOICES.GITHUB, SKILL_PATH_CHOICES.CODEX, SKILL_PATH_CHOICES.CLAUDE];
-  const existingPaths = existingInstalls.map(i => i.path);
+  const standardPaths = [
+    { path: SKILL_PATH_CHOICES.GITHUB, label: `${SKILL_PATH_CHOICES.GITHUB} (Copilot)` },
+    { path: SKILL_PATH_CHOICES.CODEX_HOME, label: `${SKILL_PATH_CHOICES.CODEX_HOME} (Codex)` },
+    { path: SKILL_PATH_CHOICES.CLAUDE, label: `${SKILL_PATH_CHOICES.CLAUDE} (Claude)` }
+  ];
   
-  standardPaths.forEach(path => {
+  standardPaths.forEach(({ path, label }) => {
     if (!existingPaths.includes(path)) {
-      choices.push({ name: path, value: { path, isExisting: false } });
+      choices.push({ name: label, value: path });
     }
   });
   
-  choices.push({ name: 'Custom path...', value: { path: SKILL_PATH_CHOICES.CUSTOM, isExisting: false } });
+  choices.push({ name: 'Custom path...', value: SKILL_PATH_CHOICES.CUSTOM });
 
-  const { pathChoice } = await inquirer.prompt([
+  const { pathChoices } = await inquirer.prompt([
     {
-      type: 'list',
-      name: 'pathChoice',
+      type: 'checkbox',
+      name: 'pathChoices',
       message: existingInstalls.length > 0 
-        ? 'Select an existing installation to manage, or choose a new location:'
-        : 'Where would you like to install the skills?',
-      choices
+        ? 'Select one or more installations to manage, or choose new locations:'
+        : 'Where would you like to install the skills? (Select one or more)',
+      choices,
+      validate: (input) => {
+        if (!input || input.length === 0) {
+          return 'Please select at least one installation path';
+        }
+        return true;
+      }
     }
   ]);
 
-  if (pathChoice.path === SKILL_PATH_CHOICES.CUSTOM) {
+  const selected = [];
+  const selectedSet = new Set(pathChoices);
+
+  pathChoices
+    .filter(path => path !== SKILL_PATH_CHOICES.CUSTOM)
+    .forEach(path => {
+      selected.push({ path, isExisting: existingPaths.includes(path) });
+    });
+
+  if (selectedSet.has(SKILL_PATH_CHOICES.CUSTOM)) {
     const { customPath } = await inquirer.prompt([
       {
         type: 'input',
@@ -113,55 +133,76 @@ export async function promptInstallPath(existingInstalls = []) {
         }
       }
     ]);
-    return { path: customPath.trim(), isExisting: false };
+    selected.push({ path: customPath.trim(), isExisting: false });
   }
 
-  return pathChoice;
+  const deduped = new Map();
+  selected.forEach(entry => deduped.set(entry.path, entry));
+  return Array.from(deduped.values());
 }
 
 /**
- * Prompt user to select subagent installation path
+ * Prompt user to select one or more subagent installation paths
  * @param {Array<{path: string, agentCount: number}>} existingInstalls - Detected existing installations
- * @returns {Promise<{path: string, isExisting: boolean}>} The selected path and whether it's existing
+ * @returns {Promise<Array<{path: string, isExisting: boolean}>>} Selected paths and whether each is existing
  */
 export async function promptAgentInstallPath(existingInstalls = []) {
   const choices = [];
+  const existingPaths = existingInstalls.map(i => i.path);
   
   // Add existing installations at the top
   if (existingInstalls.length > 0) {
     existingInstalls.forEach(install => {
       choices.push({
         name: `${install.path} (${install.agentCount} agent${install.agentCount !== 1 ? 's' : ''} installed)`,
-        value: { path: install.path, isExisting: true }
+        value: install.path
       });
     });
     choices.push(new inquirer.Separator('── New installation ──'));
   }
   
   // Standard path options
-  const standardPaths = [AGENT_PATH_CHOICES.GITHUB, AGENT_PATH_CHOICES.CLAUDE];
-  const existingPaths = existingInstalls.map(i => i.path);
+  const standardPaths = [
+    { path: AGENT_PATH_CHOICES.GITHUB, label: `${AGENT_PATH_CHOICES.GITHUB} (Copilot)` },
+    { path: AGENT_PATH_CHOICES.CODEX, label: `${AGENT_PATH_CHOICES.CODEX} (Codex)` },
+    { path: AGENT_PATH_CHOICES.CLAUDE, label: `${AGENT_PATH_CHOICES.CLAUDE} (Claude)` }
+  ];
   
-  standardPaths.forEach(path => {
+  standardPaths.forEach(({ path, label }) => {
     if (!existingPaths.includes(path)) {
-      choices.push({ name: path, value: { path, isExisting: false } });
+      choices.push({ name: label, value: path });
     }
   });
   
-  choices.push({ name: 'Custom path...', value: { path: AGENT_PATH_CHOICES.CUSTOM, isExisting: false } });
+  choices.push({ name: 'Custom path...', value: AGENT_PATH_CHOICES.CUSTOM });
 
-  const { pathChoice } = await inquirer.prompt([
+  const { pathChoices } = await inquirer.prompt([
     {
-      type: 'list',
-      name: 'pathChoice',
+      type: 'checkbox',
+      name: 'pathChoices',
       message: existingInstalls.length > 0 
-        ? 'Select an existing installation to manage, or choose a new location:'
-        : 'Where would you like to install the subagents?',
-      choices
+        ? 'Select one or more installations to manage, or choose new locations:'
+        : 'Where would you like to install the subagents? (Select one or more)',
+      choices,
+      validate: (input) => {
+        if (!input || input.length === 0) {
+          return 'Please select at least one installation path';
+        }
+        return true;
+      }
     }
   ]);
 
-  if (pathChoice.path === AGENT_PATH_CHOICES.CUSTOM) {
+  const selected = [];
+  const selectedSet = new Set(pathChoices);
+
+  pathChoices
+    .filter(path => path !== AGENT_PATH_CHOICES.CUSTOM)
+    .forEach(path => {
+      selected.push({ path, isExisting: existingPaths.includes(path) });
+    });
+
+  if (selectedSet.has(AGENT_PATH_CHOICES.CUSTOM)) {
     const { customPath } = await inquirer.prompt([
       {
         type: 'input',
@@ -175,10 +216,12 @@ export async function promptAgentInstallPath(existingInstalls = []) {
         }
       }
     ]);
-    return { path: customPath.trim(), isExisting: false };
+    selected.push({ path: customPath.trim(), isExisting: false });
   }
 
-  return pathChoice;
+  const deduped = new Map();
+  selected.forEach(entry => deduped.set(entry.path, entry));
+  return Array.from(deduped.values());
 }
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supercorks/skills-installer",
-  "version": "1.5.0",
+  "version": "1.7.0",
   "description": "Interactive CLI installer for AI agent skills and subagents",
   "type": "module",
   "bin": {