td-ai-tools 1.0.8 → 1.1.2

package/bin/cli.js

@@ -1,9 +1,12 @@
 #!/usr/bin/env node
-'use strict';
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import * as p from '@clack/prompts';
+import pc from 'picocolors';
 
-const fs = require('fs');
-const path = require('path');
-const readline = require('readline');
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
 
 const TOOLKIT_ROOT = path.resolve(__dirname, '..');
 const SKILLS_DIR = path.join(TOOLKIT_ROOT, 'skills');
@@ -14,6 +17,22 @@ const INSTALL_TARGETS = [
   { label: 'agents', root: '.agents' }
 ];
 
+const IS_TTY = Boolean(process.stdout.isTTY && process.stdin.isTTY);
+
+function status(kind, msg) {
+  if (IS_TTY) {
+    if (kind === 'success') p.log.success(msg);
+    else if (kind === 'step') p.log.step(msg);
+    else if (kind === 'warn') p.log.warn(msg);
+    else if (kind === 'error') p.log.error(msg);
+    else p.log.info(msg);
+  } else {
+    const stream = (kind === 'error' || kind === 'warn') ? console.error : console.log;
+    const prefix = kind === 'error' ? '  [error] ' : kind === 'warn' ? '  [warn] ' : '  ';
+    stream(prefix + msg);
+  }
+}
+
 function copyDir(src, dest) {
   const srcStat = fs.statSync(src);
   fs.mkdirSync(dest, { recursive: true, mode: srcStat.mode });
@@ -47,13 +66,13 @@ function readFrontmatterField(mdPath, field) {
 function installSkill(name, { replaceExisting = false } = {}) {
   const src = path.join(SKILLS_DIR, name);
   if (!fs.existsSync(src)) {
-    console.error(`  [error] Skill "${name}" not found.`);
+    status('error', `Skill "${name}" not found.`);
     return false;
   }
   for (const target of INSTALL_TARGETS) {
     const dest = path.join(TARGET_ROOT, target.root, 'skills', name);
     if (fs.existsSync(dest) && !replaceExisting) {
-      console.error(`  [error] Skill "${name}" already exists at ${target.root}/skills/${name}/ (use "update" to replace).`);
+      status('warn', `Skill "${name}" already exists at ${target.root}/skills/${name}/ (use "update" to replace).`);
       return false;
     }
     if (fs.existsSync(dest) && replaceExisting) {
@@ -61,7 +80,7 @@ function installSkill(name, { replaceExisting = false } = {}) {
     }
     copyDir(src, dest);
     const action = replaceExisting ? 'updated' : 'installed';
-    console.log(`  [skill] ${name} ${action} -> ${target.root}/skills/${name}/`);
+    status('success', `skill: ${name} ${action} → ${target.root}/skills/${name}/`);
   }
   return true;
 }
@@ -72,12 +91,12 @@ function deleteSkill(name) {
     const dest = path.join(TARGET_ROOT, target.root, 'skills', name);
     if (fs.existsSync(dest)) {
       fs.rmSync(dest, { recursive: true, force: true });
-      console.log(`  [skill] ${name} deleted from ${target.root}/skills/${name}/`);
+      status('success', `skill: ${name} deleted from ${target.root}/skills/${name}/`);
       deletedAny = true;
     }
   }
   if (!deletedAny) {
-    console.error(`  [error] Skill "${name}" is not installed.`);
+    status('error', `Skill "${name}" is not installed.`);
     return false;
   }
   return true;
@@ -86,13 +105,13 @@ function deleteSkill(name) {
 function installAgent(name, { replaceExisting = false } = {}) {
   const src = path.join(AGENTS_DIR, name);
   if (!fs.existsSync(src)) {
-    console.error(`  [error] Agent pack "${name}" not found.`);
+    status('error', `Agent pack "${name}" not found.`);
     return false;
   }
   for (const target of INSTALL_TARGETS) {
     const dest = path.join(TARGET_ROOT, target.root, 'agents', name);
     if (fs.existsSync(dest) && !replaceExisting) {
-      console.error(`  [error] Agent pack "${name}" already exists at ${target.root}/agents/${name}/ (use "update" to replace).`);
+      status('warn', `Agent pack "${name}" already exists at ${target.root}/agents/${name}/ (use "update" to replace).`);
       return false;
     }
     if (fs.existsSync(dest) && replaceExisting) {
@@ -100,7 +119,7 @@ function installAgent(name, { replaceExisting = false } = {}) {
     }
     copyDir(src, dest);
     const action = replaceExisting ? 'updated' : 'installed';
-    console.log(`  [agent] ${name} ${action} -> ${target.root}/agents/${name}/`);
+    status('success', `agent: ${name} ${action} → ${target.root}/agents/${name}/`);
   }
   return true;
 }
@@ -111,12 +130,12 @@ function deleteAgent(name) {
     const dest = path.join(TARGET_ROOT, target.root, 'agents', name);
     if (fs.existsSync(dest)) {
       fs.rmSync(dest, { recursive: true, force: true });
-      console.log(`  [agent] ${name} deleted from ${target.root}/agents/${name}/`);
+      status('success', `agent: ${name} deleted from ${target.root}/agents/${name}/`);
       deletedAny = true;
     }
   }
   if (!deletedAny) {
-    console.error(`  [error] Agent pack "${name}" is not installed.`);
+    status('error', `Agent pack "${name}" is not installed.`);
     return false;
   }
   return true;
@@ -137,7 +156,17 @@ function getInstalled(type) {
   return [...installed].sort();
 }
 
-function printList() {
+function getSkillHint(name) {
+  const desc = readFrontmatterField(path.join(SKILLS_DIR, name, 'SKILL.md'), 'description');
+  return desc.length > 72 ? desc.slice(0, 72) + '…' : desc;
+}
+
+function getAgentHint(name) {
+  const desc = readFrontmatterField(path.join(AGENTS_DIR, name, 'AGENTS.md'), 'description');
+  return desc.length > 72 ? desc.slice(0, 72) + '…' : desc;
+}
+
+function printListPlain() {
   const skills = getAvailable(SKILLS_DIR);
   const agents = getAvailable(AGENTS_DIR);
 
@@ -156,6 +185,47 @@ function printList() {
   console.log('');
 }
 
+function printList() {
+  if (!IS_TTY) {
+    printListPlain();
+    return;
+  }
+
+  const skills = getAvailable(SKILLS_DIR);
+  const agents = getAvailable(AGENTS_DIR);
+
+  p.intro(pc.bgCyan(pc.black(' AgentToolkit ')));
+
+  const skillsBody = skills.length
+    ? skills.map(name => {
+        const hint = getSkillHint(name);
+        return hint ? `${pc.bold(name)}\n  ${pc.dim(hint)}` : pc.bold(name);
+      }).join('\n')
+    : pc.dim('(none)');
+  p.note(skillsBody, `Skills (${skills.length})`);
+
+  const agentsBody = agents.length
+    ? agents.map(name => {
+        const hint = getAgentHint(name);
+        return hint ? `${pc.bold(name)}\n  ${pc.dim(hint)}` : pc.bold(name);
+      }).join('\n')
+    : pc.dim('(none)');
+  p.note(agentsBody, `Agent Packs (${agents.length})`);
+
+  p.outro(pc.dim(`${skills.length} skills, ${agents.length} agent packs available.`));
+}
+
+function printSelectionControls(action) {
+  p.note(
+    [
+      `Use Up/Down to move through the ${action} list.`,
+      'Press Space to select or deselect items.',
+      'Press Enter to confirm your choices.'
+    ].join('\n'),
+    'Controls'
+  );
+}
+
 function buildMenu() {
   const skills = getAvailable(SKILLS_DIR).map(name => ({ type: 'skill', name }));
   const agents = getAvailable(AGENTS_DIR).map(name => ({ type: 'agent', name }));
@@ -168,6 +238,28 @@ function buildDeleteMenu() {
   return [...skills, ...agents];
 }
 
+function toGroupOptions(menu, { hintForInstalled = false } = {}) {
+  const skillItems = menu.filter(i => i.type === 'skill').map(i => {
+    const hint = hintForInstalled ? '' : getSkillHint(i.name);
+    return { value: `skill:${i.name}`, label: i.name, hint: hint || undefined };
+  });
+  const agentItems = menu.filter(i => i.type === 'agent').map(i => {
+    const hint = hintForInstalled ? '' : getAgentHint(i.name);
+    return { value: `agent:${i.name}`, label: i.name, hint: hint || undefined };
+  });
+  const out = {};
+  if (skillItems.length) out['Skills'] = skillItems;
+  if (agentItems.length) out['Agent Packs'] = agentItems;
+  return out;
+}
+
+function fromGroupValues(values) {
+  return values.map(v => {
+    const idx = v.indexOf(':');
+    return { type: v.slice(0, idx), name: v.slice(idx + 1) };
+  });
+}
+
 function installItems(items, options = {}) {
   for (const item of items) {
     if (item.type === 'skill') installSkill(item.name, options);
@@ -185,67 +277,80 @@ function deleteItems(items) {
 async function interactiveInstall(mode = 'install') {
   const menu = buildMenu();
   if (menu.length === 0) {
-    console.log('No skills or agent packs available.');
+    status('info', 'No skills or agent packs available.');
     return;
   }
+  if (!IS_TTY) {
+    status('error', `interactive ${mode} requires a TTY. Use "${mode} --all" or "${mode} <name>...".`);
+    process.exit(1);
+  }
 
-  console.log('\nAvailable (enter numbers separated by spaces, or "all"):\n');
-  menu.forEach((item, i) => {
-    const label = item.type === 'skill' ? 'skill' : 'agent';
-    console.log(`  [${i + 1}] ${label}: ${item.name}`);
-  });
-  console.log('');
+  p.intro(pc.bgCyan(pc.black(' AgentToolkit ')));
+  printSelectionControls(mode);
 
-  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-  return new Promise(resolve => {
-    rl.question(`Select items to ${mode}: `, answer => {
-      rl.close();
-      const trimmed = answer.trim().toLowerCase();
-      let selected;
-      if (trimmed === 'all') {
-        selected = menu;
-      } else {
-        const indices = trimmed.split(/\s+/).map(n => parseInt(n, 10) - 1);
-        selected = indices.filter(i => i >= 0 && i < menu.length).map(i => menu[i]);
-      }
-      console.log('');
-      installItems(selected, { replaceExisting: mode === 'update' });
-      resolve();
-    });
+  const selection = await p.groupMultiselect({
+    message: `Select items to ${mode}`,
+    options: toGroupOptions(menu),
+    required: false,
   });
+
+  if (p.isCancel(selection)) {
+    p.cancel('Cancelled.');
+    process.exit(0);
+  }
+
+  const items = fromGroupValues(selection);
+  if (items.length === 0) {
+    p.outro(pc.dim('Nothing selected.'));
+    return;
+  }
+
+  installItems(items, { replaceExisting: mode === 'update' });
+  p.outro(mode === 'update' ? pc.green('Update complete.') : pc.green('Install complete.'));
 }
 
 async function interactiveDelete() {
   const menu = buildDeleteMenu();
   if (menu.length === 0) {
-    console.log('No installed skills or agent packs to delete.');
+    status('info', 'No installed skills or agent packs to delete.');
     return;
   }
+  if (!IS_TTY) {
+    status('error', 'interactive delete requires a TTY. Use "delete --all" or "delete <name>...".');
+    process.exit(1);
+  }
 
-  console.log('\nInstalled (enter numbers separated by spaces, or "all"):\n');
-  menu.forEach((item, i) => {
-    const label = item.type === 'skill' ? 'skill' : 'agent';
-    console.log(`  [${i + 1}] ${label}: ${item.name}`);
+  p.intro(pc.bgCyan(pc.black(' AgentToolkit ')));
+  printSelectionControls('delete');
+
+  const selection = await p.groupMultiselect({
+    message: 'Select items to delete',
+    options: toGroupOptions(menu, { hintForInstalled: true }),
+    required: false,
   });
-  console.log('');
 
-  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-  return new Promise(resolve => {
-    rl.question('Select items to delete: ', answer => {
-      rl.close();
-      const trimmed = answer.trim().toLowerCase();
-      let selected;
-      if (trimmed === 'all') {
-        selected = menu;
-      } else {
-        const indices = trimmed.split(/\s+/).map(n => parseInt(n, 10) - 1);
-        selected = indices.filter(i => i >= 0 && i < menu.length).map(i => menu[i]);
-      }
-      console.log('');
-      deleteItems(selected);
-      resolve();
-    });
+  if (p.isCancel(selection)) {
+    p.cancel('Cancelled.');
+    process.exit(0);
+  }
+
+  const items = fromGroupValues(selection);
+  if (items.length === 0) {
+    p.outro(pc.dim('Nothing selected.'));
+    return;
+  }
+
+  const confirmed = await p.confirm({
+    message: `Delete ${items.length} item(s)?`,
+    initialValue: false,
   });
+  if (p.isCancel(confirmed) || !confirmed) {
+    p.cancel('Cancelled.');
+    process.exit(0);
+  }
+
+  deleteItems(items);
+  p.outro(pc.green('Delete complete.'));
 }
 
 function resolveNames(names) {
@@ -258,7 +363,7 @@ function resolveNames(names) {
     } else if (agents.includes(name)) {
       items.push({ type: 'agent', name });
     } else {
-      console.error(`  [error] "${name}" not found as a skill or agent pack.`);
+      status('error', `"${name}" not found as a skill or agent pack.`);
     }
   }
   return items;
@@ -274,18 +379,13 @@ function resolveDeleteNames(names) {
     } else if (installedAgents.includes(name)) {
       items.push({ type: 'agent', name });
     } else {
-      console.error(`  [error] "${name}" is not installed.`);
+      status('error', `"${name}" is not installed.`);
     }
   }
   return items;
 }
 
-async function main() {
-  const args = process.argv.slice(2);
-
-  if (args.includes('--help') || args.includes('-h')) {
-    console.log(`
-Usage:
+const HELP_TEXT = `Usage:
   npx td-ai-tools                     Interactive install
   npx td-ai-tools list                List available skills and agent packs
   npx td-ai-tools install             Interactive install
@@ -299,18 +399,31 @@ Usage:
   npx td-ai-tools delete <name...>    Delete specific skills or agent packs
 
 Skills are installed to:   .claude/skills/<name>/
-                         .agents/skills/<name>/
+                           .agents/skills/<name>/
 Agent packs installed to:  .claude/agents/<name>/
-                         .agents/agents/<name>/
-`);
+                           .agents/agents/<name>/`;
+
+function printHelp() {
+  if (IS_TTY) {
+    p.intro(pc.bgCyan(pc.black(' AgentToolkit ')));
+    p.note(HELP_TEXT, 'Usage');
+    p.outro(pc.dim('Run with no arguments for interactive install.'));
+  } else {
+    console.log('\n' + HELP_TEXT + '\n');
+  }
+}
+
+async function main() {
+  const args = process.argv.slice(2);
+
+  if (args.includes('--help') || args.includes('-h')) {
+    printHelp();
     return;
   }
 
   const cmd = args[0];
-  console.log('AgentToolkit');
-  console.log('------------');
 
-  if (!cmd || cmd === 'install' && args.length === 1) {
+  if (!cmd || (cmd === 'install' && args.length === 1)) {
     await interactiveInstall('install');
     return;
   }
@@ -323,10 +436,8 @@ Agent packs installed to:  .claude/agents/<name>/
   if (cmd === 'install') {
     const rest = args.slice(1);
     if (rest[0] === '--all') {
-      console.log('');
       installItems(buildMenu());
     } else {
-      console.log('');
       installItems(resolveNames(rest));
     }
     return;
@@ -339,10 +450,8 @@ Agent packs installed to:  .claude/agents/<name>/
       return;
     }
     if (rest[0] === '--all') {
-      console.log('');
       installItems(buildMenu(), { replaceExisting: true });
     } else {
-      console.log('');
       installItems(resolveNames(rest), { replaceExisting: true });
     }
     return;
@@ -355,20 +464,18 @@ Agent packs installed to:  .claude/agents/<name>/
       return;
     }
     if (rest[0] === '--all') {
-      console.log('');
       deleteItems(buildDeleteMenu());
     } else {
-      console.log('');
       deleteItems(resolveDeleteNames(rest));
     }
     return;
   }
 
-  console.error(`Unknown command: "${cmd}". Run with --help for usage.`);
+  status('error', `Unknown command: "${cmd}". Run with --help for usage.`);
   process.exit(1);
 }
 
 main().catch(err => {
-  console.error(err.message);
+  status('error', err.message);
   process.exit(1);
 });

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "td-ai-tools",
-  "version": "1.0.8",
+  "version": "1.1.2",
   "description": "Install agent skills and packs into your project",
+  "type": "module",
   "scripts": {
     "smoke:install": "./scripts/smoke-install.sh"
   },
@@ -15,8 +16,12 @@
     "skills/",
     "agents/"
   ],
+  "dependencies": {
+    "@clack/prompts": "^1.4.0",
+    "picocolors": "^1.1.0"
+  },
   "engines": {
-    "node": ">=16"
+    "node": ">=20.12"
   },
   "keywords": [
     "claude",