@musashishao/agent-kit 1.1.5 → 1.1.6

package/bin/cli.js

@@ -36,15 +36,21 @@ ${colors.bright}Usage:${colors.reset}
   npx ${PACKAGE_NAME} <command> [options]
 
 ${colors.bright}Commands:${colors.reset}
-  init          Install .agent folder into current project
-  setup-codex   Sync workflows with Codex CLI slash commands
-  update        Update .agent folder to match current package version
-  status        Check installation status
+  ${colors.cyan}init${colors.reset}          Install .agent folder into current project
+  ${colors.cyan}setup-codex${colors.reset}   Sync workflows with Codex CLI slash commands
+  ${colors.cyan}codex${colors.reset}         Generate AGENTS.md for Codex CLI (use --template)
+  ${colors.cyan}agents${colors.reset}        List all available agents
+  ${colors.cyan}skills${colors.reset}        List all available skills
+  ${colors.cyan}workflows${colors.reset}     List all available workflows
+  ${colors.cyan}doctor${colors.reset}        Check configuration and diagnose issues
+  ${colors.cyan}update${colors.reset}        Update .agent folder to latest version
+  ${colors.cyan}status${colors.reset}        Check installation status
 
 ${colors.bright}Options:${colors.reset}
-  --force       Overwrite existing .agent folder (REQUIRED for update)
+  --force       Overwrite existing files
   --path <dir>  Install in specific directory
   --prefix <str> Custom prefix for slash commands (default: kit-)
+  --template <type>  Template type: web, mobile, backend (for codex command)
   --quiet       Suppress output
   --help        Show this help message
   --version     Show version
@@ -52,6 +58,9 @@ ${colors.bright}Options:${colors.reset}
 ${colors.bright}Examples:${colors.reset}
   npx ${PACKAGE_NAME} init
   npx ${PACKAGE_NAME} setup-codex
+  npx ${PACKAGE_NAME} codex --template web
+  npx ${PACKAGE_NAME} agents
+  npx ${PACKAGE_NAME} doctor
   
 ${colors.yellow}# To ensure you have the latest version from NPM:${colors.reset}
   npx ${PACKAGE_NAME}@latest update
@@ -252,6 +261,256 @@ function updateCommand(options) {
   log.success('Update complete!');
 }
 
