@smicolon/ai-kit 0.1.1 → 0.2.1

package/README.md

@@ -5,7 +5,7 @@ AI coding tool pack manager. Install convention packs (agents, skills, commands,
 ## Quick Start
 
 ```bash
-npx @smicolon/ai-kit init
+npx @smicolon/ai-kit@latest init
 ```
 
 This walks you through selecting your AI tools and stack, then installs the right files in the right places.
@@ -17,8 +17,8 @@ This walks you through selecting your AI tools and stack, then installs the righ
 Interactive first-time setup. Prompts for your AI tools, stack, and component preferences.
 
 ```bash
-npx @smicolon/ai-kit init
-npx @smicolon/ai-kit init --cwd apps/web  # monorepo sub-package
+npx @smicolon/ai-kit@latest init
+npx @smicolon/ai-kit@latest init --cwd apps/web  # monorepo sub-package
 ```
 
 ### `add <pack>`
@@ -26,11 +26,11 @@ npx @smicolon/ai-kit init --cwd apps/web  # monorepo sub-package
 Add a pack to your project.
 
 ```bash
-npx @smicolon/ai-kit add django
-npx @smicolon/ai-kit add django --skills-only
-npx @smicolon/ai-kit add django --agents-only
-npx @smicolon/ai-kit add django --rules-only
-npx @smicolon/ai-kit add django --tools claude-code,cursor
+npx @smicolon/ai-kit@latest add django
+npx @smicolon/ai-kit@latest add django --skills-only
+npx @smicolon/ai-kit@latest add django --agents-only
+npx @smicolon/ai-kit@latest add django --rules-only
+npx @smicolon/ai-kit@latest add django --tools claude-code,cursor
 ```
 
 ### `list`
@@ -38,8 +38,8 @@ npx @smicolon/ai-kit add django --tools claude-code,cursor
 Show available or installed packs.
 
 ```bash
-npx @smicolon/ai-kit list              # available packs
-npx @smicolon/ai-kit list --installed   # installed packs
+npx @smicolon/ai-kit@latest list              # available packs
+npx @smicolon/ai-kit@latest list --installed   # installed packs
 ```
 
 ### `remove <pack>`
@@ -47,7 +47,17 @@ npx @smicolon/ai-kit list --installed   # installed packs
 Remove a pack and all its installed files.
 
 ```bash
-npx @smicolon/ai-kit remove django
+npx @smicolon/ai-kit@latest remove django
+```
+
+### `search <query>`
+
+Search packs by name or keyword.
+
+```bash
+npx @smicolon/ai-kit@latest search auth
+npx @smicolon/ai-kit@latest search frontend
+npx @smicolon/ai-kit@latest search tdd
 ```
 
 ### `update [pack]`
@@ -55,8 +65,8 @@ npx @smicolon/ai-kit remove django
 Update installed packs to latest versions.
 
 ```bash
-npx @smicolon/ai-kit update          # update all
-npx @smicolon/ai-kit update django   # update one
+npx @smicolon/ai-kit@latest update          # update all
+npx @smicolon/ai-kit@latest update django   # update one
 ```
 
 ## Supported AI Tools
@@ -116,15 +126,15 @@ your-project/
 └── .gitignore               # auto-updated
 ```
 
-Config is stored in `.ai-kit.json` which tracks installed packs and all created files for clean removal.
+Tool preferences are stored globally at `~/.config/ai-kit/config.json` (pick once, works in all projects). Local `.ai-kit.json` tracks installed packs and files for clean removal — it's auto-added to `.gitignore`.
 
 ## Monorepo Support
 
 Use `--cwd` to target a sub-package. Both the sub-package and root `.gitignore` are updated.
 
 ```bash
-npx @smicolon/ai-kit init --cwd apps/web
-npx @smicolon/ai-kit add django --cwd apps/web
+npx @smicolon/ai-kit@latest init --cwd apps/web
+npx @smicolon/ai-kit@latest add django --cwd apps/web
 ```
 
 ## License

package/dist/index.js

@@ -1,13 +1,13 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { Command as Command6 } from "commander";
+import { Command as Command7 } from "commander";
 
 // src/commands/init.ts
 import { Command } from "commander";
 import * as p from "@clack/prompts";
 import pc from "picocolors";
-import path5 from "path";
+import path6 from "path";
 
 // src/tools.ts
 var TOOL_REGISTRY = {
@@ -182,6 +182,8 @@ function resolvePack(plugin, marketplaceDir) {
     name: plugin.name,
     version: plugin.version,
     description: plugin.description,
+    category: plugin.category ?? "",
+    keywords: plugin.keywords ?? [],
     sourceDir,
     agents: resolveFiles(plugin.agents),
     commands: resolveFiles(plugin.commands),
@@ -201,10 +203,10 @@ function discoverPacks(startDir) {
   }
   const marketplaceDir = path.dirname(path.dirname(marketplacePath));
   const raw = JSON.parse(fs.readFileSync(marketplacePath, "utf-8"));
-  return raw.plugins.map((p2) => resolvePack(p2, marketplaceDir)).filter((p2) => fs.existsSync(p2.sourceDir));
+  return raw.plugins.map((p3) => resolvePack(p3, marketplaceDir)).filter((p3) => fs.existsSync(p3.sourceDir));
 }
 function findPack(name, startDir) {
-  return discoverPacks(startDir).find((p2) => p2.name === name);
+  return discoverPacks(startDir).find((p3) => p3.name === name);
 }
 
 // src/config.ts
@@ -258,6 +260,11 @@ function createDefaultConfig(tools) {
 import fs3 from "fs";
 import path3 from "path";
 var MANAGED_COMMENT = "# AI coding tools (managed by @smicolon/ai-kit)";
+var LOCAL_PATTERNS = [
+  ".ai-kit.json",
+  "**/*.local.*",
+  "**/*.local.md"
+];
 function findGitRoot(startDir) {
   let dir = startDir;
   while (true) {
@@ -295,15 +302,15 @@ ${newEntries.join("\n")}
   }
   fs3.writeFileSync(gitignorePath, updated);
 }
-function updateGitignore(projectDir, dirs) {
-  if (dirs.length === 0) return;
-  const entries = dirs.map((d) => d.endsWith("/") ? d : `${d}/`);
+function updateGitignore(projectDir) {
   const projectGitignore = path3.join(projectDir, ".gitignore");
-  appendToGitignore(projectGitignore, entries);
+  appendToGitignore(projectGitignore, LOCAL_PATTERNS);
   const gitRoot = findGitRoot(projectDir);
   if (gitRoot && path3.resolve(gitRoot) !== path3.resolve(projectDir)) {
     const relFromRoot = path3.relative(gitRoot, projectDir);
-    const rootEntries = entries.map((e) => `${relFromRoot}/${e}`);
+    const rootEntries = LOCAL_PATTERNS.map(
+      (e) => e.startsWith("**/") ? e : `${relFromRoot}/${e}`
+    );
     appendToGitignore(path3.join(gitRoot, ".gitignore"), rootEntries);
   }
 }
@@ -565,32 +572,51 @@ function removePack2(projectDir, files) {
   }
   return removed;
 }
-function isSymlink(p2) {
+function isSymlink(p3) {
   try {
-    return fs5.lstatSync(p2).isSymbolicLink();
+    return fs5.lstatSync(p3).isSymbolicLink();
   } catch {
     return false;
   }
 }
-function getWrittenDirs(tools, hadSkills) {
-  const dirs = /* @__PURE__ */ new Set();
-  if (hadSkills) {
-    dirs.add(CANONICAL_SKILLS_DIR);
-  }
-  for (const toolId of tools) {
-    const config = TOOL_REGISTRY[toolId];
-    for (const dir of Object.values(config.components)) {
-      const topLevel = dir.split("/")[0];
-      dirs.add(topLevel);
-    }
+
+// src/global-config.ts
+import fs6 from "fs";
+import path5 from "path";
+import os from "os";
+function getConfigDir() {
+  return path5.join(os.homedir(), ".config", "ai-kit");
+}
+function getConfigPath() {
+  return path5.join(getConfigDir(), "config.json");
+}
+function readGlobalConfig() {
+  const fp = getConfigPath();
+  if (!fs6.existsSync(fp)) return null;
+  try {
+    return JSON.parse(fs6.readFileSync(fp, "utf-8"));
+  } catch {
+    return null;
   }
-  return [...dirs];
+}
+function writeGlobalConfig(config) {
+  const dir = getConfigDir();
+  fs6.mkdirSync(dir, { recursive: true });
+  fs6.writeFileSync(getConfigPath(), JSON.stringify(config, null, 2) + "\n");
+}
+function getGlobalTools() {
+  const config = readGlobalConfig();
+  return config?.tools ?? null;
+}
+function saveGlobalTools(tools) {
+  const existing = readGlobalConfig();
+  writeGlobalConfig({ ...existing, tools });
 }
 
 // src/commands/init.ts
 var initCommand = new Command("init").description("Interactive first-time setup").option("--cwd <dir>", "Project directory (for monorepo sub-packages)").action(async (opts) => {
   p.intro(pc.bgCyan(pc.black(" ai-kit ")));
-  const projectDir = opts.cwd ? path5.resolve(opts.cwd) : process.cwd();
+  const projectDir = opts.cwd ? path6.resolve(opts.cwd) : process.cwd();
   const existing = readConfig(projectDir);
   if (existing) {
     const action = await p.select({
@@ -610,13 +636,15 @@ var initCommand = new Command("init").description("Interactive first-time setup"
       return;
     }
   }
-  const toolSelection = await p.multiselect({
-    message: "Which AI coding tools do you use?",
+  const savedTools = getGlobalTools();
+  const toolSelection = await p.autocompleteMultiselect({
+    message: "Which AI coding tools do you use? (type to filter)",
     options: TOOL_IDS.map((id) => ({
       value: id,
       label: TOOL_REGISTRY[id].label,
       hint: TOOL_REGISTRY[id].hint
     })),
+    initialValues: savedTools ?? [],
     required: true
   });
   if (p.isCancel(toolSelection)) {
@@ -624,6 +652,7 @@ var initCommand = new Command("init").description("Interactive first-time setup"
     return;
   }
   const selectedTools = toolSelection;
+  saveGlobalTools(selectedTools);
   let packs;
   try {
     packs = discoverPacks();
@@ -632,8 +661,8 @@ var initCommand = new Command("init").description("Interactive first-time setup"
     p.outro("Setup failed.");
     return;
   }
-  const packSelection = await p.multiselect({
-    message: "What's your stack?",
+  const packSelection = await p.autocompleteMultiselect({
+    message: "Which packs do you want to install? (type to filter)",
     options: packs.map((pack) => ({
       value: pack.name,
       label: pack.name,
@@ -682,8 +711,7 @@ var initCommand = new Command("init").description("Interactive first-time setup"
   const s = p.spinner();
   s.start("Installing packs...");
   let config = createDefaultConfig(selectedTools);
-  const selectedPacks = packs.filter((p2) => selectedPackNames.includes(p2.name));
-  let hadSkills = false;
+  const selectedPacks = packs.filter((p3) => selectedPackNames.includes(p3.name));
   for (const pack of selectedPacks) {
     const result = installPack({
       pack,
@@ -692,40 +720,63 @@ var initCommand = new Command("init").description("Interactive first-time setup"
       projectDir
     });
     config = mergeInstall(config, result);
-    if (result.installed.skills > 0) hadSkills = true;
   }
   writeConfig(projectDir, config);
-  updateGitignore(projectDir, getWrittenDirs(selectedTools, hadSkills));
+  updateGitignore(projectDir);
   s.stop("Done!");
   p.log.success(`Installed ${selectedPacks.length} pack(s) for ${selectedTools.length} tool(s):`);
   for (const pack of selectedPacks) {
     p.log.message(`  ${pc.green("+")} ${pack.name} ${pc.dim(`v${pack.version}`)}`);
   }
-  p.outro(pc.dim("Config saved to .ai-kit.json"));
+  p.outro(pc.dim("Run ai-kit add <pack> to add more packs anytime."));
 });
 
 // src/commands/add.ts
 import { Command as Command2 } from "commander";
-import path6 from "path";
+import path7 from "path";
 import pc2 from "picocolors";
-var addCommand = new Command2("add").description("Add a pack to your project").argument("<pack>", "Pack name (e.g., django, nextjs)").option("--skills-only", "Only install skills").option("--agents-only", "Only install agents").option("--rules-only", "Only install rules").option("--commands-only", "Only install commands").option("--hooks-only", "Only install hooks").option("--tools <tools>", "Comma-separated tool IDs (overrides config)").option("--cwd <dir>", "Project directory (for monorepo sub-packages)").action(async (packName, opts) => {
-  const projectDir = opts.cwd ? path6.resolve(opts.cwd) : process.cwd();
+import * as p2 from "@clack/prompts";
+async function resolveTools(toolsFlag, projectDir) {
+  if (toolsFlag) {
+    return toolsFlag.split(",").map((t) => t.trim());
+  }
   const config = readConfig(projectDir);
-  if (!config) {
-    console.error(
-      pc2.red("No .ai-kit.json found. Run ") + pc2.cyan("ai-kit init") + pc2.red(" first.")
-    );
-    process.exit(1);
+  if (config?.tools?.length) {
+    return config.tools;
   }
+  const globalTools = getGlobalTools();
+  if (globalTools?.length) {
+    return globalTools;
+  }
+  const selection = await p2.autocompleteMultiselect({
+    message: "Which AI coding tools do you use? (type to filter)",
+    options: TOOL_IDS.map((id) => ({
+      value: id,
+      label: TOOL_REGISTRY[id].label,
+      hint: TOOL_REGISTRY[id].hint
+    })),
+    required: true
+  });
+  if (p2.isCancel(selection)) return null;
+  const tools = selection;
+  saveGlobalTools(tools);
+  return tools;
+}
+var addCommand = new Command2("add").description("Add a pack to your project").argument("<pack>", "Pack name (e.g., django, nextjs)").option("--skills-only", "Only install skills").option("--agents-only", "Only install agents").option("--rules-only", "Only install rules").option("--commands-only", "Only install commands").option("--hooks-only", "Only install hooks").option("--tools <tools>", "Comma-separated tool IDs (overrides config)").option("--cwd <dir>", "Project directory (for monorepo sub-packages)").action(async (packName, opts) => {
+  const projectDir = opts.cwd ? path7.resolve(opts.cwd) : process.cwd();
   const pack = findPack(packName);
   if (!pack) {
-    const available = discoverPacks().map((p2) => p2.name);
+    const available = discoverPacks().map((p3) => p3.name);
     console.error(
       pc2.red(`Pack "${packName}" not found.`) + "\nAvailable: " + available.join(", ")
     );
     process.exit(1);
   }
-  const tools = opts.tools ? opts.tools.split(",").map((t) => t.trim()) : config.tools;
+  const tools = await resolveTools(opts.tools, projectDir);
+  if (!tools) {
+    console.log(pc2.dim("Cancelled."));
+    return;
+  }
   let filter;
   if (opts.skillsOnly) filter = ["skills"];
   else if (opts.agentsOnly) filter = ["agents"];
@@ -733,10 +784,12 @@ var addCommand = new Command2("add").description("Add a pack to your project").a
   else if (opts.commandsOnly) filter = ["commands"];
   else if (opts.hooksOnly) filter = ["hooks"];
   const result = installPack({ pack, tools, filter, projectDir });
+  let config = readConfig(projectDir) ?? createDefaultConfig(tools);
+  config.tools = tools;
   const updated = mergeInstall(config, result);
   updated.packs[pack.name].version = pack.version;
   writeConfig(projectDir, updated);
-  updateGitignore(projectDir, getWrittenDirs(tools, result.installed.skills > 0));
+  updateGitignore(projectDir);
   const parts = [];
   for (const [type, count] of Object.entries(result.installed)) {
     if (count > 0) parts.push(`${count} ${type}`);
@@ -798,14 +851,14 @@ ${pc3.dim(`${packs.length} packs available`)}`);
 
 // src/commands/remove.ts
 import { Command as Command4 } from "commander";
