@folpe/loom 0.4.0 → 1.1.0

package/README.md

@@ -59,6 +59,26 @@ loom add skill tailwind-patterns
 
 Files are written to `.claude/agents/` and `.claude/skills/` in your current directory.
 
+If the resource isn't found in the bundled library, Loom will automatically check your local library (`~/.loom/library/`) for marketplace-installed resources.
+
+### Browse the marketplace
+
+```bash
+loom marketplace search              # list all public resources
+loom marketplace search tailwind     # search by keyword
+loom marketplace search --type skill # filter by type
+```
+
+Alias: `loom mp search`
+
+### Install from the marketplace
+
+```bash
+loom marketplace install ticket-craft
+```
+
+This downloads the resource to your local library (`~/.loom/library/`). You can then use it with `loom add` in any project.
+
 ## What's included
 
 ### Agents

package/dist/index.js

@@ -23,6 +23,34 @@ function listFiles(dir) {
   if (!fs.existsSync(dir)) return [];
   return fs.readdirSync(dir, { withFileTypes: true }).filter((d) => d.isFile()).map((d) => d.name).sort();
 }
+var TEXT_EXTENSIONS = /* @__PURE__ */ new Set([
+  ".md",
+  ".ts",
+  ".js",
+  ".sh",
+  ".dot",
+  ".yaml",
+  ".yml",
+  ".json",
+  ".css",
+  ".html"
+]);
+function walkDir(dir, base = "") {
+  const entries = fs.readdirSync(dir, { withFileTypes: true });
+  const results = [];
+  for (const entry of entries) {
+    const rel = base ? `${base}/${entry.name}` : entry.name;
+    if (entry.isDirectory()) {
+      results.push(...walkDir(path.join(dir, entry.name), rel));
+    } else if (entry.isFile()) {
+      const ext = path.extname(entry.name).toLowerCase();
+      if (TEXT_EXTENSIONS.has(ext)) {
+        results.push(rel);
+      }
+    }
+  }
+  return results;
+}
 async function listAgents() {
   const agentsDir = path.join(DATA_DIR, "agents");
   const slugs = listSubDirs(agentsDir);
@@ -94,10 +122,16 @@ async function getAgent(slug) {
   const raw = fs.readFileSync(filePath, "utf-8");
   return { slug, rawContent: raw };
 }
-async function getSkill(slug) {
-  const filePath = path.join(DATA_DIR, "skills", slug, "SKILL.md");
-  const raw = fs.readFileSync(filePath, "utf-8");
-  return { slug, rawContent: raw };
+async function getSkillWithFiles(slug) {
+  const skillDir = path.join(DATA_DIR, "skills", slug);
+  const mainPath = path.join(skillDir, "SKILL.md");
+  const mainContent = fs.readFileSync(mainPath, "utf-8");
+  const relativePaths = walkDir(skillDir);
+  const files = relativePaths.map((relativePath) => ({
+    relativePath,
+    content: fs.readFileSync(path.join(skillDir, relativePath), "utf-8")
+  }));
+  return { slug, mainContent, files };
 }
 async function getPreset(slug) {
   const filePath = path.join(DATA_DIR, "presets", `${slug}.yaml`);
@@ -106,6 +140,116 @@ async function getPreset(slug) {
   return { ...data, slug };
 }
 
+// src/lib/local-library.ts
+import fs2 from "fs";
+import path2 from "path";
+import os from "os";
+var LIBRARY_DIR = path2.join(os.homedir(), ".loom", "library");
+function ensureDir(dir) {
+  fs2.mkdirSync(dir, { recursive: true });
+}
+function saveLocalAgent(slug, content) {
+  const dir = path2.join(LIBRARY_DIR, "agents", slug);
+  ensureDir(dir);
+  const filePath = path2.join(dir, "AGENT.md");
+  fs2.writeFileSync(filePath, content, "utf-8");
+  return filePath;
+}
+function saveLocalSkill(slug, files) {
+  const dir = path2.join(LIBRARY_DIR, "skills", slug);
+  for (const file of files) {
+    const filePath = path2.join(dir, file.relativePath);
+    ensureDir(path2.dirname(filePath));
+    fs2.writeFileSync(filePath, file.content, "utf-8");
+  }
+  return dir;
+}
+function saveLocalPreset(slug, content) {
+  const dir = path2.join(LIBRARY_DIR, "presets");
+  ensureDir(dir);
+  const filePath = path2.join(dir, `${slug}.yaml`);
+  fs2.writeFileSync(filePath, content, "utf-8");
+  return filePath;
+}
+function getLocalAgent(slug) {
+  const filePath = path2.join(LIBRARY_DIR, "agents", slug, "AGENT.md");
+  try {
+    const raw = fs2.readFileSync(filePath, "utf-8");
+    return { slug, rawContent: raw };
+  } catch {
+    return null;
+  }
+}
+var TEXT_EXTENSIONS2 = /* @__PURE__ */ new Set([
+  ".md",
+  ".ts",
+  ".js",
+  ".sh",
+  ".dot",
+  ".yaml",
+  ".yml",
+  ".json",
+  ".css",
+  ".html"
+]);
+function walkDir2(dir, base = "") {
+  let entries;
+  try {
+    entries = fs2.readdirSync(dir, { withFileTypes: true });
+  } catch {
+    return [];
+  }
+  const results = [];
+  for (const entry of entries) {
+    const rel = base ? `${base}/${entry.name}` : entry.name;
+    if (entry.isDirectory()) {
+      results.push(...walkDir2(path2.join(dir, entry.name), rel));
+    } else if (entry.isFile()) {
+      const ext = path2.extname(entry.name).toLowerCase();
+      if (TEXT_EXTENSIONS2.has(ext)) {
+        results.push(rel);
+      }
+    }
+  }
+  return results;
+}
+function getLocalSkillWithFiles(slug) {
+  const dir = path2.join(LIBRARY_DIR, "skills", slug);
+  if (!fs2.existsSync(dir)) return null;
+  const relativePaths = walkDir2(dir);
+  if (relativePaths.length === 0) return null;
+  const files = relativePaths.map((relativePath) => ({
+    relativePath,
+    content: fs2.readFileSync(path2.join(dir, relativePath), "utf-8")
+  }));
+  return { slug, files };
+}
+function listSubDirs2(dir) {
+  try {
+    return fs2.readdirSync(dir, { withFileTypes: true }).filter((d) => d.isDirectory()).map((d) => d.name).sort();
+  } catch {
+    return [];
+  }
+}
+function listLocalResources() {
+  const items = [];
+  for (const slug of listSubDirs2(path2.join(LIBRARY_DIR, "agents"))) {
+    items.push({ slug, type: "agent" });
+  }
+  for (const slug of listSubDirs2(path2.join(LIBRARY_DIR, "skills"))) {
+    items.push({ slug, type: "skill" });
+  }
+  try {
+    const presetsDir = path2.join(LIBRARY_DIR, "presets");
+    const files = fs2.readdirSync(presetsDir).filter((f) => f.endsWith(".yaml"));
+    for (const f of files) {
+      items.push({ slug: f.replace(/\.yaml$/, ""), type: "preset" });
+    }
+  } catch {
+  }
+  return items;
+}
+
 // src/commands/list.ts
 function truncate(str, max) {
   if (str.length <= max) return str;
@@ -116,6 +260,7 @@ function padEnd(str, len) {
 }
 async function listCommand(type) {
   try {
+    const bundledSlugs = /* @__PURE__ */ new Set();
     if (!type || type === "agents") {
       const agents = await listAgents();
       console.log(pc.bold(pc.cyan("\n  Agents")));
@@ -124,6 +269,7 @@ async function listCommand(type) {
         console.log(pc.dim("  No agents found."));
       }
       for (const a of agents) {
+        bundledSlugs.add(`agent:${a.slug}`);
         console.log(
           `  ${padEnd(pc.green(a.slug), 30)} ${padEnd(a.name, 25)} ${pc.dim(truncate(a.description, 40))}`
         );
@@ -137,6 +283,7 @@ async function listCommand(type) {
         console.log(pc.dim("  No skills found."));
       }
       for (const s of skills) {
+        bundledSlugs.add(`skill:${s.slug}`);
         console.log(
           `  ${padEnd(pc.green(s.slug), 30)} ${padEnd(s.name, 25)} ${pc.dim(truncate(s.description, 40))}`
         );
@@ -150,12 +297,25 @@ async function listCommand(type) {
         console.log(pc.dim("  No presets found."));
       }
       for (const p2 of presets) {
+        bundledSlugs.add(`preset:${p2.slug}`);
         const meta = pc.dim(`(${p2.agentCount} agents, ${p2.skillCount} skills)`);
         console.log(
           `  ${padEnd(pc.green(p2.slug), 30)} ${padEnd(p2.name, 25)} ${meta}`
         );
       }
     }
+    const localItems = listLocalResources().filter(
+      (item) => !bundledSlugs.has(`${item.type}:${item.slug}`)
+    );
+    if (localItems.length > 0) {
+      console.log(pc.bold(pc.magenta("\n  Installed (marketplace)")));
+      console.log(pc.dim("  " + "\u2500".repeat(60)));
+      for (const item of localItems) {
+        console.log(
+          `  ${padEnd(pc.green(item.slug), 30)} ${pc.dim(`[${item.type}]`)}`
+        );
+      }
+    }
     console.log();
   } catch (error) {
     handleError(error);
@@ -176,34 +336,36 @@ function handleError(error) {
 import pc2 from "picocolors";
 
 // src/lib/writer.ts
-import fs2 from "fs";
-import path2 from "path";
-function ensureDir(dirPath) {
-  fs2.mkdirSync(dirPath, { recursive: true });
+import fs3 from "fs";
+import path3 from "path";
+function ensureDir2(dirPath) {
+  fs3.mkdirSync(dirPath, { recursive: true });
 }
 function writeAgent(target, slug, content, cwd = process.cwd()) {
-  const dir = path2.join(cwd, target.dir, target.agentsSubdir, slug);
-  ensureDir(dir);
-  const filePath = path2.join(dir, "AGENT.md");
-  fs2.writeFileSync(filePath, content, "utf-8");
+  const dir = path3.join(cwd, target.dir, target.agentsSubdir, slug);
+  ensureDir2(dir);
+  const filePath = path3.join(dir, "AGENT.md");
+  fs3.writeFileSync(filePath, content, "utf-8");
   return filePath;
 }
-function writeSkill(target, slug, content, cwd = process.cwd()) {
-  const dir = path2.join(cwd, target.dir, target.skillsSubdir, slug);
-  ensureDir(dir);
-  const filePath = path2.join(dir, "SKILL.md");
-  fs2.writeFileSync(filePath, content, "utf-8");
-  return filePath;
+function writeSkillDir(target, slug, files, cwd = process.cwd()) {
+  const dir = path3.join(cwd, target.dir, target.skillsSubdir, slug);
+  for (const file of files) {
+    const filePath = path3.join(dir, file.relativePath);
+    ensureDir2(path3.dirname(filePath));
+    fs3.writeFileSync(filePath, file.content, "utf-8");
+  }
+  return dir;
 }
 function writeOrchestrator(target, content, cwd = process.cwd()) {
-  const filePath = path2.join(cwd, target.dir, target.orchestratorFile);
-  ensureDir(path2.dirname(filePath));
-  fs2.writeFileSync(filePath, content, "utf-8");
+  const filePath = path3.join(cwd, target.dir, target.orchestratorFile);
+  ensureDir2(path3.dirname(filePath));
+  fs3.writeFileSync(filePath, content, "utf-8");
   return filePath;
 }
 function writeContextFile(target, content, cwd = process.cwd()) {
-  const filePath = path2.join(cwd, target.contextFile);
-  fs2.writeFileSync(filePath, content, "utf-8");
+  const filePath = path3.join(cwd, target.contextFile);
+  fs3.writeFileSync(filePath, content, "utf-8");
   return filePath;
 }
 
@@ -223,20 +385,39 @@ async function addCommand(type, slug, target) {
   \u2713 Agent "${slug}" written to ${filePath}
 `));
     } else {
-      const skill = await getSkill(slug);
-      const filePath = writeSkill(target, slug, skill.rawContent);
+      const skill = await getSkillWithFiles(slug);
+      const dirPath = writeSkillDir(target, slug, skill.files);
+      const fileCount = skill.files.length;
       console.log(pc2.green(`
-  \u2713 Skill "${slug}" written to ${filePath}
+  \u2713 Skill "${slug}" written to ${dirPath} (${fileCount} file${fileCount !== 1 ? "s" : ""})
 `));
     }
-  } catch (error) {
-    if (error instanceof Error) {
-      console.error(pc2.red(`
-  Error: ${error.message}
+  } catch {
+    if (type === "agent") {
+      const local = getLocalAgent(slug);
+      if (local) {
+        const filePath = writeAgent(target, slug, local.rawContent);
+        console.log(pc2.green(`
+  \u2713 Agent "${slug}" written to ${filePath} ${pc2.dim("(from ~/.loom/library)")}
 `));
+        return;
+      }
     } else {
-      console.error(pc2.red("\n  An unknown error occurred.\n"));
+      const local = getLocalSkillWithFiles(slug);
+      if (local) {
+        const dirPath = writeSkillDir(target, slug, local.files);
+        const fileCount = local.files.length;
+        console.log(pc2.green(`
+  \u2713 Skill "${slug}" written to ${dirPath} (${fileCount} file${fileCount !== 1 ? "s" : ""}) ${pc2.dim("(from ~/.loom/library)")}
+`));
+        return;
+      }
     }
+    console.error(pc2.red(`
+  Error: ${type} "${slug}" not found.
+`));
+    console.log(pc2.dim(`  Try: loom marketplace search ${slug}
+`));
     process.exit(1);
   }
 }
@@ -392,8 +573,8 @@ function resolveTarget(targetName, customDir, customContextFile) {
 }
 
 // src/lib/config.ts
-import fs3 from "fs";
-import path3 from "path";
+import fs4 from "fs";
+import path4 from "path";
 var CONFIG_FILE = "loom.config.json";
 function saveConfig(target, cwd = process.cwd()) {
   const config = {
@@ -401,14 +582,14 @@ function saveConfig(target, cwd = process.cwd()) {
     targetDir: target.dir,
     contextFile: target.contextFile
   };
-  const filePath = path3.join(cwd, CONFIG_FILE);
-  fs3.writeFileSync(filePath, JSON.stringify(config, null, 2) + "\n", "utf-8");
+  const filePath = path4.join(cwd, CONFIG_FILE);
+  fs4.writeFileSync(filePath, JSON.stringify(config, null, 2) + "\n", "utf-8");
 }
 function loadConfig(cwd = process.cwd()) {
-  const filePath = path3.join(cwd, CONFIG_FILE);
-  if (!fs3.existsSync(filePath)) return null;
+  const filePath = path4.join(cwd, CONFIG_FILE);
+  if (!fs4.existsSync(filePath)) return null;
   try {
-    const raw = fs3.readFileSync(filePath, "utf-8");
+    const raw = fs4.readFileSync(filePath, "utf-8");
     const config = JSON.parse(raw);
     return resolveTarget(config.target, config.targetDir, config.contextFile);
   } catch {
@@ -611,7 +792,7 @@ async function generateAndWrite(preset, agentSlugs, skillSlugs, target) {
     agentSlugs.map((slug) => getAgent(slug))
   );
   const skillResults = await Promise.allSettled(
-    skillSlugs.map((slug) => getSkill(slug))
+    skillSlugs.map((slug) => getSkillWithFiles(slug))
   );
   const agentInfos = [];
   const agentsWithSkills = [];
@@ -657,8 +838,9 @@ async function generateAndWrite(preset, agentSlugs, skillSlugs, target) {
     const slug = skillSlugs[i];
     const result = skillResults[i];
     if (result.status === "fulfilled") {
-      writeSkill(target, slug, result.value.rawContent);
-      console.log(pc3.green(`  \u2713 Skill: ${slug}`));
+      writeSkillDir(target, slug, result.value.files);
+      const fileCount = result.value.files.length;
+      console.log(pc3.green(`  \u2713 Skill: ${slug} (${fileCount} file${fileCount !== 1 ? "s" : ""})`));
     } else {
       console.log(pc3.yellow(`  \u26A0 Skill "${slug}" skipped: ${result.reason}`));
     }
@@ -685,6 +867,106 @@ function computeAvailableSkills(preset, selectedAgentSlugs, allAgents, allSkillS
   });
 }
 
+// src/commands/marketplace.ts
+import pc4 from "picocolors";
+var DEFAULT_API_URL = "https://loom.voidcorp.io";
+function padEnd2(str, len) {
+  return str + " ".repeat(Math.max(0, len - str.length));
+}
+function truncate2(str, max) {
+  if (str.length <= max) return str;
+  return str.slice(0, max - 1) + "\u2026";
+}
+function getApiUrl() {
+  return process.env.LOOM_API_URL ?? DEFAULT_API_URL;
+}
+async function marketplaceSearchCommand(query, opts) {
+  try {
+    const url = new URL("/api/cli/marketplace", getApiUrl());
+    if (query) url.searchParams.set("q", query);
+    if (opts?.type) url.searchParams.set("type", opts.type);
+    if (opts?.sort) url.searchParams.set("sort", opts.sort);
+    const res = await fetch(url);
+    if (!res.ok) throw new Error(`HTTP ${res.status}`);
+    const data = await res.json();
+    if (data.items.length === 0) {
+      console.log(pc4.dim("\n  No results found.\n"));
+      return;
+    }
+    console.log(
+      pc4.bold(pc4.cyan(`
+  Marketplace${query ? ` \u2014 "${query}"` : ""}`))
+    );
+    console.log(pc4.dim("  " + "\u2500".repeat(70)));
+    for (const item of data.items) {
+      const type = pc4.dim(`[${item.type}]`);
+      const installs = pc4.dim(`\u2193${item.installCount}`);
+      const author = item.authorName ? pc4.dim(`by ${item.authorName}`) : "";
+      console.log(
+        `  ${padEnd2(pc4.green(item.slug), 25)} ${padEnd2(type, 14)} ${padEnd2(truncate2(item.title, 25), 27)} ${installs} ${author}`
+      );
+    }
+    console.log(
+      pc4.dim(
+        `
+  Install with: ${pc4.reset("loom marketplace install <slug>")}
+`
+      )
+    );
+  } catch (error) {
+    if (error instanceof Error) {
+      console.error(pc4.red(`
+  \u2717 ${error.message}
+`));
+    } else {
+      console.error(pc4.red("\n  \u2717 Could not reach the marketplace.\n"));
+    }
+    process.exit(1);
+  }
+}
+async function marketplaceInstallCommand(slug) {
+  try {
+    const url = new URL("/api/cli/marketplace/install", getApiUrl());
+    const res = await fetch(url, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ slug })
+    });
+    if (!res.ok) {
+      const body = await res.json().catch(() => ({}));
+      throw new Error(body.error ?? `HTTP ${res.status}`);
+    }
+    const data = await res.json();
+    const r = data.resource;
+    if (r.type === "agent") {
+      saveLocalAgent(r.slug, r.content);
+    } else if (r.type === "skill") {
+      const files = r.files?.length ? r.files.map((f) => ({ relativePath: f.relativePath, content: f.content })) : [{ relativePath: "SKILL.md", content: r.content }];
+      saveLocalSkill(r.slug, files);
+    } else if (r.type === "preset") {
+      saveLocalPreset(r.slug, r.content);
+    }
+    console.log(
+      pc4.green(`
+  \u2713 Installed "${r.title}" (${r.type}) to ~/.loom/library/
+`)
+    );
+    console.log(
+      pc4.dim(`  Use it: loom add ${r.type} ${r.slug}
+`)
+    );
+  } catch (error) {
+    if (error instanceof Error) {
+      console.error(pc4.red(`
+  \u2717 ${error.message}
+`));
+    } else {
+      console.error(pc4.red("\n  \u2717 Installation failed.\n"));
+    }
+    process.exit(1);
+  }
+}
+
 // src/index.ts
 var require2 = createRequire(import.meta.url);
 var { version } = require2("../package.json");
@@ -726,4 +1008,13 @@ program.command("init").description("Initialize a project with a preset (agents
     targetExplicit
   });
 });
+var mp = program.command("marketplace").alias("mp").description("Browse and install community resources");
+mp.command("search").description("Search the marketplace").argument("[query]", "Search query").option("--type <type>", "Filter by type: agent, skill, preset").option("--sort <sort>", "Sort: popular, recent", "popular").action(
+  async (query, opts) => {
+    await marketplaceSearchCommand(query, opts);
+  }
+);
+mp.command("install").description("Install a resource from the marketplace").argument("<slug>", "Resource slug to install").action(async (slug) => {
+  await marketplaceInstallCommand(slug);
+});
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@folpe/loom",
-  "version": "0.4.0",
+  "version": "1.1.0",
   "description": "CLI to scaffold Claude Code projects with curated agents, skills, and presets",
   "type": "module",
   "license": "MIT",
@@ -29,6 +29,11 @@
     "dist",
     "data"
   ],
+  "scripts": {
+    "prebuild": "node scripts/sync-library.js",
+    "build": "tsup",
+    "dev": "tsup --watch"
+  },
   "dependencies": {
     "@clack/prompts": "^1.0.1",
     "commander": "^13.1.0",
@@ -43,10 +48,5 @@
     "@types/node": "^20",
     "tsup": "^8.4.0",
     "typescript": "^5"
-  },
-  "scripts": {
-    "prebuild": "node scripts/sync-library.js",
-    "build": "tsup",
-    "dev": "tsup --watch"
   }
-}
+}