+// ============ NEW COMMANDS ============
+
+function codexCommand(options) {
+  const targetDir = options.path || process.cwd();
+  const template = options.template || 'default';
+  
+  log.title('📝 Musa Agent Kit - Generating AGENTS.md for Codex CLI');
+  
+  const packageRoot = path.resolve(__dirname, '..');
+  const templatesDir = path.join(packageRoot, '.agent', 'templates');
+  
+  // Determine template file
+  let templateFile;
+  switch (template) {
+    case 'web':
+      templateFile = 'AGENTS.web.md';
+      break;
+    case 'mobile':
+      templateFile = 'AGENTS.mobile.md';
+      break;
+    case 'backend':
+      templateFile = 'AGENTS.backend.md';
+      break;
+    default:
+      templateFile = 'AGENTS.md';
+  }
+  
+  const templatePath = path.join(templatesDir, templateFile);
+  const destPath = path.join(targetDir, 'AGENTS.md');
+  
+  if (!fs.existsSync(templatePath)) {
+    log.error(`Template not found: ${templateFile}`);
+    log.info('Available templates: default, web, mobile, backend');
+    process.exit(1);
+  }
+  
+  if (fs.existsSync(destPath) && !options.force) {
+    log.warn('AGENTS.md already exists!');
+    log.info('Use --force to overwrite');
+    process.exit(1);
+  }
+  
+  fs.copyFileSync(templatePath, destPath);
+  
+  log.success(`AGENTS.md created with "${template}" template!`);
+  log.info('Edit the file to customize for your project.');
+  console.log(`
+${colors.bright}📄 File created:${colors.reset} ${destPath}
+
+${colors.bright}🎯 Next steps:${colors.reset}
+   1. Edit AGENTS.md with your project details
+   2. Replace [PROJECT_NAME] placeholders
+   3. Update tech stack section
+   4. Codex CLI will now use this config!
+`);
+}
+
+function agentsCommand() {
+  const agentDir = path.join(process.cwd(), '.agent', 'agents');
+  
+  log.title('🤖 Available Agents');
+  
+  if (!fs.existsSync(agentDir)) {
+    log.warn('.agent/agents folder not found. Run "init" first.');
+    return;
+  }
+  
+  const agents = fs.readdirSync(agentDir).filter(f => f.endsWith('.md'));
+  
+  console.log(`${colors.bright}Found ${agents.length} agents:${colors.reset}\n`);
+  
+  for (const agent of agents) {
+    const name = agent.replace('.md', '');
+    const content = fs.readFileSync(path.join(agentDir, agent), 'utf-8');
+    
+    // Extract description from frontmatter
+    const descMatch = content.match(/description:\s*(.+)/);
+    const desc = descMatch ? descMatch[1].substring(0, 60) + '...' : 'No description';
+    
+    console.log(`  ${colors.cyan}@${name}${colors.reset}`);
+    console.log(`    ${colors.yellow}${desc}${colors.reset}\n`);
+  }
+}
+
+function skillsCommand() {
+  const skillsDir = path.join(process.cwd(), '.agent', 'skills');
+  
+  log.title('🧠 Available Skills');
+  
+  if (!fs.existsSync(skillsDir)) {
+    log.warn('.agent/skills folder not found. Run "init" first.');
+    return;
+  }
+  
+  const skills = fs.readdirSync(skillsDir, { withFileTypes: true })
+    .filter(d => d.isDirectory());
+  
+  console.log(`${colors.bright}Found ${skills.length} skills:${colors.reset}\n`);
+  
+  const categories = {
+    frontend: [],
+    backend: [],
+    security: [],
+    design: [],
+    debug: [],
+    other: []
+  };
+  
+  for (const skill of skills) {
+    const skillPath = path.join(skillsDir, skill.name, 'SKILL.md');
+    if (fs.existsSync(skillPath)) {
+      const content = fs.readFileSync(skillPath, 'utf-8');
+      const descMatch = content.match(/description:\s*(.+)/);
+      const desc = descMatch ? descMatch[1].substring(0, 50) : '';
+      
+      // Categorize
+      if (['react', 'next', 'tailwind', 'frontend'].some(k => skill.name.includes(k))) {
+        categories.frontend.push({ name: skill.name, desc });
+      } else if (['api', 'node', 'prisma', 'database', 'backend'].some(k => skill.name.includes(k))) {
+        categories.backend.push({ name: skill.name, desc });
+      } else if (['security', 'vulnerability', 'red-team'].some(k => skill.name.includes(k))) {
+        categories.security.push({ name: skill.name, desc });
+      } else if (['ui', 'design', 'mobile'].some(k => skill.name.includes(k))) {
+        categories.design.push({ name: skill.name, desc });
+      } else if (['debug', 'problem'].some(k => skill.name.includes(k))) {
+        categories.debug.push({ name: skill.name, desc });
+      } else {
+        categories.other.push({ name: skill.name, desc });
+      }
+    }
+  }
+  
+  for (const [category, items] of Object.entries(categories)) {
+    if (items.length > 0) {
+      console.log(`${colors.bright}${category.toUpperCase()}${colors.reset} (${items.length})`);
+      for (const item of items) {
+        console.log(`  ${colors.cyan}${item.name}${colors.reset}`);
+      }
+      console.log('');
+    }
+  }
+}
+
+function workflowsCommand() {
+  const workflowsDir = path.join(process.cwd(), '.agent', 'workflows');
+  
+  log.title('⚡ Available Workflows (Slash Commands)');
+  
+  if (!fs.existsSync(workflowsDir)) {
+    log.warn('.agent/workflows folder not found. Run "init" first.');
+    return;
+  }
+  
+  const workflows = fs.readdirSync(workflowsDir).filter(f => f.endsWith('.md'));
+  
+  console.log(`${colors.bright}Found ${workflows.length} workflows:${colors.reset}\n`);
+  
+  for (const wf of workflows) {
+    const name = wf.replace('.md', '');
+    const content = fs.readFileSync(path.join(workflowsDir, wf), 'utf-8');
+    
+    const descMatch = content.match(/description:\s*(.+)/);
+    const desc = descMatch ? descMatch[1] : 'No description';
+    
+    console.log(`  ${colors.green}/${name}${colors.reset}`);
+    console.log(`    ${desc}\n`);
+  }
+}
+
+function doctorCommand() {
+  log.title('🩺 Agent Kit - Health Check');
+  
+  const cwd = process.cwd();
+  const checks = [];
+  
+  // Check 1: .agent folder
+  const agentDir = path.join(cwd, '.agent');
+  if (fs.existsSync(agentDir)) {
+    checks.push({ name: '.agent folder', status: '✅', message: 'Found' });
+  } else {
+    checks.push({ name: '.agent folder', status: '❌', message: 'Not found - run "init"' });
+  }
+  
+  // Check 2: AGENTS.md
+  const agentsMd = path.join(cwd, 'AGENTS.md');
+  if (fs.existsSync(agentsMd)) {
+    checks.push({ name: 'AGENTS.md', status: '✅', message: 'Found (Codex CLI ready)' });
+  } else {
+    checks.push({ name: 'AGENTS.md', status: '⚠️', message: 'Not found - run "codex"' });
+  }
+  
+  // Check 3: .codex folder
+  const codexDir = path.join(cwd, '.codex');
+  if (fs.existsSync(codexDir)) {
+    checks.push({ name: '.codex folder', status: '✅', message: 'Found' });
+  } else {
+    checks.push({ name: '.codex folder', status: '⚠️', message: 'Optional - not found' });
+  }
+  
+  // Check 4: Agents count
+  if (fs.existsSync(path.join(agentDir, 'agents'))) {
+    const count = fs.readdirSync(path.join(agentDir, 'agents')).length;
+    checks.push({ name: 'Agents', status: '✅', message: `${count} available` });
+  }
+  
+  // Check 5: Skills count
+  if (fs.existsSync(path.join(agentDir, 'skills'))) {
+    const count = fs.readdirSync(path.join(agentDir, 'skills')).length;
+    checks.push({ name: 'Skills', status: '✅', message: `${count} available` });
+  }
+  
+  // Check 6: Workflows count
+  if (fs.existsSync(path.join(agentDir, 'workflows'))) {
+    const count = fs.readdirSync(path.join(agentDir, 'workflows')).length;
+    checks.push({ name: 'Workflows', status: '✅', message: `${count} available` });
+  }
+  
+  // Check 7: Codex CLI global prompts
+  const codexPromptDir = path.join(os.homedir(), '.codex', 'prompts');
+  if (fs.existsSync(codexPromptDir)) {
+    const prompts = fs.readdirSync(codexPromptDir).filter(f => f.startsWith('kit-'));
+    if (prompts.length > 0) {
+      checks.push({ name: 'Codex slash commands', status: '✅', message: `${prompts.length} synced` });
+    } else {
+      checks.push({ name: 'Codex slash commands', status: '⚠️', message: 'Not synced - run "setup-codex"' });
+    }
+  } else {
+    checks.push({ name: 'Codex prompts dir', status: '⚠️', message: 'Not found' });
+  }
+  
+  // Display results
+  console.log(`${colors.bright}Diagnostic Results:${colors.reset}\n`);
+  
+  for (const check of checks) {
+    console.log(`  ${check.status} ${colors.cyan}${check.name}${colors.reset}: ${check.message}`);
+  }
+  
+  const hasErrors = checks.some(c => c.status === '❌');
+  const hasWarnings = checks.some(c => c.status === '⚠️');
+  
+  console.log('');
+  if (hasErrors) {
+    log.error('Some critical checks failed. Run suggested commands to fix.');
+  } else if (hasWarnings) {
+    log.warn('Some optional configurations missing. Consider running suggested commands.');
+  } else {
+    log.success('All checks passed! Agent Kit is ready.');
+  }
+}
+
 // Parse arguments
 const args = process.argv.slice(2);
 const command = args[0];