-import path7 from "path";
+import path8 from "path";
 import pc4 from "picocolors";
 var removeCommand = new Command4("remove").description("Remove a pack from your project").argument("<pack>", "Pack name to remove").option("--cwd <dir>", "Project directory").action((packName, opts) => {
-  const projectDir = opts.cwd ? path7.resolve(opts.cwd) : process.cwd();
+  const projectDir = opts.cwd ? path8.resolve(opts.cwd) : process.cwd();
   const config = readConfig(projectDir);
   if (!config) {
-    console.error(pc4.red("No .ai-kit.json found."));
-    process.exit(1);
+    console.log(pc4.dim("No packs installed."));
+    return;
   }
   const packConfig = config.packs[packName];
   if (!packConfig) {
@@ -828,23 +881,19 @@ var removeCommand = new Command4("remove").description("Remove a pack from your
 
 // src/commands/update.ts
 import { Command as Command5 } from "commander";
-import path8 from "path";
+import path9 from "path";
 import pc5 from "picocolors";
-var updateCommand = new Command5("update").description("Update installed packs").argument("[pack]", "Pack name (omit to update all)").option("--cwd <dir>", "Project directory").action((packName, opts) => {
-  const projectDir = opts.cwd ? path8.resolve(opts.cwd) : process.cwd();
+var updateCommand = new Command5("update").description("Update installed packs").argument("[pack]", "Pack name (omit to update all)").option("--cwd <dir>", "Project directory").action(async (packName, opts) => {
+  const projectDir = opts.cwd ? path9.resolve(opts.cwd) : process.cwd();
   const config = readConfig(projectDir);
-  if (!config) {
-    console.error(pc5.red("No .ai-kit.json found. Run ") + pc5.cyan("ai-kit init") + pc5.red(" first."));
-    process.exit(1);
-  }
-  const packsToUpdate = packName ? [packName] : Object.keys(config.packs);
-  if (packsToUpdate.length === 0) {
-    console.log(pc5.dim("No packs installed."));
+  if (!config || Object.keys(config.packs).length === 0) {
+    console.log(pc5.dim("No packs installed yet. Starting setup...\n"));
+    await initCommand.parseAsync(["init", ...opts.cwd ? ["--cwd", opts.cwd] : []], { from: "user" });
     return;
   }
+  const packsToUpdate = packName ? [packName] : Object.keys(config.packs);
   let updated = 0;
   let skipped = 0;
-  let hadSkills = false;
   for (const name of packsToUpdate) {
     const installed = config.packs[name];
     if (!installed) {
@@ -874,14 +923,13 @@ var updateCommand = new Command5("update").description("Update installed packs")
     const merged = mergeInstall(config, result);
     merged.packs[name].version = available.version;
     Object.assign(config, merged);
-    if (result.installed.skills > 0) hadSkills = true;
     console.log(
       pc5.green(`  ${name}`) + ` ${pc5.dim(installed.version)} \u2192 ${pc5.cyan(available.version)}`
     );
     updated++;
   }
   writeConfig(projectDir, config);
-  updateGitignore(projectDir, getWrittenDirs(config.tools, hadSkills));
+  updateGitignore(projectDir);
   if (updated > 0) {
     console.log(pc5.green(`
 Updated ${updated} pack(s).`));
@@ -891,11 +939,57 @@ Updated ${updated} pack(s).`));
   }
 });
 
+// src/commands/search.ts
+import { Command as Command6 } from "commander";
+import pc6 from "picocolors";
+var searchCommand = new Command6("search").description("Search available packs by name or keyword").argument("<query>", "Search term (matches name, description, keywords)").action((query) => {
+  let packs;
+  try {
+    packs = discoverPacks();
+  } catch {
+    console.error(pc6.red("Could not find marketplace.json."));
+    process.exit(1);
+  }
+  const q = query.toLowerCase();
+  const matches = packs.filter((pack) => {
+    const haystack = [
+      pack.name,
+      pack.description,
+      pack.category,
+      ...pack.keywords
+    ].join(" ").toLowerCase();
+    return haystack.includes(q);
+  });
+  if (matches.length === 0) {
+    console.log(pc6.dim(`No packs matching "${query}".`));
+    console.log(pc6.dim(`
+All packs: ${packs.map((p3) => p3.name).join(", ")}`));
+    return;
+  }
+  console.log(pc6.bold(`Found ${matches.length} pack(s):
+`));
+  for (const pack of matches) {
+    const counts = [];
+    if (pack.agents.length) counts.push(`${pack.agents.length} agents`);
+    if (pack.skills.length) counts.push(`${pack.skills.length} skills`);
+    if (pack.commands.length) counts.push(`${pack.commands.length} commands`);
+    if (pack.rules.length) counts.push(`${pack.rules.length} rules`);
+    console.log(
+      `  ${pc6.cyan(pack.name)} ${pc6.dim(`v${pack.version}`)}
+    ${pack.description}
+    ${pc6.dim(counts.join(", "))}
+    ${pc6.dim(`Install: npx @smicolon/ai-kit@latest add ${pack.name}`)}
+`
+    );
+  }
+});
+
 // src/index.ts
-var program = new Command6().name("ai-kit").description("AI coding tool pack manager").version("0.0.1");
+var program = new Command7().name("ai-kit").description("AI coding tool pack manager").version("0.0.1");
 program.addCommand(initCommand);
 program.addCommand(addCommand);
 program.addCommand(listCommand);
 program.addCommand(removeCommand);
 program.addCommand(updateCommand);
+program.addCommand(searchCommand);
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@smicolon/ai-kit",
-  "version": "0.1.1",
+  "version": "0.2.1",
   "description": "AI coding tool pack manager for Smicolon standards",
   "license": "MIT",
   "repository": {