skill-linker 3.0.8 → 4.0.4

package/src/commands/list.js

@@ -1,78 +1,155 @@
-const chalk = require('chalk');
-const prompts = require('prompts');
-const path = require('path');
-const { findRepos, listDirectories, dirExists } = require('../utils/file-system');
-const { DEFAULT_LIB_PATH } = require('../utils/git');
+const chalk = require("chalk");
+const path = require("path");
+const {
+  findRepos,
+  listDirectories,
+  dirExists,
+} = require("../utils/file-system");
+const { DEFAULT_LIB_PATH } = require("../utils/git");
 
 /**
- * List command - shows repos, then skills within selected repo
+ * List command - shows repos and skills (CLI mode only)
+ * @param {Object} options - Command options
+ * @param {string} [options.repo] - Repository name to list
+ * @param {boolean} [options.json] - Output as JSON
  */
-async function list() {
-    if (!dirExists(DEFAULT_LIB_PATH)) {
-        console.error(chalk.red('[ERROR]'), `Skill library not found: ${DEFAULT_LIB_PATH}`);
-        console.log(chalk.blue('[INFO]'), 'Use --from <github_url> to clone skills first.');
-        process.exit(1);
-    }
+async function list(options = {}) {
+  const repoName = options.repo;
+  const outputJson = options.json || false;
 
-    const repos = findRepos(DEFAULT_LIB_PATH);
+  if (!dirExists(DEFAULT_LIB_PATH)) {
+    console.error(
+      chalk.red("[ERROR]"),
+      `Skill library not found: ${DEFAULT_LIB_PATH}`,
+    );
+    console.log(
+      chalk.blue("[INFO]"),
+      "Use --from <github_url> to clone skills first.",
+    );
+    process.exit(1);
+  }
 
-    if (repos.length === 0) {
-        console.log(chalk.yellow('[WARNING]'), `No repos found in ${DEFAULT_LIB_PATH}`);
-        console.log(chalk.blue('[INFO]'), 'Use --from <github_url> to clone skills first.');
-        return;
-    }
+  const repos = findRepos(DEFAULT_LIB_PATH);
 
-    console.log('');
-    console.log(chalk.blue('[INFO]'), `Repositories in library (${DEFAULT_LIB_PATH}):`);
-    console.log('');
-
-    // Show repos with indication if they have skills/ directory
-    const { selectedRepo } = await prompts({
-        type: 'select',
-        name: 'selectedRepo',
-        message: 'Select a repository to view:',
-        choices: repos.map(repo => ({
-            title: `${repo.name}${repo.hasSkillsDir ? chalk.dim(' (has skills/)') : ''}`,
-            value: repo,
-            description: repo.path
-        }))
-    });
+  if (repos.length === 0) {
+    console.log(
+      chalk.yellow("[WARNING]"),
+      `No repos found in ${DEFAULT_LIB_PATH}`,
+    );
+    console.log(
+      chalk.blue("[INFO]"),
+      "Use --from <github_url> to clone skills first.",
+    );
+    return;
+  }
+
+  // CLI mode: use provided repo name
+  if (repoName) {
+    const selectedRepo = repos.find(
+      (r) => r.name.toLowerCase() === repoName.toLowerCase(),
+    );
 
     if (!selectedRepo) {
-        console.log(chalk.yellow('[INFO]'), 'No repository selected.');
-        return;
+      console.error(chalk.red("[ERROR]"), `Repository not found: ${repoName}`);
+      console.log(
+        chalk.blue("[INFO]"),
+        "Available repos:",
+        repos.map((r) => r.name).join(", "),
+      );
+      process.exit(1);
     }
 
-    console.log('');
-    console.log(chalk.blue('[INFO]'), `Repository: ${chalk.cyan(selectedRepo.name)}`);
-    console.log(chalk.dim(`Path: ${selectedRepo.path}`));
-    console.log('');
+    if (outputJson) {
+      const skills = selectedRepo.hasSkillsDir
+        ? listDirectories(path.join(selectedRepo.path, "skills"))
+        : [];
+      console.log(
+        JSON.stringify(
+          {
+            name: selectedRepo.name,
+            path: selectedRepo.path,
+            hasSkillsDir: selectedRepo.hasSkillsDir,
+            skills: skills,
+          },
+          null,
+          2,
+        ),
+      );
+    } else {
+      console.log("");
+      console.log(
+        chalk.blue("[INFO]"),
+        `Repository: ${chalk.cyan(selectedRepo.name)}`,
+      );
+      console.log(chalk.dim(`Path: ${selectedRepo.path}`));
+      console.log("");
 
-    // If repo has skills/ subdirectory, list the skills
-    if (selectedRepo.hasSkillsDir) {
-        const skillsDir = path.join(selectedRepo.path, 'skills');
+      if (selectedRepo.hasSkillsDir) {
+        const skillsDir = path.join(selectedRepo.path, "skills");
         const skills = listDirectories(skillsDir);
 
         if (skills.length === 0) {
-            console.log(chalk.yellow('[WARNING]'), 'No skills found in skills/ directory');
-            return;
+          console.log(
+            chalk.yellow("[WARNING]"),
+            "No skills found in skills/ directory",
+          );
+          return;
         }
 
-        console.log(chalk.blue('[INFO]'), 'Skills in this repository:');
-        console.log('');
+        console.log(chalk.blue("[INFO]"), "Skills in this repository:");
+        console.log("");
 
         skills.forEach((skill, index) => {
-            console.log(`  ${index + 1}. ${chalk.cyan(skill)}`);
-            console.log(`     ${chalk.dim(path.join(skillsDir, skill))}`);
+          console.log(`  ${index + 1}. ${chalk.cyan(skill)}`);
+          console.log(`     ${chalk.dim(path.join(skillsDir, skill))}`);
         });
 
-        console.log('');
-    } else {
-        console.log(chalk.blue('[INFO]'), 'This is a single-skill repository (no skills/ subdirectory)');
-        console.log(chalk.dim('The entire repository acts as one skill'));
-        console.log('');
+        console.log("");
+      } else {
+        console.log(
+          chalk.blue("[INFO]"),
+          "This is a single-skill repository (no skills/ subdirectory)",
+        );
+        console.log(chalk.dim("The entire repository acts as one skill"));
+        console.log("");
+      }
     }
+    return;
+  }
+
+  // No repo specified - list all repos
+  if (outputJson) {
+    console.log(
+      JSON.stringify(
+        repos.map((repo) => ({
+          name: repo.name,
+          path: repo.path,
+          hasSkillsDir: repo.hasSkillsDir,
+        })),
+        null,
+        2,
+      ),
+    );
+  } else {
+    console.log("");
+    console.log(
+      chalk.blue("[INFO]"),
+      `Repositories in library (${DEFAULT_LIB_PATH}):`,
+    );
+    console.log("");
+
+    repos.forEach((repo, index) => {
+      const hasSkills = repo.hasSkillsDir ? chalk.dim(" (has skills/)") : "";
+      console.log(`  ${index + 1}. ${chalk.cyan(repo.name)}${hasSkills}`);
+      console.log(`     ${chalk.dim(repo.path)}`);
+    });
+
+    console.log("");
+    console.log(
+      chalk.blue("[INFO]"),
+      "Use --repo <name> to list skills in a specific repo.",
+    );
+  }
 }
 
 module.exports = list;
-

package/src/utils/agents.js

@@ -1,69 +1,93 @@
-const fs = require('fs');
-const path = require('path');
-const os = require('os');
+const fs = require("fs");
+const path = require("path");
+const os = require("os");
 
 /**
  * Supported AI Agent configurations
- * Format: { name, projectDir, globalDir }
+ * Format: { name, projectDir, globalDir, aliases }
  */
 const AGENTS = [
-    {
-        name: 'Claude Code',
-        projectDir: '.claude/skills',
-        globalDir: path.join(os.homedir(), '.claude/skills')
-    },
-    {
-        name: 'GitHub Copilot',
-        projectDir: '.github/skills',
-        globalDir: path.join(os.homedir(), '.copilot/skills')
-    },
-    {
-        name: 'Google Antigravity',
-        projectDir: '.agent/skills',
-        globalDir: path.join(os.homedir(), '.gemini/antigravity/skills')
-    },
-    {
-        name: 'Cursor',
-        projectDir: '.cursor/skills',
-        globalDir: path.join(os.homedir(), '.cursor/skills')
-    },
-    {
-        name: 'OpenCode',
-        projectDir: '.opencode/skill',
-        globalDir: path.join(os.homedir(), '.config/opencode/skill')
-    },
-    {
-        name: 'OpenAI Codex',
-        projectDir: '.codex/skills',
-        globalDir: path.join(os.homedir(), '.codex/skills')
-    },
-    {
-        name: 'Gemini CLI',
-        projectDir: '.gemini/skills',
-        globalDir: path.join(os.homedir(), '.gemini/skills')
-    },
-    {
-        name: 'Windsurf',
-        projectDir: '.windsurf/skills',
-        globalDir: path.join(os.homedir(), '.codeium/windsurf/skills')
-    }
+  {
+    name: "Claude Code",
+    projectDir: ".claude/skills",
+    globalDir: path.join(os.homedir(), ".claude/skills"),
+    aliases: ["claude", "claude-code", "anthropic"],
+  },
+  {
+    name: "GitHub Copilot",
+    projectDir: ".github/skills",
+    globalDir: path.join(os.homedir(), ".copilot/skills"),
+    aliases: ["copilot", "github", "gh-copilot"],
+  },
+  {
+    name: "Google Antigravity",
+    projectDir: ".agent/skills",
+    globalDir: path.join(os.homedir(), ".gemini/antigravity/skills"),
+    aliases: ["antigravity", "gemini-antigravity"],
+  },
+  {
+    name: "Cursor",
+    projectDir: ".cursor/skills",
+    globalDir: path.join(os.homedir(), ".cursor/skills"),
+    aliases: ["cursor"],
+  },
+  {
+    name: "OpenCode",
+    projectDir: ".opencode/skills",
+    globalDir: path.join(os.homedir(), ".config/opencode/skills"),
+    aliases: ["opencode", "open-code"],
+  },
+  {
+    name: "OpenAI Codex",
+    projectDir: ".codex/skills",
+    globalDir: path.join(os.homedir(), ".codex/skills"),
+    aliases: ["codex", "openai", "openai-codex"],
+  },
+  {
+    name: "Gemini CLI",
+    projectDir: ".gemini/skills",
+    globalDir: path.join(os.homedir(), ".gemini/skills"),
+    aliases: ["gemini", "gemini-cli", "google-gemini"],
+  },
+  {
+    name: "Windsurf",
+    projectDir: ".windsurf/skills",
+    globalDir: path.join(os.homedir(), ".codeium/windsurf/skills"),
+    aliases: ["windsurf", "codeium"],
+  },
 ];
 
+/**
+ * Find agent index by name or alias (case-insensitive)
+ * @param {string} name - Agent name or alias
+ * @returns {number|null} Agent index or null if not found
+ */
+function findAgentIndex(nameOrAlias) {
+  const lower = nameOrAlias.toLowerCase();
+  const idx = AGENTS.findIndex(
+    (agent) =>
+      agent.name.toLowerCase() === lower ||
+      (agent.aliases &&
+        agent.aliases.some((alias) => alias.toLowerCase() === lower)),
+  );
+  return idx !== -1 ? idx : null;
+}
+
 /**
  * Detect which agents are installed on the system
  * @returns {Array} List of detected agent indices
  */
 function detectInstalledAgents() {
-    const installed = [];
+  const installed = [];
 
-    AGENTS.forEach((agent, index) => {
-        // Check if global directory exists
-        if (fs.existsSync(agent.globalDir)) {
-            installed.push(index);
-        }
-    });
+  AGENTS.forEach((agent, index) => {
+    // Check if global directory exists
+    if (fs.existsSync(agent.globalDir)) {
+      installed.push(index);
+    }
+  });
 
-    return installed;
+  return installed;
 }
 
 /**
@@ -72,7 +96,7 @@ function detectInstalledAgents() {
  * @returns {Object} Agent configuration
  */
 function getAgent(index) {
-    return AGENTS[index];
+  return AGENTS[index];
 }
 
 /**
@@ -80,12 +104,13 @@ function getAgent(index) {
  * @returns {Array} All agent configurations
  */
 function getAllAgents() {
-    return AGENTS;
+  return AGENTS;
 }
 
 module.exports = {
-    AGENTS,
-    detectInstalledAgents,
-    getAgent,
-    getAllAgents
+  AGENTS,
+  detectInstalledAgents,
+  getAgent,
+  getAllAgents,
+  findAgentIndex,
 };

package/src/utils/git.js

@@ -1,9 +1,9 @@
-const execa = require('execa');
-const path = require('path');
-const os = require('os');
-const { dirExists } = require('./file-system');
+const execa = require("execa");
+const path = require("path");
+const os = require("os");
+const { dirExists } = require("./file-system");
 
-const DEFAULT_LIB_PATH = path.join(os.homedir(), 'Documents/AgentSkills');
+const DEFAULT_LIB_PATH = path.join(os.homedir(), "Documents/AgentSkills");
 
 /**
  * Parse GitHub URL to extract owner, repo, branch, and subpath
@@ -11,46 +11,50 @@ const DEFAULT_LIB_PATH = path.join(os.homedir(), 'Documents/AgentSkills');
  * @returns {Object} Parsed components
  */
 function parseGitHubUrl(url) {
-    let cleanUrl = url;
-    let subpath = '';
-    let branch = 'main';
+  let cleanUrl = url;
+  let subpath = "";
+  let branch = "main";
 
-    // Check for /tree/branch/path format
-    const treeMatch = url.match(/(.+)\/tree\/([^/]+)\/(.+)$/);
-    if (treeMatch) {
-        cleanUrl = treeMatch[1];
-        branch = treeMatch[2];
-        subpath = treeMatch[3];
-    }
+  // Check for /tree/branch/path format
+  const treeMatch = url.match(/(.+)\/tree\/([^/]+)\/(.+)$/);
+  if (treeMatch) {
+    cleanUrl = treeMatch[1];
+    branch = treeMatch[2];
+    subpath = treeMatch[3];
+  }
 
-    // Extract owner/repo
-    const repoMatch = cleanUrl.match(/github\.com[/:]([^/]+)\/([^/]+?)(\.git)?$/);
+  // Extract owner/repo
+  const repoMatch = cleanUrl.match(/github\.com[/:]([^/]+)\/([^/]+?)(\.git)?$/);
 
-    if (!repoMatch) {
-        throw new Error('Invalid GitHub URL format');
-    }
+  if (!repoMatch) {
+    throw new Error("Invalid GitHub URL format");
+  }
 
-    return {
-        owner: repoMatch[1],
-        repo: repoMatch[2].replace('.git', ''),
-        branch,
-        subpath,
-        cleanUrl
-    };
+  return {
+    owner: repoMatch[1],
+    repo: repoMatch[2].replace(".git", ""),
+    branch,
+    subpath,
+    cleanUrl,
+  };
 }
 
 /**
  * Clone a GitHub repository
  * @param {string} url - GitHub URL
  * @param {string} targetPath - Target directory
+ * @param {boolean} shallow - Use shallow clone (default true)
  * @returns {Promise<void>}
  */
-async function cloneRepo(url, targetPath) {
-    try {
-        await execa('git', ['clone', url, targetPath]);
-    } catch (error) {
-        throw new Error(`Failed to clone repository: ${error.message}`);
-    }
+async function cloneRepo(url, targetPath, shallow = true) {
+  try {
+    const args = shallow
+      ? ["clone", "--depth", "1", url, targetPath]
+      : ["clone", url, targetPath];
+    await execa("git", args);
+  } catch (error) {
+    throw new Error(`Failed to clone repository: ${error.message}`);
+  }
 }
 
 /**
@@ -59,11 +63,11 @@ async function cloneRepo(url, targetPath) {
  * @returns {Promise<void>}
  */
 async function pullRepo(repoPath) {
-    try {
-        await execa('git', ['-C', repoPath, 'pull']);
-    } catch (error) {
-        throw new Error(`Failed to pull repository: ${error.message}`);
-    }
+  try {
+    await execa("git", ["-C", repoPath, "pull", "--rebase"]);
+  } catch (error) {
+    throw new Error(`Failed to pull repository: ${error.message}`);
+  }
 }
 
 /**
@@ -72,37 +76,37 @@ async function pullRepo(repoPath) {
  * @returns {Promise<{skillPath: string, needsUpdate: boolean}>}
  */
 async function cloneOrUpdateRepo(url) {
-    const parsed = parseGitHubUrl(url);
-    const targetPath = path.join(DEFAULT_LIB_PATH, parsed.owner, parsed.repo);
+  const parsed = parseGitHubUrl(url);
+  const targetPath = path.join(DEFAULT_LIB_PATH, parsed.owner, parsed.repo);
 
-    let needsUpdate = false;
+  let needsUpdate = false;
 
-    if (dirExists(targetPath)) {
-        // Repo exists, ask if user wants to update
-        needsUpdate = true;
-    } else {
-        // Clone new repo
-        await cloneRepo(parsed.cleanUrl, targetPath);
-    }
+  if (dirExists(targetPath)) {
+    // Repo exists, ask if user wants to update
+    needsUpdate = true;
+  } else {
+    // Clone new repo
+    await cloneRepo(parsed.cleanUrl, targetPath);
+  }
 
-    // Determine final skill path
-    let skillPath = targetPath;
-    if (parsed.subpath) {
-        skillPath = path.join(targetPath, parsed.subpath);
-    }
+  // Determine final skill path
+  let skillPath = targetPath;
+  if (parsed.subpath) {
+    skillPath = path.join(targetPath, parsed.subpath);
+  }
 
-    return {
-        skillPath,
-        targetPath,
-        needsUpdate,
-        hasSubpath: !!parsed.subpath
-    };
+  return {
+    skillPath,
+    targetPath,
+    needsUpdate,
+    hasSubpath: !!parsed.subpath,
+  };
 }
 
 module.exports = {
-    DEFAULT_LIB_PATH,
-    parseGitHubUrl,
-    cloneRepo,
-    pullRepo,
-    cloneOrUpdateRepo
+  DEFAULT_LIB_PATH,
+  parseGitHubUrl,
+  cloneRepo,
+  pullRepo,
+  cloneOrUpdateRepo,
 };