ma-agents 1.2.0 → 1.4.0

package/bin/cli.js

@@ -3,7 +3,7 @@
 const prompts = require('prompts');
 const chalk = require('chalk');
 const path = require('path');
-const { installSkill, listSkills, listAgents } = require('../lib/installer');
+const { installSkill, uninstallSkill, getStatus, listSkills, listAgents } = require('../lib/installer');
 
 const PKG = require('../package.json');
 const NAME = PKG.name;
@@ -17,18 +17,24 @@ ${chalk.bold('Usage:')}
   ${chalk.cyan(`npx ${NAME}`)}                              Interactive wizard
   ${chalk.cyan(`npx ${NAME} install`)}                      Interactive install wizard
   ${chalk.cyan(`npx ${NAME} install`)} <skill> <agents...>  Install directly
+  ${chalk.cyan(`npx ${NAME} uninstall`)} <skill> <agents..> Uninstall a skill
+  ${chalk.cyan(`npx ${NAME} status`)}                       Show installed skills
   ${chalk.cyan(`npx ${NAME} list`)}                         List available skills
   ${chalk.cyan(`npx ${NAME} agents`)}                       List supported agents
   ${chalk.cyan(`npx ${NAME} help`)}                         Show this help
 
 ${chalk.bold('Install options:')}
+  ${chalk.cyan('--global')}        Install to global/user-level paths (default: project-level)
   ${chalk.cyan('--path <dir>')}    Custom installation directory
+  ${chalk.cyan('--force')}         Skip upgrade prompts, always overwrite
 
 ${chalk.bold('Examples:')}
   npx ${NAME} install
   npx ${NAME} install code-review claude-code
