@supercorks/skills-installer 1.6.0 → 1.7.0

package/README.md

@@ -17,9 +17,8 @@ npx @supercorks/skills-installer install
 ## What it does
 
 1. **Choose installation path(s)** - Select one or more locations where skills should be installed:
-   - `.github/skills/` (GitHub Copilot default)
-   - `.agents/skills/` (Agent workspace skills)
-   - `/etc/codex/skills/` (System-level skills)
+   - `.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/', '.agents/skills/', '/etc/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)) {
@@ -227,7 +234,7 @@ async function runSkillsInstall() {
  */
 async function runSkillsInstallForTarget(skills, existingInstalls, target) {
   const { path: installPath, isExisting } = target;
-  const absoluteInstallPath = resolve(process.cwd(), installPath);
+  const absoluteInstallPath = resolveInstallPath(installPath);
 
   // Get currently installed skills if managing existing installation
   let installedSkills = [];
@@ -266,7 +273,7 @@ async function runSkillsInstallForTarget(skills, existingInstalls, target) {
 
   // 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);
   }
@@ -374,7 +381,7 @@ async function runSubagentsInstall() {
  */
 async function runSubagentsInstallForTarget(subagents, existingInstalls, target) {
   const { path: installPath, isExisting } = target;
-  const absoluteInstallPath = resolve(process.cwd(), installPath);
+  const absoluteInstallPath = resolveInstallPath(installPath);
 
   // Get currently installed subagents if managing existing installation
   let installedAgents = [];
@@ -413,7 +420,7 @@ async function runSubagentsInstallForTarget(subagents, existingInstalls, target)
 
   // 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,14 +7,14 @@ import * as readline from 'readline';
 
 const SKILL_PATH_CHOICES = {
   GITHUB: '.github/skills/',
-  AGENTS: '.agents/skills/',
-  ETC: '/etc/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__'
 };
@@ -80,15 +80,14 @@ export async function promptInstallPath(existingInstalls = []) {
   
   // Standard path options
   const standardPaths = [
-    SKILL_PATH_CHOICES.GITHUB,
-    SKILL_PATH_CHOICES.AGENTS,
-    SKILL_PATH_CHOICES.ETC,
-    SKILL_PATH_CHOICES.CLAUDE
+    { 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 });
+      choices.push({ name: label, value: path });
     }
   });
   
@@ -163,11 +162,15 @@ export async function promptAgentInstallPath(existingInstalls = []) {
   }
   
   // Standard path options
-  const standardPaths = [AGENT_PATH_CHOICES.GITHUB, AGENT_PATH_CHOICES.CLAUDE];
+  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 });
+      choices.push({ name: label, value: path });
     }
   });
   

package/package.json

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