@kitnai/cli 0.1.32 → 0.1.34

package/dist/index.js

@@ -163,8 +163,8 @@ import { z } from "zod";
 function getRegistryUrl(entry) {
   return typeof entry === "string" ? entry : entry.url;
 }
-function resolveRoutesAlias(config) {
-  const fw = config.framework ?? "hono";
+function resolveRoutesAlias(config2) {
+  const fw = config2.framework ?? "hono";
   return FRAMEWORK_TO_ADAPTER[fw] ?? fw;
 }
 async function readConfig(projectDir) {
@@ -175,8 +175,8 @@ async function readConfig(projectDir) {
     return null;
   }
 }
-async function writeConfig(projectDir, config) {
-  const data = { $schema: "https://kitn.dev/schema/config.json", ...config };
+async function writeConfig(projectDir, config2) {
+  const data = { $schema: "https://kitn.dev/schema/config.json", ...config2 };
   await writeFile2(join3(projectDir, CONFIG_FILE), JSON.stringify(data, null, 2) + "\n");
 }
 async function readLock(projectDir) {
@@ -197,17 +197,17 @@ async function writeLock(projectDir, lock) {
   }
   await writeFile2(join3(projectDir, LOCK_FILE), JSON.stringify(lock, null, 2) + "\n");
 }
-function getInstallPath(config, type, fileName, namespace) {
+function getInstallPath(config2, type, fileName, namespace) {
   const aliasKey = typeToAliasKey[type];
-  const baseAlias = config.aliases.base ?? "src/ai";
-  const base = config.aliases[aliasKey] ?? join3(baseAlias, aliasKey);
+  const baseAlias = config2.aliases.base ?? "src/ai";
+  const base = config2.aliases[aliasKey] ?? join3(baseAlias, aliasKey);
   if (namespace && namespace !== "@kitn") {
     const nsDir = namespace.replace("@", "");
     return join3(base, nsDir, fileName);
   }
   return join3(base, fileName);
 }
-var componentType, installedComponentSchema, registryEntrySchema, registryValueSchema, configSchema, FRAMEWORK_TO_ADAPTER, CONFIG_FILE, LOCK_FILE, lockSchema, typeToAliasKey;
+var componentType, installedComponentSchema, registryEntrySchema, registryValueSchema, DEFAULT_REGISTRY_URL, DEFAULT_REGISTRIES, DEFAULT_ALIASES, configSchema, FRAMEWORK_TO_ADAPTER, CONFIG_FILE, LOCK_FILE, lockSchema, typeToAliasKey;
 var init_config = __esm({
   "src/utils/config.ts"() {
     "use strict";
@@ -228,6 +228,22 @@ var init_config = __esm({
       description: z.string().optional()
     });
     registryValueSchema = z.union([z.string(), registryEntrySchema]);
+    DEFAULT_REGISTRY_URL = "https://kitn-ai.github.io/kitn/r/{type}/{name}.json";
+    DEFAULT_REGISTRIES = {
+      "@kitn": {
+        url: DEFAULT_REGISTRY_URL,
+        homepage: "https://kitn.ai",
+        description: "Official kitn AI agent components"
+      }
+    };
+    DEFAULT_ALIASES = {
+      base: "src/ai",
+      agents: "src/ai/agents",
+      tools: "src/ai/tools",
+      skills: "src/ai/skills",
+      storage: "src/ai/storage",
+      crons: "src/ai/crons"
+    };
     configSchema = z.object({
       $schema: z.string().optional(),
       runtime: z.enum(["bun", "node", "deno"]),
@@ -241,7 +257,9 @@ var init_config = __esm({
         crons: z.string().optional()
       }),
       registries: z.record(z.string(), registryValueSchema),
-      aiTools: z.array(z.string()).optional()
+      chatService: z.object({
+        url: z.string().optional()
+      }).optional()
     });
     FRAMEWORK_TO_ADAPTER = {
       hono: "hono",
@@ -268,38 +286,38 @@ function stripJsonc(text3) {
   return text3.replace(/\/\/.*$/gm, "").replace(/\/\*[\s\S]*?\*\//g, "").replace(/,\s*([}\]])/g, "$1");
 }
 function patchTsconfig(tsconfigContent, paths, removePrefixes) {
-  const config = JSON.parse(stripJsonc(tsconfigContent));
-  if (!config.compilerOptions) {
-    config.compilerOptions = {};
+  const config2 = JSON.parse(stripJsonc(tsconfigContent));
+  if (!config2.compilerOptions) {
+    config2.compilerOptions = {};
   }
-  if (!config.compilerOptions.paths) {
-    config.compilerOptions.paths = {};
+  if (!config2.compilerOptions.paths) {
+    config2.compilerOptions.paths = {};
   }
   if (removePrefixes) {
-    for (const key of Object.keys(config.compilerOptions.paths)) {
+    for (const key of Object.keys(config2.compilerOptions.paths)) {
       if (removePrefixes.some((prefix) => key.startsWith(prefix))) {
-        delete config.compilerOptions.paths[key];
+        delete config2.compilerOptions.paths[key];
       }
     }
   }
   for (const [key, value] of Object.entries(paths)) {
-    config.compilerOptions.paths[key] = value;
+    config2.compilerOptions.paths[key] = value;
   }
   const ES_TARGETS = ["es3", "es5", "es6", "es2015", "es2016", "es2017", "es2018", "es2019", "es2020", "es2021"];
-  const currentTarget = (config.compilerOptions.target ?? "").toLowerCase();
+  const currentTarget = (config2.compilerOptions.target ?? "").toLowerCase();
   if (!currentTarget || ES_TARGETS.includes(currentTarget)) {
-    config.compilerOptions.target = "ES2022";
+    config2.compilerOptions.target = "ES2022";
   }
-  if (!config.compilerOptions.moduleResolution) {
-    config.compilerOptions.moduleResolution = "bundler";
+  if (!config2.compilerOptions.moduleResolution) {
+    config2.compilerOptions.moduleResolution = "bundler";
   }
-  if (!config.compilerOptions.module) {
-    config.compilerOptions.module = "ESNext";
+  if (!config2.compilerOptions.module) {
+    config2.compilerOptions.module = "ESNext";
   }
-  if (config.compilerOptions.skipLibCheck === void 0) {
-    config.compilerOptions.skipLibCheck = true;
+  if (config2.compilerOptions.skipLibCheck === void 0) {
+    config2.compilerOptions.skipLibCheck = true;
   }
-  return JSON.stringify(config, null, 2) + "\n";
+  return JSON.stringify(config2, null, 2) + "\n";
 }
 async function patchProjectTsconfig(projectDir, paths, removePrefixes) {
   const tsconfigPath = join4(projectDir, "tsconfig.json");
@@ -581,8 +599,8 @@ async function handleEnvVars(cwd, envVars) {
     const lines = [];
     if (exampleContent && !exampleContent.endsWith("\n")) lines.push("");
     for (const key of missingFromExample) {
-      const config = envVars[key];
-      lines.push(`# ${config.description}${config.url ? ` (${config.url})` : ""}`);
+      const config2 = envVars[key];
+      lines.push(`# ${config2.description}${config2.url ? ` (${config2.url})` : ""}`);
       lines.push(`${key}=`);
     }
     await writeFile5(examplePath, exampleContent + lines.join("\n") + "\n");
@@ -594,9 +612,9 @@ async function handleEnvVars(cwd, envVars) {
     `${missingFromEnv.length} environment variable(s) needed:`
   );
   for (const key of missingFromEnv) {
-    const config = envVars[key];
-    const req = config.required !== false ? pc2.red("*") : "";
-    p.log.message(`  ${pc2.yellow(key)}${req}: ${config.description}${config.url ? pc2.dim(` -> ${config.url}`) : ""}`);
+    const config2 = envVars[key];
+    const req = config2.required !== false ? pc2.red("*") : "";
+    p.log.message(`  ${pc2.yellow(key)}${req}: ${config2.description}${config2.url ? pc2.dim(` -> ${config2.url}`) : ""}`);
   }
   const shouldPrompt = await p.confirm({
     message: "Would you like to enter values now?",
@@ -608,8 +626,8 @@ async function handleEnvVars(cwd, envVars) {
   }
   const newEntries = [];
   for (const key of missingFromEnv) {
-    const config = envVars[key];
-    const isSecret = config.secret !== false;
+    const config2 = envVars[key];
+    const isSecret = config2.secret !== false;
     let value;
     if (isSecret) {
       value = await p.password({
@@ -618,7 +636,7 @@ async function handleEnvVars(cwd, envVars) {
     } else {
       value = await p.text({
         message: `${key}:`,
-        placeholder: config.description
+        placeholder: config2.description
       });
     }
     if (p.isCancel(value)) {
@@ -867,18 +885,18 @@ import { relative as relative2 } from "path";
 async function addCommand(components, opts) {
   p2.intro(pc3.bgCyan(pc3.black(" kitn add ")));
   const cwd = process.cwd();
-  const config = await readConfig(cwd);
-  if (!config) {
+  const config2 = await readConfig(cwd);
+  if (!config2) {
     p2.log.error("No kitn.json found. Run `kitn init` first.");
     process.exit(1);
   }
   const lock = await readLock(cwd);
   if (components.length === 0) {
-    const fetcher2 = new RegistryFetcher(config.registries);
+    const fetcher2 = new RegistryFetcher(config2.registries);
     const s2 = p2.spinner();
     s2.start("Fetching registry...");
     const allItems = [];
-    for (const namespace of Object.keys(config.registries)) {
+    for (const namespace of Object.keys(config2.registries)) {
       try {
         const index = await fetcher2.fetchIndex(namespace);
         for (const item of index.items) {
@@ -957,18 +975,18 @@ async function addCommand(components, opts) {
   }
   const resolvedComponents = components.map((c) => {
     if (c === "routes") {
-      return resolveRoutesAlias(config);
+      return resolveRoutesAlias(config2);
     }
     return c;
   });
   const refs = resolvedComponents.map(parseComponentRef);
-  const fetcher = new RegistryFetcher(config.registries);
+  const fetcher = new RegistryFetcher(config2.registries);
   const s = p2.spinner();
   s.start("Resolving dependencies...");
   const preResolvedTypes = /* @__PURE__ */ new Map();
   let expandedNames = [...resolvedComponents];
   try {
-    const namespacesToFetch = Object.keys(config.registries);
+    const namespacesToFetch = Object.keys(config2.registries);
     const allIndexItems = [];
     for (const namespace of namespacesToFetch) {
       try {
@@ -1110,7 +1128,7 @@ async function addCommand(components, opts) {
     }
   }
   if (slotReplacements.size > 0) {
-    const baseDir2 = config.aliases.base ?? "src/ai";
+    const baseDir2 = config2.aliases.base ?? "src/ai";
     for (const [oldKey] of slotReplacements) {
       const oldEntry = lock[oldKey];
       if (!oldEntry) continue;
@@ -1122,9 +1140,9 @@ async function addCommand(components, opts) {
       }
       const barrelPath2 = join7(cwd, baseDir2, "index.ts");
       const barrelEligibleDirs = /* @__PURE__ */ new Set([
-        config.aliases.agents,
-        config.aliases.tools,
-        config.aliases.skills
+        config2.aliases.agents,
+        config2.aliases.tools,
+        config2.aliases.skills
       ]);
       if (existsSync(barrelPath2)) {
         let barrelContent = await readFile6(barrelPath2, "utf-8");
@@ -1170,8 +1188,8 @@ async function addCommand(components, opts) {
   if (!opts.yes && process.stdin.isTTY) {
     const totalComponents = resolved.length;
     const summary = totalDeps > 0 ? `Install ${totalComponents} component(s) and ${totalDeps} npm package(s)?` : `Install ${totalComponents} component(s)?`;
-    const confirm6 = await p2.confirm({ message: summary });
-    if (p2.isCancel(confirm6) || !confirm6) {
+    const confirm7 = await p2.confirm({ message: summary });
+    if (p2.isCancel(confirm7) || !confirm7) {
       p2.cancel("Cancelled.");
       process.exit(0);
     }
@@ -1188,7 +1206,7 @@ async function addCommand(components, opts) {
       }
     }
     if (item.type === "kitn:package") {
-      const baseDir2 = config.aliases.base ?? "src/ai";
+      const baseDir2 = config2.aliases.base ?? "src/ai";
       for (const file of item.files) {
         const targetPath = join7(cwd, baseDir2, file.path);
         const relativePath = join7(baseDir2, file.path);
@@ -1258,10 +1276,10 @@ async function addCommand(components, opts) {
           }
         })();
         const fileName = file.path.split("/").pop();
-        const installPath = getInstallPath(config, item.type, fileName, ns);
+        const installPath = getInstallPath(config2, item.type, fileName, ns);
         const targetPath = join7(cwd, installPath);
         const relativePath = installPath;
-        const content = rewriteKitnImports(file.content, item.type, fileName, config.aliases);
+        const content = rewriteKitnImports(file.content, item.type, fileName, config2.aliases);
         const status = await checkFileStatus(targetPath, content);
         switch (status) {
           case "new" /* New */:
@@ -1298,7 +1316,7 @@ async function addCommand(components, opts) {
       }
       const allContent = item.files.map((f) => {
         const fn = f.path.split("/").pop();
-        return rewriteKitnImports(f.content, item.type, fn, config.aliases);
+        return rewriteKitnImports(f.content, item.type, fn, config2.aliases);
       }).join("\n");
       const installedKey = ns === "@kitn" ? item.name : `${ns}/${item.name}`;
       lock[installedKey] = {
@@ -1309,7 +1327,7 @@ async function addCommand(components, opts) {
         installedAt: (/* @__PURE__ */ new Date()).toISOString(),
         files: item.files.map((f) => {
           const fileName = f.path.split("/").pop();
-          return getInstallPath(config, item.type, fileName, ns);
+          return getInstallPath(config2, item.type, fileName, ns);
         }),
         hash: contentHash(allContent),
         registryDependencies: item.registryDependencies
@@ -1317,7 +1335,7 @@ async function addCommand(components, opts) {
     }
   }
   const BARREL_ELIGIBLE = /* @__PURE__ */ new Set(["kitn:agent", "kitn:tool", "kitn:skill", "kitn:cron"]);
-  const baseDir = config.aliases.base ?? "src/ai";
+  const baseDir = config2.aliases.base ?? "src/ai";
   const barrelPath = join7(cwd, baseDir, "index.ts");
   const barrelDir = join7(cwd, baseDir);
   const barrelImports = [];
@@ -1326,7 +1344,7 @@ async function addCommand(components, opts) {
     const ref = refs.find((r) => r.name === item.name) ?? { namespace: "@kitn", name: item.name, version: void 0 };
     for (const file of item.files) {
       const fileName = file.path.split("/").pop();
-      const installPath = getInstallPath(config, item.type, fileName, ref.namespace);
+      const installPath = getInstallPath(config2, item.type, fileName, ref.namespace);
       const filePath = join7(cwd, installPath);
       const importPath = "./" + relative2(barrelDir, filePath).replace(/\\/g, "/");
       barrelImports.push(importPath);
@@ -1357,7 +1375,7 @@ async function addCommand(components, opts) {
       );
     }
   }
-  await writeConfig(cwd, config);
+  await writeConfig(cwd, config2);
   await writeLock(cwd, lock);
   if (totalDeps > 0) {
     const pm = await detectPackageManager(cwd);
@@ -1394,7 +1412,7 @@ async function addCommand(components, opts) {
   const resolvedNames = new Set(resolved.map((r) => r.name));
   const projectInstalled = new Set(Object.keys(lock));
   const hints = [];
-  const adapterName = resolveRoutesAlias(config);
+  const adapterName = resolveRoutesAlias(config2);
   if (resolvedNames.has("core") && !resolvedNames.has(adapterName) && !projectInstalled.has(adapterName)) {
     hints.push(`Run ${pc3.cyan(`kitn add routes`)} to install the HTTP adapter.`);
   }
@@ -1423,8 +1441,14 @@ var init_add = __esm({
 });
 
 // src/installers/rules-generator.ts
-import { writeFile as writeFile7, mkdir as mkdir4 } from "fs/promises";
+import { writeFile as writeFile7, mkdir as mkdir4, readFile as readFile7 } from "fs/promises";
 import { join as join8, dirname as dirname4 } from "path";
+async function loadFallbackTemplate() {
+  if (!_fallbackTemplate) {
+    _fallbackTemplate = await readFile7(TEMPLATE_PATH, "utf-8");
+  }
+  return _fallbackTemplate;
+}
 function deriveRulesBaseUrl(registries) {
   const kitnEntry = registries["@kitn"];
   if (!kitnEntry) {
@@ -1450,7 +1474,7 @@ async function fetchRulesTemplate(registries) {
     if (!res.ok) throw new Error(`HTTP ${res.status}`);
     return await res.text();
   } catch {
-    return FALLBACK_TEMPLATE;
+    return loadFallbackTemplate();
   }
 }
 function renderTemplate(template, aliases) {
@@ -1470,10 +1494,10 @@ ${content}`;
   }
   return content;
 }
-async function generateRulesFiles(cwd, config, selectedToolIds) {
-  const rulesConfig = await fetchRulesConfig(config.registries);
-  const template = await fetchRulesTemplate(config.registries);
-  const rendered = renderTemplate(template, config.aliases);
+async function generateRulesFiles(cwd, config2, selectedToolIds) {
+  const rulesConfig = await fetchRulesConfig(config2.registries);
+  const template = await fetchRulesTemplate(config2.registries);
+  const rendered = renderTemplate(template, config2.aliases);
   const toolsToWrite = selectedToolIds ? rulesConfig.tools.filter((t) => selectedToolIds.includes(t.id)) : rulesConfig.tools;
   const written = [];
   for (const tool of toolsToWrite) {
@@ -1485,11 +1509,12 @@ async function generateRulesFiles(cwd, config, selectedToolIds) {
   }
   return written;
 }
-var FALLBACK_CONFIG, FALLBACK_TEMPLATE;
+var TEMPLATE_PATH, FALLBACK_CONFIG, _fallbackTemplate;
 var init_rules_generator = __esm({
   "src/installers/rules-generator.ts"() {
     "use strict";
     init_config();
+    TEMPLATE_PATH = join8(import.meta.dirname, "rules-template.md");
     FALLBACK_CONFIG = {
       version: "1.0.0",
       tools: [
@@ -1507,7 +1532,7 @@ var init_rules_generator = __esm({
           format: "mdc",
           frontmatter: {
             description: "kitn AI agent framework conventions and patterns",
-            globs: "src/ai/**/*.ts, kitn.json"
+            globs: "src/ai/**/*.ts, src/ai/**/*.md, kitn.json, kitn.lock"
           }
         },
         {
@@ -1530,34 +1555,6 @@ var init_rules_generator = __esm({
         }
       ]
     };
-    FALLBACK_TEMPLATE = `# kitn AI Agent Framework
-
-This project uses **kitn** to build multi-agent AI systems.
-
-## Project Structure
-
-AI components live under \`{base}\`:
-
-- \`{agents}/\` \u2014 Agent definitions
-- \`{tools}/\` \u2014 Tool definitions
-- \`{skills}/\` \u2014 Skill files (markdown)
-- \`{storage}/\` \u2014 Storage providers
-- \`{crons}/\` \u2014 Cron job definitions
-
-## Patterns
-
-- Agents: \`registerAgent({ name, system, tools })\` from \`@kitn/core\`
-- Tools: \`tool()\` from \`ai\` + \`registerTool()\` from \`@kitn/core\`
-- Always use \`.js\` extension in relative imports
-- Use \`@kitn/core\` for core imports, \`ai\` for Vercel AI SDK
-
-## CLI
-
-- \`kitn add <name>\` \u2014 install from registry
-- \`kitn create <type> <name>\` \u2014 scaffold locally
-- \`kitn link tool <name> --to <agent>\` \u2014 wire a tool to an agent
-- \`kitn list\` \u2014 browse components
-`;
   }
 });
 
@@ -1568,11 +1565,11 @@ __export(init_exports, {
 });
 import * as p3 from "@clack/prompts";
 import pc4 from "picocolors";
-import { mkdir as mkdir5, readFile as readFile7, writeFile as writeFile8 } from "fs/promises";
+import { mkdir as mkdir5, readFile as readFile8, writeFile as writeFile8 } from "fs/promises";
 import { join as join9 } from "path";
 async function detectFramework(cwd) {
   try {
-    const pkg = JSON.parse(await readFile7(join9(cwd, "package.json"), "utf-8"));
+    const pkg = JSON.parse(await readFile8(join9(cwd, "package.json"), "utf-8"));
     const deps = { ...pkg.dependencies, ...pkg.devDependencies };
     if (deps["elysia"]) return "elysia";
     if (deps["@hono/zod-openapi"]) return "hono-openapi";
@@ -1660,15 +1657,15 @@ async function initCommand(opts = {}) {
     framework = detected;
     p3.log.info(`Detected ${pc4.bold(detected)} from package.json`);
     if (!opts.yes) {
-      const confirm6 = await p3.confirm({
+      const confirm7 = await p3.confirm({
         message: `Use ${detected}?`,
         initialValue: true
       });
-      if (p3.isCancel(confirm6)) {
+      if (p3.isCancel(confirm7)) {
         p3.cancel("Init cancelled.");
         process.exit(0);
       }
-      if (!confirm6) {
+      if (!confirm7) {
         const selected = await p3.select({
           message: "Which HTTP framework do you use?",
           options: [
@@ -1718,7 +1715,7 @@ async function initCommand(opts = {}) {
     }
     baseDir = base;
   }
-  const config = {
+  const config2 = {
     runtime,
     framework,
     aliases: {
@@ -1730,7 +1727,7 @@ async function initCommand(opts = {}) {
     },
     registries: {
       "@kitn": {
-        url: "https://kitn-ai.github.io/kitn/r/{type}/{name}.json",
+        url: DEFAULT_REGISTRY_URL,
         homepage: "https://kitn.ai",
         description: "Official kitn AI agent components"
       }
@@ -1738,7 +1735,7 @@ async function initCommand(opts = {}) {
   };
   const s = p3.spinner();
   s.start("Writing kitn.json");
-  await writeConfig(cwd, config);
+  await writeConfig(cwd, config2);
   s.stop("Created kitn.json");
   await patchProjectTsconfig(
     cwd,
@@ -1756,7 +1753,7 @@ async function initCommand(opts = {}) {
   await writeFile8(pluginPath, getPluginTemplate(framework));
   p3.log.success(`Created ${pc4.bold(baseDir + "/plugin.ts")} \u2014 configure your AI provider there`);
   try {
-    const rulesConfig = await fetchRulesConfig(config.registries);
+    const rulesConfig = await fetchRulesConfig(config2.registries);
     let selectedToolIds;
     if (opts.yes) {
       selectedToolIds = rulesConfig.tools.map((t) => t.id);
@@ -1777,9 +1774,7 @@ async function initCommand(opts = {}) {
       }
     }
     if (selectedToolIds.length > 0) {
-      const updatedConfig = { ...config, aiTools: selectedToolIds };
-      await writeConfig(cwd, updatedConfig);
-      const written = await generateRulesFiles(cwd, updatedConfig, selectedToolIds);
+      const written = await generateRulesFiles(cwd, config2, selectedToolIds);
       for (const filePath of written) {
         p3.log.success(`Created ${pc4.bold(filePath)}`);
       }
@@ -1827,8 +1822,8 @@ import * as p4 from "@clack/prompts";
 import pc5 from "picocolors";
 async function listCommand(typeFilter, opts) {
   const cwd = process.cwd();
-  const config = await readConfig(cwd);
-  if (!config) {
+  const config2 = await readConfig(cwd);
+  if (!config2) {
     p4.log.error("No kitn.json found. Run `kitn init` first.");
     process.exit(1);
   }
@@ -1838,9 +1833,9 @@ async function listCommand(typeFilter, opts) {
     p4.log.error(`Unknown type ${pc5.bold(rawType)}. Valid types: agent, tool, skill, storage, package`);
     process.exit(1);
   }
-  const fetcher = new RegistryFetcher(config.registries);
-  const namespacesToFetch = opts.registry ? [opts.registry] : Object.keys(config.registries);
-  if (opts.registry && !config.registries[opts.registry]) {
+  const fetcher = new RegistryFetcher(config2.registries);
+  const namespacesToFetch = opts.registry ? [opts.registry] : Object.keys(config2.registries);
+  if (opts.registry && !config2.registries[opts.registry]) {
     p4.log.error(`Registry ${pc5.bold(opts.registry)} is not configured. Run ${pc5.bold("kitn registry list")} to see configured registries.`);
     process.exit(1);
   }
@@ -1953,12 +1948,12 @@ import * as p5 from "@clack/prompts";
 import { join as join10 } from "path";
 async function diffCommand(componentName) {
   const cwd = process.cwd();
-  const config = await readConfig(cwd);
-  if (!config) {
+  const config2 = await readConfig(cwd);
+  if (!config2) {
     p5.log.error("No kitn.json found. Run `kitn init` first.");
     process.exit(1);
   }
-  const input = componentName === "routes" ? resolveRoutesAlias(config) : componentName;
+  const input = componentName === "routes" ? resolveRoutesAlias(config2) : componentName;
   const ref = parseComponentRef(input);
   const lock = await readLock(cwd);
   const installedKey = ref.namespace === "@kitn" ? ref.name : `${ref.namespace}/${ref.name}`;
@@ -1968,7 +1963,7 @@ async function diffCommand(componentName) {
     process.exit(1);
   }
   const namespace = installed.registry ?? ref.namespace;
-  const fetcher = new RegistryFetcher(config.registries);
+  const fetcher = new RegistryFetcher(config2.registries);
   const index = await fetcher.fetchIndex(namespace);
   const indexItem = index.items.find((i) => i.name === ref.name);
   if (!indexItem) {
@@ -1980,7 +1975,7 @@ async function diffCommand(componentName) {
   let hasDiff = false;
   for (const file of registryItem.files) {
     if (indexItem.type === "kitn:package") {
-      const baseDir = config.aliases.base ?? "src/ai";
+      const baseDir = config2.aliases.base ?? "src/ai";
       const localPath = join10(cwd, baseDir, file.path);
       const relativePath = join10(baseDir, file.path);
       const localContent = await readExistingFile(localPath);
@@ -2006,7 +2001,7 @@ async function diffCommand(componentName) {
             return "storage";
         }
       })();
-      const localPath = join10(cwd, config.aliases[aliasKey], fileName);
+      const localPath = join10(cwd, config2.aliases[aliasKey], fileName);
       const localContent = await readExistingFile(localPath);
       if (localContent === null) {
         p5.log.warn(`${fileName}: file missing locally`);
@@ -2041,9 +2036,9 @@ __export(remove_exports, {
 import * as p6 from "@clack/prompts";
 import pc6 from "picocolors";
 import { join as join11, relative as relative3, dirname as dirname5 } from "path";
-import { unlink as unlink3, readFile as readFile8, writeFile as writeFile9 } from "fs/promises";
+import { unlink as unlink3, readFile as readFile9, writeFile as writeFile9 } from "fs/promises";
 import { existsSync as existsSync2 } from "fs";
-async function removeSingleComponent(installedKey, lock, config, cwd) {
+async function removeSingleComponent(installedKey, lock, config2, cwd) {
   const entry = lock[installedKey];
   if (!entry) return;
   const deleted = [];
@@ -2055,16 +2050,16 @@ async function removeSingleComponent(installedKey, lock, config, cwd) {
       p6.log.warn(`Could not delete ${filePath} (may have been moved or renamed)`);
     }
   }
-  const baseDir = config.aliases.base ?? "src/ai";
+  const baseDir = config2.aliases.base ?? "src/ai";
   const barrelPath = join11(cwd, baseDir, "index.ts");
   const barrelDir = join11(cwd, baseDir);
   const barrelEligibleDirs = /* @__PURE__ */ new Set([
-    config.aliases.agents,
-    config.aliases.tools,
-    config.aliases.skills
+    config2.aliases.agents,
+    config2.aliases.tools,
+    config2.aliases.skills
   ]);
   if (existsSync2(barrelPath) && deleted.length > 0) {
-    let barrelContent = await readFile8(barrelPath, "utf-8");
+    let barrelContent = await readFile9(barrelPath, "utf-8");
     let barrelChanged = false;
     for (const filePath of deleted) {
       const fileDir = dirname5(filePath);
@@ -2087,7 +2082,7 @@ async function removeSingleComponent(installedKey, lock, config, cwd) {
 ` + deleted.map((f) => `  ${pc6.red("-")} ${f}`).join("\n"));
   }
 }
-async function offerOrphanRemoval(removedDeps, lock, config, cwd) {
+async function offerOrphanRemoval(removedDeps, lock, config2, cwd) {
   if (removedDeps.size === 0) return;
   const remaining = Object.entries(lock);
   const neededDeps = /* @__PURE__ */ new Set();
@@ -2114,13 +2109,13 @@ async function offerOrphanRemoval(removedDeps, lock, config, cwd) {
   });
   if (p6.isCancel(selected)) return;
   for (const key of selected) {
-    await removeSingleComponent(key, lock, config, cwd);
+    await removeSingleComponent(key, lock, config2, cwd);
   }
 }
 async function removeCommand(componentName) {
   const cwd = process.cwd();
-  const config = await readConfig(cwd);
-  if (!config) {
+  const config2 = await readConfig(cwd);
+  if (!config2) {
     p6.log.error("No kitn.json found. Run `kitn init` first.");
     process.exit(1);
   }
@@ -2158,14 +2153,14 @@ async function removeCommand(componentName) {
       }
     }
     for (const key of selectedKeys) {
-      await removeSingleComponent(key, lock, config, cwd);
+      await removeSingleComponent(key, lock, config2, cwd);
     }
-    await offerOrphanRemoval(allRemovedDeps, lock, config, cwd);
+    await offerOrphanRemoval(allRemovedDeps, lock, config2, cwd);
     await writeLock(cwd, lock);
     p6.outro(pc6.green("Done!"));
     return;
   }
-  const input = componentName === "routes" ? resolveRoutesAlias(config) : componentName;
+  const input = componentName === "routes" ? resolveRoutesAlias(config2) : componentName;
   const ref = parseComponentRef(input);
   const installedKey = ref.namespace === "@kitn" ? ref.name : `${ref.namespace}/${ref.name}`;
   const entry = lock[installedKey];
@@ -2182,8 +2177,8 @@ async function removeCommand(componentName) {
     process.exit(0);
   }
   const removedDeps = new Set(entry.registryDependencies ?? []);
-  await removeSingleComponent(installedKey, lock, config, cwd);
-  await offerOrphanRemoval(removedDeps, lock, config, cwd);
+  await removeSingleComponent(installedKey, lock, config2, cwd);
+  await offerOrphanRemoval(removedDeps, lock, config2, cwd);
   await writeLock(cwd, lock);
 }
 var init_remove = __esm({
@@ -2204,8 +2199,8 @@ import * as p7 from "@clack/prompts";
 async function updateCommand(components) {
   if (components.length === 0) {
     const cwd = process.cwd();
-    const config = await readConfig(cwd);
-    if (!config) {
+    const config2 = await readConfig(cwd);
+    if (!config2) {
       p7.log.error("No kitn.json found. Run `kitn init` first.");
       process.exit(1);
     }
@@ -2249,7 +2244,7 @@ import * as p8 from "@clack/prompts";
 import pc7 from "picocolors";
 import { join as join12, relative as relative4 } from "path";
 import { existsSync as existsSync3 } from "fs";
-import { readFile as readFile9, writeFile as writeFile10, mkdir as mkdir6 } from "fs/promises";
+import { readFile as readFile10, writeFile as writeFile10, mkdir as mkdir6 } from "fs/promises";
 function generateAgentSource(name) {
   const camel = toCamelCase(name);
   return `import { registerAgent } from "@kitn/core";
@@ -2347,8 +2342,8 @@ async function createComponentInProject(type, name, opts) {
     );
   }
   const cwd = opts?.cwd ?? process.cwd();
-  const config = await readConfig(cwd);
-  if (!config) {
+  const config2 = await readConfig(cwd);
+  if (!config2) {
     throw new Error(
       `No kitn.json found in ${cwd}. Run ${pc7.bold("kitn init")} first.`
     );
@@ -2356,7 +2351,7 @@ async function createComponentInProject(type, name, opts) {
   const validType = type;
   const kitnType = typeToKitnType[validType];
   const fileName = validType === "skill" ? `${name}.md` : `${name}.ts`;
-  const filePath = join12(cwd, getInstallPath(config, kitnType, fileName));
+  const filePath = join12(cwd, getInstallPath(config2, kitnType, fileName));
   const dummyContent = "";
   const status = await checkFileStatus(filePath, dummyContent);
   if (status !== "new" /* New */) {
@@ -2383,11 +2378,11 @@ async function createComponentInProject(type, name, opts) {
   await writeComponentFile(filePath, source);
   let barrelUpdated = false;
   if (BARREL_TYPES.includes(validType)) {
-    const baseDir = config.aliases.base ?? "src/ai";
+    const baseDir = config2.aliases.base ?? "src/ai";
     const barrelPath = join12(cwd, baseDir, "index.ts");
     let barrelContent;
     if (existsSync3(barrelPath)) {
-      barrelContent = await readFile9(barrelPath, "utf-8");
+      barrelContent = await readFile10(barrelPath, "utf-8");
     } else {
       barrelContent = createBarrelFile();
       await mkdir6(join12(cwd, baseDir), { recursive: true });
@@ -2439,7 +2434,7 @@ var init_create = __esm({
 });
 
 // src/utils/component-resolver.ts
-import { readdir, readFile as readFile10 } from "fs/promises";
+import { readdir, readFile as readFile11 } from "fs/promises";
 import { join as join13, relative as relative5 } from "path";
 function stripSuffix(name, suffix) {
   if (name.endsWith(`-${suffix}`)) {
@@ -2447,21 +2442,21 @@ function stripSuffix(name, suffix) {
   }
   return name;
 }
-function toolsDir(config, cwd) {
-  const baseAlias = config.aliases.base ?? "src/ai";
-  const tools = config.aliases.tools ?? join13(baseAlias, "tools");
+function toolsDir(config2, cwd) {
+  const baseAlias = config2.aliases.base ?? "src/ai";
+  const tools = config2.aliases.tools ?? join13(baseAlias, "tools");
   return join13(cwd, tools);
 }
-function agentsDir(config, cwd) {
-  const baseAlias = config.aliases.base ?? "src/ai";
-  const agents = config.aliases.agents ?? join13(baseAlias, "agents");
+function agentsDir(config2, cwd) {
+  const baseAlias = config2.aliases.base ?? "src/ai";
+  const agents = config2.aliases.agents ?? join13(baseAlias, "agents");
   return join13(cwd, agents);
 }
 async function findFile(dir, candidates) {
   for (const name of candidates) {
     const filePath = join13(dir, `${name}.ts`);
     try {
-      await readFile10(filePath);
+      await readFile11(filePath);
       return filePath;
     } catch {
     }
@@ -2483,20 +2478,20 @@ function computeImportPath(fromDir, toFile) {
   }
   return rel.replace(/\.ts$/, ".js");
 }
-async function resolveToolByName(name, config, cwd) {
-  const tDir = toolsDir(config, cwd);
-  const aDir = agentsDir(config, cwd);
+async function resolveToolByName(name, config2, cwd) {
+  const tDir = toolsDir(config2, cwd);
+  const aDir = agentsDir(config2, cwd);
   const lock = await readLock(cwd);
   for (const [componentName, entry] of Object.entries(lock)) {
     if (componentName === name || componentName === `${name}-tool`) {
       const toolFile = entry.files.find((f) => {
-        const toolsAlias = config.aliases.tools ?? join13(config.aliases.base ?? "src/ai", "tools");
+        const toolsAlias = config2.aliases.tools ?? join13(config2.aliases.base ?? "src/ai", "tools");
         return f.startsWith(toolsAlias);
       });
       if (toolFile) {
         const filePath2 = join13(cwd, toolFile);
         try {
-          const source2 = await readFile10(filePath2, "utf-8");
+          const source2 = await readFile11(filePath2, "utf-8");
           const exportName2 = parseExportName(source2);
           if (exportName2) {
             return {
@@ -2514,7 +2509,7 @@ async function resolveToolByName(name, config, cwd) {
   const uniqueCandidates = [...new Set(candidates)];
   const filePath = await findFile(tDir, uniqueCandidates);
   if (!filePath) return null;
-  const source = await readFile10(filePath, "utf-8");
+  const source = await readFile11(filePath, "utf-8");
   const exportName = parseExportName(source);
   if (!exportName) return null;
   return {
@@ -2523,19 +2518,19 @@ async function resolveToolByName(name, config, cwd) {
     importPath: computeImportPath(aDir, filePath)
   };
 }
-async function resolveAgentByName(name, config, cwd) {
-  const aDir = agentsDir(config, cwd);
+async function resolveAgentByName(name, config2, cwd) {
+  const aDir = agentsDir(config2, cwd);
   const lock = await readLock(cwd);
   for (const [componentName, entry] of Object.entries(lock)) {
     if (componentName === name || componentName === `${name}-agent`) {
       const agentFile = entry.files.find((f) => {
-        const agentsAlias = config.aliases.agents ?? join13(config.aliases.base ?? "src/ai", "agents");
+        const agentsAlias = config2.aliases.agents ?? join13(config2.aliases.base ?? "src/ai", "agents");
         return f.startsWith(agentsAlias);
       });
       if (agentFile) {
         const filePath2 = join13(cwd, agentFile);
         try {
-          const source2 = await readFile10(filePath2, "utf-8");
+          const source2 = await readFile11(filePath2, "utf-8");
           const agentName2 = parseAgentName(source2);
           return {
             filePath: filePath2,
@@ -2550,7 +2545,7 @@ async function resolveAgentByName(name, config, cwd) {
   const uniqueCandidates = [...new Set(candidates)];
   const filePath = await findFile(aDir, uniqueCandidates);
   if (!filePath) return null;
-  const source = await readFile10(filePath, "utf-8");
+  const source = await readFile11(filePath, "utf-8");
   const agentName = parseAgentName(source);
   const fallbackName = filePath.split("/").pop().replace(/\.ts$/, "");
   return {
@@ -2558,12 +2553,12 @@ async function resolveAgentByName(name, config, cwd) {
     name: agentName ?? fallbackName
   };
 }
-async function listTools(config, cwd) {
-  const dir = toolsDir(config, cwd);
+async function listTools(config2, cwd) {
+  const dir = toolsDir(config2, cwd);
   return listComponentsInDir(dir);
 }
-async function listAgents(config, cwd) {
-  const dir = agentsDir(config, cwd);
+async function listAgents(config2, cwd) {
+  const dir = agentsDir(config2, cwd);
   return listComponentsInDir(dir);
 }
 async function listComponentsInDir(dir) {
@@ -2838,13 +2833,13 @@ __export(link_exports, {
 });
 import * as p9 from "@clack/prompts";
 import pc8 from "picocolors";
-import { readFile as readFile11, writeFile as writeFile11 } from "fs/promises";
+import { readFile as readFile12, writeFile as writeFile11 } from "fs/promises";
 import { basename } from "path";
 async function linkCommand(type, name, opts) {
   p9.intro(pc8.bgCyan(pc8.black(" kitn link ")));
   const cwd = process.cwd();
-  const config = await readConfig(cwd);
-  if (!config) {
+  const config2 = await readConfig(cwd);
+  if (!config2) {
     p9.log.error("No kitn.json found. Run `kitn init` first.");
     process.exit(1);
   }
@@ -2856,7 +2851,7 @@ async function linkCommand(type, name, opts) {
   }
   let toolName = name;
   if (!toolName) {
-    const tools = await listTools(config, cwd);
+    const tools = await listTools(config2, cwd);
     if (tools.length === 0) {
       p9.log.error("No tools found in your project.");
       process.exit(1);
@@ -2874,7 +2869,7 @@ async function linkCommand(type, name, opts) {
     }
     toolName = selected;
   }
-  const tool = await resolveToolByName(toolName, config, cwd);
+  const tool = await resolveToolByName(toolName, config2, cwd);
   if (!tool) {
     p9.log.error(
       `Tool "${toolName}" not found. Check that the file exists in your tools directory.`
@@ -2883,7 +2878,7 @@ async function linkCommand(type, name, opts) {
   }
   let agentName = opts?.to;
   if (!agentName) {
-    const agents = await listAgents(config, cwd);
+    const agents = await listAgents(config2, cwd);
     if (agents.length === 0) {
       p9.log.error("No agents found in your project.");
       process.exit(1);
@@ -2901,14 +2896,14 @@ async function linkCommand(type, name, opts) {
     }
     agentName = selected;
   }
-  const agent = await resolveAgentByName(agentName, config, cwd);
+  const agent = await resolveAgentByName(agentName, config2, cwd);
   if (!agent) {
     p9.log.error(
       `Agent "${agentName}" not found. Check that the file exists in your agents directory.`
     );
     process.exit(1);
   }
-  const agentContent = await readFile11(agent.filePath, "utf-8");
+  const agentContent = await readFile12(agent.filePath, "utf-8");
   const toolRef = {
     exportName: tool.exportName,
     importPath: tool.importPath
@@ -2954,13 +2949,13 @@ __export(unlink_exports, {
 });
 import * as p10 from "@clack/prompts";
 import pc9 from "picocolors";
-import { readFile as readFile12, writeFile as writeFile12 } from "fs/promises";
+import { readFile as readFile13, writeFile as writeFile12 } from "fs/promises";
 import { basename as basename2 } from "path";
 async function unlinkCommand(type, name, opts) {
   p10.intro(pc9.bgCyan(pc9.black(" kitn unlink ")));
   const cwd = process.cwd();
-  const config = await readConfig(cwd);
-  if (!config) {
+  const config2 = await readConfig(cwd);
+  if (!config2) {
     p10.log.error("No kitn.json found. Run `kitn init` first.");
     process.exit(1);
   }
@@ -2972,7 +2967,7 @@ async function unlinkCommand(type, name, opts) {
   }
   let toolName = name;
   if (!toolName) {
-    const tools = await listTools(config, cwd);
+    const tools = await listTools(config2, cwd);
     if (tools.length === 0) {
       p10.log.error("No tools found in your project.");
       process.exit(1);
@@ -2990,7 +2985,7 @@ async function unlinkCommand(type, name, opts) {
     }
     toolName = selected;
   }
-  const tool = await resolveToolByName(toolName, config, cwd);
+  const tool = await resolveToolByName(toolName, config2, cwd);
   if (!tool) {
     p10.log.error(
       `Tool "${toolName}" not found. Check that the file exists in your tools directory.`
@@ -2999,7 +2994,7 @@ async function unlinkCommand(type, name, opts) {
   }
   let agentName = opts?.from;
   if (!agentName) {
-    const agents = await listAgents(config, cwd);
+    const agents = await listAgents(config2, cwd);
     if (agents.length === 0) {
       p10.log.error("No agents found in your project.");
       process.exit(1);
@@ -3017,14 +3012,14 @@ async function unlinkCommand(type, name, opts) {
     }
     agentName = selected;
   }
-  const agent = await resolveAgentByName(agentName, config, cwd);
+  const agent = await resolveAgentByName(agentName, config2, cwd);
   if (!agent) {
     p10.log.error(
       `Agent "${agentName}" not found. Check that the file exists in your agents directory.`
     );
     process.exit(1);
   }
-  const agentContent = await readFile12(agent.filePath, "utf-8");
+  const agentContent = await readFile13(agent.filePath, "utf-8");
   const toolRef = {
     exportName: tool.exportName,
     importPath: tool.importPath
@@ -3072,13 +3067,13 @@ import * as p11 from "@clack/prompts";
 import pc10 from "picocolors";
 async function infoCommand(component) {
   const cwd = process.cwd();
-  const config = await readConfig(cwd);
-  if (!config) {
+  const config2 = await readConfig(cwd);
+  if (!config2) {
     p11.log.error("No kitn.json found. Run `kitn init` first.");
     process.exit(1);
   }
   const ref = parseComponentRef(component);
-  const fetcher = new RegistryFetcher(config.registries);
+  const fetcher = new RegistryFetcher(config2.registries);
   const s = p11.spinner();
   s.start("Fetching component info...");
   let index;
@@ -3241,40 +3236,33 @@ import pc12 from "picocolors";
 async function rulesCommand() {
   p13.intro(pc12.bgCyan(pc12.black(" kitn rules ")));
   const cwd = process.cwd();
-  const config = await readConfig(cwd);
-  if (!config) {
-    p13.log.error(`No kitn.json found. Run ${pc12.bold("kitn init")} first.`);
-    process.exit(1);
+  const config2 = await readConfig(cwd);
+  const registries = config2?.registries ?? DEFAULT_REGISTRIES;
+  const aliases = config2?.aliases ?? DEFAULT_ALIASES;
+  const rulesConfig = await fetchRulesConfig(registries);
+  const selected = await p13.multiselect({
+    message: "Which AI coding tools do you use?",
+    options: rulesConfig.tools.map((t) => ({
+      value: t.id,
+      label: t.name,
+      hint: t.description
+    })),
+    required: false
+  });
+  if (p13.isCancel(selected)) {
+    p13.cancel("Cancelled.");
+    process.exit(0);
   }
-  let selectedIds = config.aiTools;
-  if (!selectedIds || selectedIds.length === 0) {
-    const rulesConfig = await fetchRulesConfig(config.registries);
-    const selected = await p13.multiselect({
-      message: "Which AI coding tools do you use?",
-      options: rulesConfig.tools.map((t) => ({
-        value: t.id,
-        label: t.name,
-        hint: t.description
-      })),
-      required: false
-    });
-    if (p13.isCancel(selected)) {
-      p13.cancel("Cancelled.");
-      process.exit(0);
-    }
-    selectedIds = selected;
-    if (selectedIds.length === 0) {
-      p13.log.warn("No tools selected. Nothing to generate.");
-      p13.outro("Done.");
-      return;
-    }
-    const updatedConfig = { ...config, aiTools: selectedIds };
-    await writeConfig(cwd, updatedConfig);
-    p13.log.info(`Saved tool selections to ${pc12.bold("kitn.json")}`);
+  const selectedIds = selected;
+  if (selectedIds.length === 0) {
+    p13.log.warn("No tools selected. Nothing to generate.");
+    p13.outro("Done.");
+    return;
   }
   const s = p13.spinner();
   s.start("Generating rules files");
-  const written = await generateRulesFiles(cwd, config, selectedIds);
+  const effectiveConfig = { registries, aliases };
+  const written = await generateRulesFiles(cwd, effectiveConfig, selectedIds);
   s.stop("Rules files generated");
   for (const filePath of written) {
     p13.log.success(`${pc12.green("+")} ${filePath}`);
@@ -3289,6 +3277,79 @@ var init_rules = __esm({
   }
 });
 
+// src/commands/config.ts
+var config_exports = {};
+__export(config_exports, {
+  configGetCommand: () => configGetCommand,
+  configListCommand: () => configListCommand,
+  configSetCommand: () => configSetCommand,
+  readUserConfig: () => readUserConfig
+});
+import * as p14 from "@clack/prompts";
+import pc13 from "picocolors";
+import { readFile as readFile14, writeFile as writeFile13, mkdir as mkdir7 } from "fs/promises";
+import { join as join14 } from "path";
+import { homedir as homedir2 } from "os";
+import { existsSync as existsSync4 } from "fs";
+async function readUserConfig() {
+  try {
+    const raw = await readFile14(CONFIG_FILE2, "utf-8");
+    return JSON.parse(raw);
+  } catch {
+    return {};
+  }
+}
+async function writeUserConfig(config2) {
+  if (!existsSync4(CONFIG_DIR)) {
+    await mkdir7(CONFIG_DIR, { recursive: true });
+  }
+  await writeFile13(CONFIG_FILE2, JSON.stringify(config2, null, 2) + "\n");
+}
+async function configSetCommand(key, value) {
+  if (!VALID_KEYS.includes(key)) {
+    p14.log.error(`Unknown config key: ${pc13.red(key)}`);
+    p14.log.info(`Valid keys: ${VALID_KEYS.join(", ")}`);
+    process.exit(1);
+  }
+  const config2 = await readUserConfig();
+  config2[key] = value;
+  await writeUserConfig(config2);
+  const displayValue = key.includes("key") ? value.slice(0, 8) + "..." : value;
+  p14.log.success(`Set ${pc13.cyan(key)} = ${pc13.green(displayValue)}`);
+}
+async function configGetCommand(key) {
+  const config2 = await readUserConfig();
+  const value = config2[key];
+  if (value === void 0) {
+    p14.log.warn(`${pc13.cyan(key)} is not set`);
+  } else {
+    const displayValue = key.includes("key") ? value.slice(0, 8) + "..." : value;
+    p14.log.info(`${pc13.cyan(key)} = ${pc13.green(displayValue)}`);
+  }
+}
+async function configListCommand() {
+  const config2 = await readUserConfig();
+  const entries = Object.entries(config2);
+  if (entries.length === 0) {
+    p14.log.info("No user configuration set.");
+    p14.log.info(`Run ${pc13.cyan("kitn config set <key> <value>")} to configure.`);
+    return;
+  }
+  for (const [key, value] of entries) {
+    const displayValue = key.includes("key") ? value.slice(0, 8) + "..." : value;
+    p14.log.info(`${pc13.cyan(key)} = ${pc13.green(displayValue)}`);
+  }
+}
+var CONFIG_DIR, CONFIG_FILE2, VALID_KEYS;
+var init_config2 = __esm({
+  "src/commands/config.ts"() {
+    "use strict";
+    CONFIG_DIR = join14(homedir2(), ".kitn");
+    CONFIG_FILE2 = join14(CONFIG_DIR, "config.json");
+    VALID_KEYS = ["chat-url", "api-key"];
+  }
+});
+
 // src/commands/registry.ts
 var registry_exports = {};
 __export(registry_exports, {
@@ -3296,12 +3357,12 @@ __export(registry_exports, {
   registryListCommand: () => registryListCommand,
   registryRemoveCommand: () => registryRemoveCommand
 });
-import * as p14 from "@clack/prompts";
-import pc13 from "picocolors";
+import * as p15 from "@clack/prompts";
+import pc14 from "picocolors";
 async function registryAddCommand(namespace, url, opts = {}) {
   const cwd = opts.cwd ?? process.cwd();
-  const config = await readConfig(cwd);
-  if (!config) throw new Error("No kitn.json found. Run `kitn init` first.");
+  const config2 = await readConfig(cwd);
+  if (!config2) throw new Error("No kitn.json found. Run `kitn init` first.");
   if (!namespace.startsWith("@")) {
     throw new Error("Namespace must start with @ (e.g. @myteam)");
   }
@@ -3311,28 +3372,28 @@ async function registryAddCommand(namespace, url, opts = {}) {
   if (!url.includes("{name}")) {
     throw new Error("URL template must include {name} placeholder");
   }
-  if (config.registries[namespace] && !opts.overwrite) {
+  if (config2.registries[namespace] && !opts.overwrite) {
     throw new Error(`Registry '${namespace}' is already configured. Use --overwrite to replace.`);
   }
   if (opts.homepage || opts.description) {
     const entry = { url };
     if (opts.homepage) entry.homepage = opts.homepage;
     if (opts.description) entry.description = opts.description;
-    config.registries[namespace] = entry;
+    config2.registries[namespace] = entry;
   } else {
-    config.registries[namespace] = url;
+    config2.registries[namespace] = url;
   }
-  await writeConfig(cwd, config);
-  p14.log.success(`Added registry ${pc13.bold(namespace)}`);
-  p14.log.message(pc13.dim(`  ${url}`));
-  if (opts.homepage) p14.log.message(pc13.dim(`  Homepage: ${opts.homepage}`));
-  if (opts.description) p14.log.message(pc13.dim(`  ${opts.description}`));
+  await writeConfig(cwd, config2);
+  p15.log.success(`Added registry ${pc14.bold(namespace)}`);
+  p15.log.message(pc14.dim(`  ${url}`));
+  if (opts.homepage) p15.log.message(pc14.dim(`  Homepage: ${opts.homepage}`));
+  if (opts.description) p15.log.message(pc14.dim(`  ${opts.description}`));
 }
 async function registryRemoveCommand(namespace, opts = {}) {
   const cwd = opts.cwd ?? process.cwd();
-  const config = await readConfig(cwd);
-  if (!config) throw new Error("No kitn.json found. Run `kitn init` first.");
-  if (!config.registries[namespace]) {
+  const config2 = await readConfig(cwd);
+  if (!config2) throw new Error("No kitn.json found. Run `kitn init` first.");
+  if (!config2.registries[namespace]) {
     throw new Error(`Registry '${namespace}' is not configured.`);
   }
   if (namespace === "@kitn" && !opts.force) {
@@ -3345,35 +3406,35 @@ async function registryRemoveCommand(namespace, opts = {}) {
       affectedComponents.push(name);
     }
   }
-  delete config.registries[namespace];
-  await writeConfig(cwd, config);
-  p14.log.success(`Removed registry ${pc13.bold(namespace)}`);
+  delete config2.registries[namespace];
+  await writeConfig(cwd, config2);
+  p15.log.success(`Removed registry ${pc14.bold(namespace)}`);
   if (affectedComponents.length > 0) {
-    p14.log.warn(`${affectedComponents.length} installed component(s) referenced this registry:
-` + affectedComponents.map((name) => `  ${pc13.yellow("!")} ${name}`).join("\n"));
+    p15.log.warn(`${affectedComponents.length} installed component(s) referenced this registry:
+` + affectedComponents.map((name) => `  ${pc14.yellow("!")} ${name}`).join("\n"));
   }
   return { affectedComponents };
 }
 async function registryListCommand(opts = {}) {
   const cwd = opts.cwd ?? process.cwd();
-  const config = await readConfig(cwd);
-  if (!config) throw new Error("No kitn.json found. Run `kitn init` first.");
-  const entries = Object.entries(config.registries).map(([namespace, value]) => {
+  const config2 = await readConfig(cwd);
+  if (!config2) throw new Error("No kitn.json found. Run `kitn init` first.");
+  const entries = Object.entries(config2.registries).map(([namespace, value]) => {
     const url = getRegistryUrl(value);
     const homepage = typeof value === "object" ? value.homepage : void 0;
     const description = typeof value === "object" ? value.description : void 0;
     return { namespace, url, homepage, description };
   });
   if (entries.length === 0) {
-    p14.log.message(pc13.dim("  No registries configured."));
+    p15.log.message(pc14.dim("  No registries configured."));
   } else {
     const lines = [];
     for (const { namespace, url, homepage, description } of entries) {
-      lines.push(`  ${pc13.bold(namespace.padEnd(16))} ${pc13.dim(url)}`);
+      lines.push(`  ${pc14.bold(namespace.padEnd(16))} ${pc14.dim(url)}`);
       if (description) lines.push(`  ${" ".repeat(16)} ${description}`);
-      if (homepage) lines.push(`  ${" ".repeat(16)} ${pc13.dim(homepage)}`);
+      if (homepage) lines.push(`  ${" ".repeat(16)} ${pc14.dim(homepage)}`);
     }
-    p14.log.message(lines.join("\n"));
+    p15.log.message(lines.join("\n"));
   }
   return entries;
 }
@@ -3384,10 +3445,281 @@ var init_registry = __esm({
   }
 });
 
+// src/commands/chat.ts
+var chat_exports = {};
+__export(chat_exports, {
+  buildRequestPayload: () => buildRequestPayload,
+  chatCommand: () => chatCommand,
+  fetchGlobalRegistries: () => fetchGlobalRegistries,
+  formatPlan: () => formatPlan,
+  resolveServiceUrl: () => resolveServiceUrl
+});
+import * as p16 from "@clack/prompts";
+import pc15 from "picocolors";
+async function fetchGlobalRegistries(configuredNamespaces) {
+  let directory;
+  try {
+    const res = await fetch(GLOBAL_REGISTRY_URL);
+    if (!res.ok) return [];
+    directory = await res.json();
+  } catch {
+    return [];
+  }
+  const unconfigured = directory.filter(
+    (entry) => !configuredNamespaces.includes(entry.name)
+  );
+  if (unconfigured.length === 0) return [];
+  const results = [];
+  for (const entry of unconfigured) {
+    try {
+      const indexUrl = entry.url.replace("{type}/{name}.json", "registry.json");
+      const res = await fetch(indexUrl);
+      if (!res.ok) continue;
+      const index = await res.json();
+      const items = (index.items ?? []).map((item) => ({
+        name: item.name,
+        type: item.type,
+        description: item.description,
+        registryDependencies: item.registryDependencies
+      }));
+      results.push({ namespace: entry.name, url: entry.url, items });
+    } catch {
+    }
+  }
+  return results;
+}
+async function resolveServiceUrl(urlOverride, chatServiceConfig) {
+  if (urlOverride) return urlOverride;
+  if (process.env.KITN_CHAT_URL) return process.env.KITN_CHAT_URL;
+  const userConfig = await readUserConfig();
+  if (userConfig["chat-url"]) return userConfig["chat-url"];
+  if (chatServiceConfig?.url) return chatServiceConfig.url;
+  return DEFAULT_SERVICE_URL;
+}
+function buildRequestPayload(message, metadata) {
+  return { message, metadata };
+}
+function formatPlan(plan) {
+  const lines = [plan.summary, ""];
+  for (let i = 0; i < plan.steps.length; i++) {
+    const step = plan.steps[i];
+    const num = `${i + 1}.`;
+    const label = formatStepLabel(step);
+    lines.push(`${num} ${label} - ${step.reason}`);
+  }
+  return lines.join("\n");
+}
+function formatStepLabel(step) {
+  switch (step.action) {
+    case "add":
+      return `Add ${pc15.cyan(step.component)}`;
+    case "remove":
+      return `Remove ${pc15.red(step.component)}`;
+    case "create":
+      return `Create ${pc15.green(`${step.type}/${step.name}`)}`;
+    case "link":
+      return `Link ${pc15.cyan(step.toolName)} \u2192 ${pc15.cyan(step.agentName)}`;
+    case "unlink":
+      return `Unlink ${pc15.red(step.toolName)} from ${pc15.cyan(step.agentName)}`;
+    case "registry-add":
+      return `Add registry ${pc15.magenta(step.namespace)}`;
+  }
+}
+async function chatCommand(message, opts) {
+  const cwd = process.cwd();
+  const config2 = await readConfig(cwd);
+  if (!config2) {
+    p16.log.error("No kitn.json found. Run `kitn init` first.");
+    process.exit(1);
+  }
+  if (!message) {
+    p16.log.error('Please provide a message. Usage: kitn chat "add a weather tool"');
+    process.exit(1);
+  }
+  p16.intro(pc15.bold("kitn assistant"));
+  const s = p16.spinner();
+  s.start("Gathering project context...");
+  let registryIndex;
+  let installed;
+  let globalRegistryIndex;
+  try {
+    const configuredNamespaces = Object.keys(config2.registries);
+    const fetcher = new RegistryFetcher(config2.registries);
+    const [indices, globalEntries, lock] = await Promise.all([
+      Promise.all(
+        configuredNamespaces.map(async (ns) => {
+          try {
+            return await fetcher.fetchIndex(ns);
+          } catch {
+            return null;
+          }
+        })
+      ),
+      fetchGlobalRegistries(configuredNamespaces),
+      readLock(cwd)
+    ]);
+    registryIndex = indices.filter(Boolean).flatMap((index) => (index.items ?? []).map((item) => ({
+      name: item.name,
+      type: item.type,
+      description: item.description,
+      registryDependencies: item.registryDependencies
+    })));
+    installed = Object.keys(lock);
+    globalRegistryIndex = globalEntries.length > 0 ? globalEntries : void 0;
+  } catch {
+    s.stop(pc15.red("Failed to gather context"));
+    p16.log.error("Could not read project context. Check your kitn.json and network connection.");
+    process.exit(1);
+  }
+  s.stop("Context gathered");
+  s.start("Thinking...");
+  const serviceUrl = await resolveServiceUrl(opts?.url, config2.chatService);
+  const metadata = { registryIndex, installed };
+  if (globalRegistryIndex) metadata.globalRegistryIndex = globalRegistryIndex;
+  const payload = buildRequestPayload(message, metadata);
+  let response;
+  try {
+    const headers = {
+      "Content-Type": "application/json"
+    };
+    if (process.env.KITN_API_KEY) {
+      headers["Authorization"] = `Bearer ${process.env.KITN_API_KEY}`;
+    }
+    response = await fetch(`${serviceUrl}/api/chat`, {
+      method: "POST",
+      headers,
+      body: JSON.stringify(payload)
+    });
+  } catch (err) {
+    s.stop(pc15.red("Connection failed"));
+    p16.log.error(`Could not reach chat service at ${serviceUrl}. ${err.message ?? ""}`);
+    process.exit(1);
+  }
+  if (!response.ok) {
+    s.stop(pc15.red("Request failed"));
+    p16.log.error(`Chat service returned ${response.status}: ${response.statusText}`);
+    process.exit(1);
+  }
+  let data;
+  try {
+    data = await response.json();
+  } catch {
+    s.stop(pc15.red("Invalid response"));
+    p16.log.error("Chat service returned an invalid response.");
+    process.exit(1);
+  }
+  s.stop("Done");
+  if (data.rejected) {
+    p16.log.warn(data.text ?? "Request was rejected by the assistant.");
+    p16.outro("Try rephrasing your request.");
+    return;
+  }
+  if (!data.plan) {
+    p16.log.info(data.text ?? "No actionable plan returned.");
+    p16.outro("Nothing to do.");
+    return;
+  }
+  p16.log.message(formatPlan(data.plan));
+  const steps = data.plan.steps;
+  let selectedSteps;
+  if (steps.length === 1) {
+    const confirm7 = await p16.confirm({
+      message: `Run: ${formatStepLabel(steps[0])}?`
+    });
+    if (p16.isCancel(confirm7) || !confirm7) {
+      p16.cancel("Cancelled.");
+      return;
+    }
+    selectedSteps = steps;
+  } else {
+    const action = await p16.select({
+      message: "How would you like to proceed?",
+      options: [
+        { value: "all", label: "Yes, run all steps" },
+        { value: "select", label: "Select which steps to run" },
+        { value: "cancel", label: "Cancel" }
+      ]
+    });
+    if (p16.isCancel(action) || action === "cancel") {
+      p16.cancel("Cancelled.");
+      return;
+    }
+    if (action === "select") {
+      const choices = await p16.multiselect({
+        message: "Select steps to run:",
+        options: steps.map((step, i) => ({
+          value: i,
+          label: `${formatStepLabel(step)} - ${step.reason}`
+        }))
+      });
+      if (p16.isCancel(choices)) {
+        p16.cancel("Cancelled.");
+        return;
+      }
+      selectedSteps = choices.map((i) => steps[i]);
+    } else {
+      selectedSteps = steps;
+    }
+  }
+  for (const step of selectedSteps) {
+    s.start(`Running: ${formatStepLabel(step)}...`);
+    try {
+      switch (step.action) {
+        case "registry-add": {
+          const { registryAddCommand: registryAddCommand2 } = await Promise.resolve().then(() => (init_registry(), registry_exports));
+          await registryAddCommand2(step.namespace, step.url, { overwrite: true });
+          break;
+        }
+        case "add": {
+          const { addCommand: addCommand2 } = await Promise.resolve().then(() => (init_add(), add_exports));
+          await addCommand2([step.component], { yes: true });
+          break;
+        }
+        case "create": {
+          const { createCommand: createCommand2 } = await Promise.resolve().then(() => (init_create(), create_exports));
+          await createCommand2(step.type, step.name);
+          break;
+        }
+        case "link": {
+          const { linkCommand: linkCommand2 } = await Promise.resolve().then(() => (init_link(), link_exports));
+          await linkCommand2("tool", step.toolName, { to: step.agentName });
+          break;
+        }
+        case "remove": {
+          const { removeCommand: removeCommand2 } = await Promise.resolve().then(() => (init_remove(), remove_exports));
+          await removeCommand2(step.component);
+          break;
+        }
+        case "unlink": {
+          const { unlinkCommand: unlinkCommand2 } = await Promise.resolve().then(() => (init_unlink(), unlink_exports));
+          await unlinkCommand2("tool", step.toolName, { from: step.agentName });
+          break;
+        }
+      }
+      s.stop(pc15.green(`Done: ${formatStepLabel(step)}`));
+    } catch (err) {
+      s.stop(pc15.red(`Failed: ${formatStepLabel(step)}`));
+      p16.log.error(err.message ?? "Unknown error");
+    }
+  }
+  p16.outro(pc15.green("All done! Run your dev server to test the new components."));
+}
+var DEFAULT_SERVICE_URL, GLOBAL_REGISTRY_URL;
+var init_chat = __esm({
+  "src/commands/chat.ts"() {
+    "use strict";
+    init_config();
+    init_fetcher();
+    init_config2();
+    DEFAULT_SERVICE_URL = "https://chat.kitn.dev";
+    GLOBAL_REGISTRY_URL = "https://kitn-ai.github.io/registry/registries.json";
+  }
+});
+
 // src/index.ts
 init_update_check();
 import { Command } from "commander";
-var VERSION = true ? "0.1.32" : "0.0.0-dev";
+var VERSION = true ? "0.1.34" : "0.0.0-dev";
 var printUpdateNotice = startUpdateCheck(VERSION);
 var program = new Command().name("kitn").description("Install AI agent components from the kitn registry").version(VERSION);
 program.command("init").description("Initialize kitn in your project").option("-r, --runtime <runtime>", "runtime to use (bun, node, deno)").option("-f, --framework <framework>", "HTTP framework (hono, hono-openapi, elysia)").option("-b, --base <path>", "base directory for components (default: src/ai)").option("-y, --yes", "accept all defaults without prompting").action(async (opts) => {
@@ -3438,6 +3770,10 @@ program.command("rules").description("Regenerate AI coding tool rules files").ac
   const { rulesCommand: rulesCommand2 } = await Promise.resolve().then(() => (init_rules(), rules_exports));
   await rulesCommand2();
 });
+program.command("chat").description("AI-powered scaffolding assistant \u2014 describe what you need in plain English").argument("<message>", 'what you want to build (e.g. "I want a weather agent")').option("-u, --url <url>", "chat service URL (overrides config and default)").action(async (message, opts) => {
+  const { chatCommand: chatCommand2 } = await Promise.resolve().then(() => (init_chat(), chat_exports));
+  await chatCommand2(message, opts);
+});
 var registry = program.command("registry").description("Manage component registries");
 registry.command("add").description("Add a component registry").argument("<namespace>", "registry namespace (e.g. @myteam)").argument("<url>", "URL template with {type} and {name} placeholders").option("-o, --overwrite", "overwrite if namespace already exists").option("--homepage <url>", "registry homepage URL").option("--description <text>", "short description of the registry").action(async (namespace, url, opts) => {
   const { registryAddCommand: registryAddCommand2 } = await Promise.resolve().then(() => (init_registry(), registry_exports));
@@ -3451,6 +3787,19 @@ registry.command("list").description("List all configured registries").action(as
   const { registryListCommand: registryListCommand2 } = await Promise.resolve().then(() => (init_registry(), registry_exports));
   await registryListCommand2();
 });
+var config = program.command("config").description("Manage user-level configuration");
+config.command("set").description("Set a config value").argument("<key>", "config key (chat-url, api-key)").argument("<value>", "config value").action(async (key, value) => {
+  const { configSetCommand: configSetCommand2 } = await Promise.resolve().then(() => (init_config2(), config_exports));
+  await configSetCommand2(key, value);
+});
+config.command("get").description("Get a config value").argument("<key>", "config key").action(async (key) => {
+  const { configGetCommand: configGetCommand2 } = await Promise.resolve().then(() => (init_config2(), config_exports));
+  await configGetCommand2(key);
+});
+config.command("list").description("List all config values").action(async () => {
+  const { configListCommand: configListCommand2 } = await Promise.resolve().then(() => (init_config2(), config_exports));
+  await configListCommand2();
+});
 await program.parseAsync();
 var ranCommand = program.args[0];
 if (ranCommand !== "check") {