@@ -260,7 +519,8 @@ const options = {
   force: args.includes('--force'),
   quiet: args.includes('--quiet'),
   path: null,
-  prefix: null
+  prefix: null,
+  template: null
 };
 
 // Parse --path
@@ -275,6 +535,12 @@ if (prefixIndex !== -1 && args[prefixIndex + 1]) {
   options.prefix = args[prefixIndex + 1];
 }
 
+// Parse --template
+const templateIndex = args.indexOf('--template');
+if (templateIndex !== -1 && args[templateIndex + 1]) {
+  options.template = args[templateIndex + 1];
+}
+
 // Execute command
 switch (command) {
   case 'init':
@@ -283,6 +549,21 @@ switch (command) {
   case 'setup-codex':
     setupCodexCommand(options);
     break;
+  case 'codex':
+    codexCommand(options);
+    break;
+  case 'agents':
+    agentsCommand();
+    break;
+  case 'skills':
+    skillsCommand();
+    break;
+  case 'workflows':
+    workflowsCommand();
+    break;
+  case 'doctor':
+    doctorCommand();
+    break;
   case 'update':
     updateCommand(options);
     break;
@@ -303,4 +584,3 @@ switch (command) {
     showHelp();
     process.exit(1);
 }
-

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@musashishao/agent-kit",
-  "version": "1.1.5",
+  "version": "1.1.6",
   "description": "AI Agent templates - Skills, Agents, and Workflows for enhanced coding assistance",
   "main": "index.js",
   "bin": {