-  npx ${NAME} install test-generator claude-code cline cursor
-  npx ${NAME} install skill-creator claude-code --path ./my-skills
+  npx ${NAME} install code-review claude-code --force
+  npx ${NAME} uninstall code-review claude-code
+  npx ${NAME} status
+  npx ${NAME} status --global
 `);
 }
 
@@ -36,7 +42,7 @@ function showSkills() {
   const skills = listSkills();
   console.log(chalk.bold('\n Available Skills:\n'));
   skills.forEach(skill => {
-    console.log(chalk.cyan(`  ${skill.id.padEnd(35)}`) + chalk.white(skill.name));
+    console.log(chalk.cyan(`  ${skill.id.padEnd(35)}`) + chalk.white(`${skill.name}`) + chalk.gray(` v${skill.version}`));
     console.log(chalk.gray(`  ${''.padEnd(35)}${skill.description}\n`));
   });
 }
@@ -45,16 +51,76 @@ function showAgents() {
   const agents = listAgents();
   console.log(chalk.bold('\n Supported Agents:\n'));
   agents.forEach(agent => {
-    console.log(chalk.cyan(`  ${agent.id.padEnd(20)}`) + chalk.white(agent.name) + chalk.gray(` - ${agent.description}`));
+    console.log(chalk.cyan(`  ${agent.id.padEnd(20)}`) + chalk.white(agent.name) + chalk.gray(` v${agent.version} - ${agent.description}`));
   });
   console.log('');
 }
 
-async function installWizard(preselectedSkill, preselectedAgents, customPath) {
+function showStatus(args) {
+  const globalFlag = args.includes('--global');
+  const scope = globalFlag ? 'global' : 'project';
+  const positional = args.filter(a => a !== '--global');
+
+  const results = getStatus(positional, '', scope);
+
+  if (results.length === 0) {
+    console.log(chalk.gray(`\n  No skills installed (${scope} scope)\n`));
+    return;
+  }
+
+  console.log(chalk.bold(`\n Installed Skills:\n`));
+
+  for (const entry of results) {
+    console.log(chalk.cyan(`  ${entry.agent.name}`) + chalk.gray(` (${entry.scope}: ${entry.installPath})`));
+
+    const skillIds = Object.keys(entry.skills);
+    for (const skillId of skillIds) {
+      const info = entry.skills[skillId];
+      const installed = new Date(info.installedAt).toLocaleDateString();
+      const updated = info.updatedAt !== info.installedAt
+        ? chalk.gray(` updated ${new Date(info.updatedAt).toLocaleDateString()}`)
+        : '';
+      console.log(
+        chalk.white(`    ${skillId.padEnd(35)}`) +
+        chalk.green(`v${info.version}`) +
+        chalk.gray(`  installed ${installed}`) +
+        updated
+      );
+    }
+    console.log('');
+  }
+}
+
+// --- Parse common flags from args ---
+
+function parseFlags(args) {
+  const globalFlag = args.includes('--global');
+  const forceFlag = args.includes('--force');
+  let customPath = '';
+  let positional = [...args].filter(a => a !== '--global' && a !== '--force');
+
+  const pathIdx = positional.indexOf('--path');
+  if (pathIdx !== -1) {
+    customPath = positional[pathIdx + 1] || '';
+    positional.splice(pathIdx, 2);
+  }
+
+  return {
+    globalFlag,
+    forceFlag,
+    customPath,
+    scope: globalFlag ? 'global' : 'project',
+    positional
+  };
+}
+
+// --- Install wizard ---
+
+async function installWizard(preselectedSkill, preselectedAgents, customPath, forceFlag) {
   const skills = listSkills();
   const agents = listAgents();
 
-  // Step 1: Select skills (multi-select)
+  // Step 1: Select skills
   let selectedSkillIds;
   if (preselectedSkill) {
     selectedSkillIds = [preselectedSkill];
@@ -64,7 +130,7 @@ async function installWizard(preselectedSkill, preselectedAgents, customPath) {
       name: 'skills',
       message: 'Which skills do you want to install?',
       choices: skills.map(s => ({
-        title: chalk.white(s.name) + chalk.gray(` - ${s.description}`),
+        title: chalk.white(s.name) + chalk.gray(` v${s.version} - ${s.description}`),
         value: s.id,
         selected: false
       })),
@@ -79,7 +145,7 @@ async function installWizard(preselectedSkill, preselectedAgents, customPath) {
     selectedSkillIds = chosen;
   }
 
-  // Step 2: Select agents (multi-select)
+  // Step 2: Select agents
   let selectedAgentIds;
   if (preselectedAgents && preselectedAgents.length > 0) {
     selectedAgentIds = preselectedAgents;
@@ -89,7 +155,7 @@ async function installWizard(preselectedSkill, preselectedAgents, customPath) {
       name: 'agents',
       message: 'Which coding agents do you want to install to?',
       choices: agents.map(a => ({
-        title: chalk.white(a.name) + chalk.gray(` - ${a.description}`),
+        title: chalk.white(a.name) + chalk.gray(` v${a.version} - ${a.description}`),
         value: a.id,
         selected: false
       })),
@@ -104,20 +170,24 @@ async function installWizard(preselectedSkill, preselectedAgents, customPath) {
     selectedAgentIds = chosen;
   }
 
-  // Step 3: Custom path (optional)
+  // Step 3: Installation scope
   let installPath = customPath || '';
+  let installScope = 'project';
   if (!installPath) {
     const { pathChoice } = await prompts({
       type: 'select',
       name: 'pathChoice',
-      message: 'Installation path:',
+      message: 'Installation scope:',
       choices: [
-        { title: 'Default (agent-specific paths)', value: 'default' },
+        { title: 'Project level (current directory)', value: 'project' },
+        { title: 'Global (user-level settings)', value: 'global' },
         { title: 'Custom path...', value: 'custom' }
       ]
     });
 
-    if (pathChoice === 'custom') {
+    if (pathChoice === 'global') {
+      installScope = 'global';
+    } else if (pathChoice === 'custom') {
       const { customDir } = await prompts({
         type: 'text',
         name: 'customDir',
@@ -133,7 +203,7 @@ async function installWizard(preselectedSkill, preselectedAgents, customPath) {
   console.log(chalk.bold('  Summary:'));
   console.log(chalk.cyan('  Skills:  ') + selectedSkillIds.join(', '));
   console.log(chalk.cyan('  Agents:  ') + selectedAgentIds.join(', '));
-  console.log(chalk.cyan('  Path:    ') + (installPath || 'default'));
+  console.log(chalk.cyan('  Path:    ') + (installPath || (installScope === 'global' ? 'global (user-level)' : 'project (current directory)')));
   console.log('');
 
   const { confirmed } = await prompts({
@@ -148,10 +218,10 @@ async function installWizard(preselectedSkill, preselectedAgents, customPath) {
     process.exit(0);
   }
 
-  // Step 5: Install each skill
+  // Step 5: Install each skill (with upgrade detection)
   for (const skillId of selectedSkillIds) {
     try {
-      await installSkill(skillId, selectedAgentIds, installPath);
+      await installSkill(skillId, selectedAgentIds, installPath, installScope, { force: !!forceFlag });
     } catch (error) {
       console.error(chalk.red(`\n Failed to install ${skillId}:`), error.message);
     }
@@ -160,34 +230,29 @@ async function installWizard(preselectedSkill, preselectedAgents, customPath) {
   console.log(chalk.bold.green('\n Installation complete!\n'));
 }
 
-async function handleInstall(args) {
-  const pathIdx = args.indexOf('--path');
-  let customPath = '';
-  let positional = [...args];
+// --- Command handlers ---
 
-  if (pathIdx !== -1) {
-    customPath = args[pathIdx + 1] || '';
-    positional.splice(pathIdx, 2);
-  }
+async function handleInstall(args) {
+  const { globalFlag, forceFlag, customPath, scope, positional } = parseFlags(args);
 
   const skillId = positional[0];
   const agentIds = positional.slice(1);
 
   // No args → launch wizard
   if (!skillId) {
-    await installWizard(null, null, customPath);
+    await installWizard(null, null, customPath, forceFlag);
     return;
   }
 
   // Skill but no agents → wizard with skill preselected
   if (agentIds.length === 0) {
-    await installWizard(skillId, null, customPath);
+    await installWizard(skillId, null, customPath, forceFlag);
     return;
   }
 
   // Full args → direct install
   try {
-    await installSkill(skillId, agentIds, customPath);
+    await installSkill(skillId, agentIds, customPath, scope, { force: forceFlag });
     console.log(chalk.bold.green('\n Installation complete!\n'));
   } catch (error) {
     console.error(chalk.red('\n Installation failed:'), error.message);
@@ -195,6 +260,33 @@ async function handleInstall(args) {
   }
 }
 
+async function handleUninstall(args) {
+  const { globalFlag, customPath, scope, positional } = parseFlags(args);
+
+  const skillId = positional[0];
+  const agentIds = positional.slice(1);
+
+  if (!skillId) {
+    console.error(chalk.red('Usage: npx ma-agents uninstall <skill> <agents...>'));
+    process.exit(1);
+  }
+
+  if (agentIds.length === 0) {
+    console.error(chalk.red('Please specify at least one agent. Run "npx ma-agents agents" to see options.'));
+    process.exit(1);
+  }
+
+  try {
+    await uninstallSkill(skillId, agentIds, customPath, scope);
+    console.log(chalk.bold.green('\n Uninstall complete!\n'));
+  } catch (error) {
+    console.error(chalk.red('\n Uninstall failed:'), error.message);
+    process.exit(1);
+  }
+}
+
+// --- Interactive mode ---
+
 async function interactiveMode() {
   console.log(chalk.bold.cyan(`\n ${NAME} v${VERSION}\n`));
 
@@ -204,6 +296,7 @@ async function interactiveMode() {
     message: 'What would you like to do?',
     choices: [
       { title: 'Install skills', value: 'install' },
+      { title: 'Show installed skills', value: 'status' },
       { title: 'List available skills', value: 'list-skills' },
       { title: 'List supported agents', value: 'list-agents' },
       { title: 'Exit', value: 'exit' }
@@ -215,6 +308,11 @@ async function interactiveMode() {
     process.exit(0);
   }
 
+  if (action === 'status') {
+    showStatus([]);
+    process.exit(0);
+  }
+
   if (action === 'list-skills') {
     showSkills();
     process.exit(0);
@@ -230,6 +328,8 @@ async function interactiveMode() {
   }
 }
 
+// --- Main ---
+
 async function main() {
   const args = process.argv.slice(2);
   const command = args[0];
@@ -238,6 +338,13 @@ async function main() {
     case 'install':
       await handleInstall(args.slice(1));
       break;
+    case 'uninstall':
+    case 'remove':
+      await handleUninstall(args.slice(1));
+      break;
+    case 'status':
+      showStatus(args.slice(1));
+      break;
     case 'list':
     case 'list-skills':
       showSkills();

package/index.js

@@ -1,20 +1,22 @@
 /**
- * AI Agent Skills - Programmatic API
+ * ma-agents - Programmatic API
  *
  * This module exports the core functionality for use as a library.
- * For CLI usage, use: npx ai-agent-skills
+ * For CLI usage, use: npx ma-agents
  */
 
-const { installSkill, listSkills, listAgents } = require('./lib/installer');
+const { installSkill, uninstallSkill, getStatus, listSkills, listAgents, readManifest, getInstalledSkillInfo, compareSemver } = require('./lib/installer');
 const { getAgent, getAllAgents } = require('./lib/agents');
 
 module.exports = {
-  // Installer functions
   installSkill,
+  uninstallSkill,
+  getStatus,
   listSkills,
   listAgents,
-
-  // Agent functions
+  readManifest,
+  getInstalledSkillInfo,
+  compareSemver,
   getAgent,
   getAllAgents
 };

package/lib/agents.js

@@ -7,7 +7,8 @@ const path = require('path');
  * - id: unique identifier
  * - name: display name
  * - description: brief description
- * - getSkillsPath: function that returns the default skills directory
+ * - getProjectPath: function that returns the project-level skills directory (relative to cwd)
+ * - getGlobalPath: function that returns the global/user-level skills directory
  * - fileExtension: the file extension for skill files
  * - template: the template type to use for this agent
  */
@@ -16,8 +17,10 @@ const agents = [
   {
     id: 'claude-code',
     name: 'Claude Code',
+    version: '1.0.0',
     description: 'Anthropic Claude Code CLI',
-    getSkillsPath: () => {
+    getProjectPath: () => path.join(process.cwd(), '.claude', 'skills'),
+    getGlobalPath: () => {
       const platform = os.platform();
       if (platform === 'win32') {
         return path.join(os.homedir(), 'AppData', 'Roaming', 'Claude', 'skills');
@@ -33,8 +36,10 @@ const agents = [
   {
     id: 'gemini',
     name: 'Google Gemini',
+    version: '1.0.0',
     description: 'Google Gemini Code Assist',
-    getSkillsPath: () => {
+    getProjectPath: () => path.join(process.cwd(), '.gemini', 'skills'),
+    getGlobalPath: () => {
       const platform = os.platform();
       if (platform === 'win32') {
         return path.join(os.homedir(), 'AppData', 'Roaming', 'Gemini', 'skills');
@@ -50,8 +55,10 @@ const agents = [
   {
     id: 'copilot',
     name: 'GitHub Copilot',
+    version: '1.0.0',
     description: 'GitHub Copilot Agent Mode',
-    getSkillsPath: () => {
+    getProjectPath: () => path.join(process.cwd(), '.github', 'copilot', 'skills'),
+    getGlobalPath: () => {
       const platform = os.platform();
       if (platform === 'win32') {
         return path.join(os.homedir(), 'AppData', 'Roaming', 'GitHub Copilot', 'skills');
@@ -67,8 +74,10 @@ const agents = [
   {
     id: 'kilocode',
     name: 'Kilocode',
+    version: '1.0.0',
     description: 'Kilocode AI Assistant',
-    getSkillsPath: () => {
+    getProjectPath: () => path.join(process.cwd(), '.kilocode', 'skills'),
+    getGlobalPath: () => {
       const platform = os.platform();
       if (platform === 'win32') {
         return path.join(os.homedir(), 'AppData', 'Roaming', 'Kilocode', 'skills');
@@ -84,8 +93,10 @@ const agents = [
   {
     id: 'cline',
     name: 'Cline',
+    version: '1.0.0',
     description: 'Cline AI Assistant',
-    getSkillsPath: () => {
+    getProjectPath: () => path.join(process.cwd(), '.cline', 'skills'),
+    getGlobalPath: () => {
       const platform = os.platform();
       if (platform === 'win32') {
         return path.join(os.homedir(), 'AppData', 'Roaming', 'Code', 'User', 'globalStorage', 'saoudrizwan.claude-dev', 'skills');
@@ -96,13 +107,20 @@ const agents = [
       }
     },
     fileExtension: '.md',
-    template: 'cline'
+    template: 'cline',
+    // Cline uses different directory names than the generic structure
+    resourceMap: {
+      'references': 'docs',
+      'assets': 'templates'
+    }
   },
   {
     id: 'cursor',
     name: 'Cursor',
+    version: '1.0.0',
     description: 'Cursor AI Editor',
-    getSkillsPath: () => {
+    getProjectPath: () => path.join(process.cwd(), '.cursor', 'skills'),
+    getGlobalPath: () => {
       const platform = os.platform();
       if (platform === 'win32') {
         return path.join(os.homedir(), 'AppData', 'Roaming', 'Cursor', 'User', 'skills');