@mhmdreza-rafiei/agentry 0.2.2 → 0.3.1

package/dist/cli.mjs

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
+import { DEFAULT_IGNORES, createIgnoreMatcher, isExplicitSource, isOwnerRepoShape, listAll, listKind, parseSource, resolveSource, select, selectAll, sourcesEqual } from "./_chunks/discovery.mjs";
 import { animateLogo, badge, delay, printHelp, sky, theme } from "./_chunks/theme2.mjs";
 import { execFileSync } from "node:child_process";
 import https from "node:https";
-import { createHash } from "node:crypto";
-import { copyFileSync, cpSync, existsSync, lstatSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, realpathSync, rmSync, statSync, symlinkSync, writeFileSync } from "node:fs";
-import { homedir, tmpdir } from "node:os";
-import { dirname, join, resolve, sep } from "node:path";
-import { xdgCache, xdgConfig } from "xdg-basedir";
+import { copyFileSync, existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, realpathSync, rmSync, statSync, symlinkSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join, relative, resolve, sep } from "node:path";
+import { xdgConfig } from "xdg-basedir";
 import { parse, stringify } from "yaml";
 import { z } from "zod";
 import * as clack from "@clack/prompts";
@@ -16,7 +16,7 @@ import { determineAgent } from "@vercel/detect-agent";
 import { stripVTControlCharacters } from "node:util";
 import { Writable } from "node:stream";
 var name = "@mhmdreza-rafiei/agentry";
-var version = "0.2.2";
+var version = "0.3.1";
 const ARTIFACT_KINDS = [
 	"skill",
 	"rule",
@@ -24,384 +24,6 @@ const ARTIFACT_KINDS = [
 	"profile",
 	"script"
 ];
-function isLocalPath(source) {
-	if (!source) return false;
-	if (source === "." || source === "..") return true;
-	if (source.startsWith("./") || source.startsWith("../") || source.startsWith("/") || source.startsWith("~")) return true;
-	try {
-		return existsSync(source) && statSync(source).isDirectory();
-	} catch {
-		return false;
-	}
-}
-const SAFE_REF$1 = /^[a-zA-Z0-9][\w./-]*$/;
-function parseGithubTreeUrl(url) {
-	const m = url.match(/^https?:\/\/github\.com\/([\w.-]+\/[\w.-]+?)\/tree\/([^/]+)\/(.+)$/);
-	if (!m) return null;
-	const ref = m[2];
-	if (!SAFE_REF$1.test(ref)) throw new Error(`Invalid git ref in source URL: "${ref}"`);
-	return {
-		ownerRepo: m[1],
-		ref,
-		subpath: m[3].replace(/\/+$/, "")
-	};
-}
-function redactUrl(url) {
-	return url.replace(/:\/\/([^/@]+)@/g, "://***@");
-}
-function parseSource(source) {
-	if (!source || typeof source !== "string") throw new Error("Empty source.");
-	const raw = source;
-	if (isLocalPath(source)) return {
-		kind: "local",
-		raw,
-		url: null,
-		subpath: "",
-		local: resolve(source.replace(/^~/, homedir()))
-	};
-	const tree = parseGithubTreeUrl(source);
-	if (tree) return {
-		kind: "github-url",
-		raw,
-		url: `https://github.com/${tree.ownerRepo}.git`,
-		subpath: tree.subpath,
-		ref: tree.ref,
-		local: null
-	};
-	let m = source.match(/^https?:\/\/github\.com\/([\w.-]+\/[\w.-]+?)(?:\.git)?\/?$/);
-	if (m) return {
-		kind: "github-url",
-		raw,
-		url: `https://github.com/${m[1]}.git`,
-		subpath: "",
-		local: null
-	};
-	m = source.match(/^https?:\/\/gitlab\.com\/([\w./-]+?)(?:\.git)?\/?$/);
-	if (m) return {
-		kind: "gitlab-url",
-		raw,
-		url: `https://gitlab.com/${m[1]}.git`,
-		subpath: "",
-		local: null
-	};
-	if (source.startsWith("git@") || /^https?:\/\/.*\.git$/.test(source)) return {
-		kind: "git-url",
-		raw,
-		url: source,
-		subpath: "",
-		local: null
-	};
-	if (/^[\w.-]+\/[\w.-]+$/.test(source)) return {
-		kind: "github-shorthand",
-		raw,
-		url: `https://github.com/${source}.git`,
-		subpath: "",
-		local: null
-	};
-	throw new Error(`Cannot parse source "${source}". Use author/repo, a GitHub/GitLab URL, a git URL, or a local path.`);
-}
-function sourceIdentity(source) {
-	try {
-		const p = parseSource(source);
-		if (p.kind === "local" && p.local) return `local:${resolve(p.local).replace(/\\/g, "/").toLowerCase()}`;
-		return `git:${(p.url || "").replace(/\.git$/i, "").replace(/\/+$/, "").toLowerCase()}${p.subpath ? `/${p.subpath.replace(/^\/+|\/+$/g, "")}` : ""}${p.ref ? `@${p.ref}` : ""}`;
-	} catch {
-		return `raw:${source.trim().toLowerCase()}`;
-	}
-}
-function sourcesEqual(a, b) {
-	if (!a || !b) return false;
-	if (a === b) return true;
-	return sourceIdentity(a) === sourceIdentity(b);
-}
-function isExplicitSource(arg) {
-	if (!arg) return false;
-	if (isLocalPath(arg)) return true;
-	if (/^https?:\/\//i.test(arg)) return true;
-	if (arg.startsWith("git@")) return true;
-	if (/^https?:\/\/.*\.git$/i.test(arg)) return true;
-	return false;
-}
-function isOwnerRepoShape(arg) {
-	return /^[\w.-]+\/[\w.-]+$/.test(arg);
-}
-function cacheRoot() {
-	return join(xdgCache ?? join(homedir(), ".cache"), "agentry", "repos");
-}
-function cacheKey(parsed) {
-	const id = sourceIdentity(parsed.raw);
-	return createHash("sha256").update(id).digest("hex").slice(0, 20);
-}
-function cacheDirFor(parsed) {
-	return join(cacheRoot(), cacheKey(parsed));
-}
-function saveToCache(parsed, clonedRoot) {
-	const dest = cacheDirFor(parsed);
-	try {
-		rmSync(dest, {
-			recursive: true,
-			force: true
-		});
-		mkdirSync(join(dest, ".."), { recursive: true });
-		cpSync(clonedRoot, dest, { recursive: true });
-	} catch {}
-}
-const SAFE_REF = /^[a-zA-Z0-9][\w./-]*$/;
-function cloneTo(url, dest, ref) {
-	if (ref && !SAFE_REF.test(ref)) throw new Error(`Invalid git ref: "${ref}"`);
-	execFileSync("git", [
-		"clone",
-		"--quiet",
-		...ref ? [
-			"--branch",
-			ref,
-			"--depth",
-			"1"
-		] : ["--depth", "1"],
-		url,
-		dest
-	], { stdio: [
-		"ignore",
-		"ignore",
-		"pipe"
-	] });
-}
-function assertInsideRoot(root, candidate) {
-	const base = resolve(root);
-	const resolved = resolve(candidate);
-	const prefix = base.endsWith(sep) ? base : base + sep;
-	const a = resolved.toLowerCase();
-	const b = base.toLowerCase();
-	const p = prefix.toLowerCase();
-	if (a !== b && !a.startsWith(p)) throw new Error(`Path escapes source root: "${candidate}"`);
-	return resolved;
-}
-function withSubpath(root, subpath, cleanupRoot) {
-	const cleanup = () => rmSync(cleanupRoot, {
-		recursive: true,
-		force: true
-	});
-	if (!subpath) return {
-		root,
-		cleanup
-	};
-	let sub;
-	try {
-		sub = assertInsideRoot(root, join(root, subpath));
-	} catch (e) {
-		cleanup();
-		throw e;
-	}
-	if (!existsSync(sub)) {
-		cleanup();
-		throw new Error(`Subpath "${subpath}" not found.`);
-	}
-	return {
-		root: sub,
-		cleanup
-	};
-}
-async function resolveSource(source, opts = {}) {
-	const parsed = typeof source === "string" ? parseSource(source) : source;
-	if (parsed.kind === "local" && parsed.local) {
-		if (!existsSync(parsed.local)) throw new Error(`Path not found: ${parsed.raw}`);
-		return {
-			root: parsed.local,
-			cleanup: () => {}
-		};
-	}
-	const url = parsed.url;
-	if (!url) throw new Error(`Cannot resolve source "${parsed.raw}".`);
-	const safeUrl = redactUrl(url);
-	const tmp = mkdtempSync(join(tmpdir(), "agentry-src-"));
-	try {
-		cloneTo(url, tmp, parsed.ref);
-	} catch (e) {
-		rmSync(tmp, {
-			recursive: true,
-			force: true
-		});
-		const detail = e.stderr ? e.stderr.toString().trim() : e.message;
-		const cached = cacheDirFor(parsed);
-		const cacheOk = existsSync(cached) && existsSync(join(cached, ".git"));
-		if (cacheOk && opts.confirmCache) {
-			if (await opts.confirmCache({
-				url: safeUrl,
-				cacheDir: cached,
-				error: detail
-			})) {
-				const work = mkdtempSync(join(tmpdir(), "agentry-src-"));
-				cpSync(cached, work, { recursive: true });
-				return {
-					...withSubpath(work, parsed.subpath, work),
-					fromCache: true
-				};
-			}
-		}
-		throw new Error(`git clone failed for ${safeUrl}\n${detail}${cacheOk ? "\n(A local cache exists — re-run interactively to load it, or pass -y to auto-use cache.)" : ""}`);
-	}
-	saveToCache(parsed, tmp);
-	return withSubpath(tmp, parsed.subpath, tmp);
-}
-const SKILL_MARKER = "SKILL.md";
-const FILE_EXT = ".mdc";
-const PROFILE_EXTS = [".yaml", ".yml"];
-const KIND_DIRS = {
-	skill: "skills",
-	rule: "rules",
-	agent: "agents",
-	profile: "profiles",
-	script: "scripts"
-};
-const ROOT_SKIP = /* @__PURE__ */ new Set([
-	".",
-	"node_modules",
-	"skills",
-	"rules",
-	"agents",
-	"profiles",
-	"scripts"
-]);
-function entries(dir) {
-	try {
-		return readdirSync(dir, { withFileTypes: true });
-	} catch {
-		return [];
-	}
-}
-function firstHeading(md) {
-	const m = md.match(/^#\s+(.+)$/m);
-	return m ? m[1].trim() : "";
-}
-function frontmatterDescription(md) {
-	const fm = md.match(/^---\r?\n([\s\S]*?)\r?\n---/);
-	if (!fm) return "";
-	const lines = fm[1].split(/\r?\n/);
-	for (let i = 0; i < lines.length; i++) {
-		const dm = lines[i].match(/^description:\s*(.*)$/);
-		if (!dm) continue;
-		let val = dm[1].trim();
-		if (val === "" || val === ">" || val === "|" || val === ">-" || val === "|-") {
-			const collected = [];
-			for (let j = i + 1; j < lines.length; j++) if (/^\s+\S/.test(lines[j])) collected.push(lines[j].trim());
-			else break;
-			val = collected.join(" ");
-		}
-		return val.trim();
-	}
-	return "";
-}
-function readDescription(filePath) {
-	try {
-		const md = readFileSync(filePath, "utf8");
-		return frontmatterDescription(md) || firstHeading(md);
-	} catch {
-		return "";
-	}
-}
-function folderDescription(dir) {
-	for (const f of [SKILL_MARKER, "README.md"]) {
-		const p = join(dir, f);
-		if (existsSync(p)) {
-			const d = readDescription(p);
-			if (d) return d;
-		}
-	}
-	return "";
-}
-function makeArtifact(kind, category, name, srcPath, isFile) {
-	return {
-		kind,
-		category,
-		name,
-		id: category ? `${category}/${name}` : name,
-		dir: srcPath,
-		isFile,
-		description: isFile ? readDescription(srcPath) : folderDescription(srcPath)
-	};
-}
-function collectSkills(base, out) {
-	for (const child of entries(base)) {
-		if (!child.isDirectory()) continue;
-		const childDir = join(base, child.name);
-		if (existsSync(join(childDir, SKILL_MARKER))) out.push(makeArtifact("skill", null, child.name, childDir, false));
-		else for (const item of entries(childDir)) {
-			if (!item.isDirectory()) continue;
-			const itemDir = join(childDir, item.name);
-			if (existsSync(join(itemDir, SKILL_MARKER))) out.push(makeArtifact("skill", child.name, item.name, itemDir, false));
-		}
-	}
-}
-function collectMdc(kind, base, out) {
-	for (const child of entries(base)) if (child.isFile() && child.name.endsWith(FILE_EXT)) out.push(makeArtifact(kind, null, child.name.slice(0, -4), join(base, child.name), true));
-	else if (child.isDirectory()) {
-		const subDir = join(base, child.name);
-		for (const item of entries(subDir)) if (item.isFile() && item.name.endsWith(FILE_EXT)) out.push(makeArtifact(kind, child.name, item.name.slice(0, -4), join(subDir, item.name), true));
-	}
-}
-function collectProfiles(base, out) {
-	for (const child of entries(base)) if (child.isFile() && PROFILE_EXTS.some((e) => child.name.endsWith(e))) {
-		const stem = child.name.replace(/\.(yaml|yml)$/, "");
-		out.push(makeArtifact("profile", null, stem, join(base, child.name), true));
-	} else if (child.isDirectory()) {
-		const subDir = join(base, child.name);
-		for (const item of entries(subDir)) if (item.isFile() && PROFILE_EXTS.some((e) => item.name.endsWith(e))) {
-			const stem = item.name.replace(/\.(yaml|yml)$/, "");
-			out.push(makeArtifact("profile", child.name, stem, join(subDir, item.name), true));
-		}
-	}
-}
-function collectScripts(base, out) {
-	for (const child of entries(base)) {
-		if (!child.isDirectory()) continue;
-		const childDir = join(base, child.name);
-		if (entries(childDir).some((e) => e.isFile())) out.push(makeArtifact("script", null, child.name, childDir, false));
-		else for (const item of entries(childDir)) if (item.isDirectory() && entries(join(childDir, item.name)).some((e) => e.isFile())) out.push(makeArtifact("script", child.name, item.name, join(childDir, item.name), false));
-	}
-}
-function collectRootSkills(root, out) {
-	for (const child of entries(root)) {
-		if (!child.isDirectory() || child.name.startsWith(".") || ROOT_SKIP.has(child.name)) continue;
-		const childDir = join(root, child.name);
-		if (existsSync(join(childDir, SKILL_MARKER))) out.push(makeArtifact("skill", null, child.name, childDir, false));
-		else for (const item of entries(childDir)) if (item.isDirectory() && existsSync(join(childDir, item.name, SKILL_MARKER))) out.push(makeArtifact("skill", child.name, item.name, join(childDir, item.name), false));
-	}
-}
-function collectRootMdc(kind, root, out) {
-	for (const child of entries(root)) if (child.isFile() && child.name.endsWith(FILE_EXT) && !child.name.startsWith(".")) out.push(makeArtifact(kind, null, child.name.slice(0, -4), join(root, child.name), true));
-	else if (child.isDirectory() && !child.name.startsWith(".") && !ROOT_SKIP.has(child.name)) {
-		const subDir = join(root, child.name);
-		for (const item of entries(subDir)) if (item.isFile() && item.name.endsWith(FILE_EXT)) out.push(makeArtifact(kind, child.name, item.name.slice(0, -4), join(subDir, item.name), true));
-	}
-}
-function listKind(root, kind) {
-	const out = [];
-	const base = join(root, KIND_DIRS[kind]);
-	if (existsSync(base)) if (kind === "skill") collectSkills(base, out);
-	else if (kind === "profile") collectProfiles(base, out);
-	else if (kind === "script") collectScripts(base, out);
-	else collectMdc(kind, base, out);
-	if (kind === "skill") collectRootSkills(root, out);
-	else if (kind === "agent" || kind === "rule") collectRootMdc(kind, root, out);
-	const seen = /* @__PURE__ */ new Set();
-	return out.filter((a) => seen.has(a.id) ? false : seen.add(a.id)).sort((a, b) => a.id.localeCompare(b.id));
-}
-function listAll(root) {
-	return [
-		"skill",
-		"rule",
-		"agent",
-		"profile"
-	].flatMap((k) => listKind(root, k));
-}
-function select(root, kind, selector) {
-	const items = listKind(root, kind);
-	if (!selector) return items;
-	if (selector.includes("/")) return items.filter((a) => a.id === selector);
-	const byCategory = items.filter((a) => a.category === selector);
-	if (byCategory.length) return byCategory;
-	return items.filter((a) => a.name === selector);
-}
 const home$1 = homedir();
 const configHome = xdgConfig ?? join(home$1, ".config");
 const codexHome = process.env.CODEX_HOME?.trim() || join(home$1, ".codex");
@@ -583,7 +205,7 @@ function getNonUniversalAgents() {
 	return listAgents().filter((a) => a.skillsDir !== ".agents/skills");
 }
 const home = homedir();
-function copyTreeDereferenced(src, dest, seen = /* @__PURE__ */ new Set()) {
+function copyTreeDereferenced(src, dest, seen = /* @__PURE__ */ new Set(), filter, baseSrc = src) {
 	const st = lstatSync(src);
 	if (st.isSymbolicLink()) {
 		let real;
@@ -594,7 +216,7 @@ function copyTreeDereferenced(src, dest, seen = /* @__PURE__ */ new Set()) {
 		}
 		if (seen.has(real)) return;
 		seen.add(real);
-		copyTreeDereferenced(real, dest, seen);
+		copyTreeDereferenced(real, dest, seen, filter, baseSrc);
 		return;
 	}
 	if (st.isDirectory()) {
@@ -607,7 +229,17 @@ function copyTreeDereferenced(src, dest, seen = /* @__PURE__ */ new Set()) {
 		if (seen.has(real)) return;
 		seen.add(real);
 		mkdirSync(dest, { recursive: true });
-		for (const name of readdirSync(src)) copyTreeDereferenced(join(src, name), join(dest, name), seen);
+		for (const name of readdirSync(src)) {
+			const childSrc = join(src, name);
+			const relPath = relative(baseSrc, childSrc).replace(/\\/g, "/");
+			let isDir = false;
+			try {
+				isDir = statSync(childSrc).isDirectory();
+			} catch {}
+			if (DEFAULT_IGNORES.includes(name) || name === ".agentryignore" || name === ".agentry.ignore") continue;
+			if (filter && filter(relPath, isDir)) continue;
+			copyTreeDereferenced(childSrc, join(dest, name), seen, filter, baseSrc);
+		}
 		return;
 	}
 	if (st.isFile()) {
@@ -735,6 +367,7 @@ function installOne(artifact, opts, agentList, source) {
 		});
 		return dests;
 	}
+	const ignoreFilter = artifact.isFile ? void 0 : createIgnoreMatcher(artifact.dir);
 	if (artifact.kind === "skill") {
 		const canonical = join(base, ".agents", "skills", artifact.id);
 		rmSync(canonical, {
@@ -742,7 +375,7 @@ function installOne(artifact, opts, agentList, source) {
 			force: true
 		});
 		mkdirSync(join(canonical, ".."), { recursive: true });
-		copyTreeDereferenced(artifact.dir, canonical);
+		copyTreeDereferenced(artifact.dir, canonical, /* @__PURE__ */ new Set(), ignoreFilter);
 		for (const a of list) if (a.skillsDir === ".agents/skills") dests.push({
 			agent: a.name,
 			dir: canonical
@@ -782,7 +415,7 @@ function installOne(artifact, opts, agentList, source) {
 			force: true
 		});
 		mkdirSync(join(dir, ".."), { recursive: true });
-		copyTreeDereferenced(artifact.dir, dir);
+		copyTreeDereferenced(artifact.dir, dir, /* @__PURE__ */ new Set(), ignoreFilter);
 		dests.push({
 			agent: a.name,
 			dir
@@ -1928,7 +1561,7 @@ async function cmdAdd(kind, source, selector, opts) {
 	await delayQuiet(280);
 	const { root, cleanup } = await resolveSourceWithUi(source, opts);
 	try {
-		const artifacts = await spinner("Discovering…", () => kind === "all" ? listAll(root) : select(root, kind, selector), (a) => {
+		const artifacts = await spinner("Discovering…", () => kind === "all" ? selector ? selectAll(root, selector) : listAll(root) : select(root, kind, selector), (a) => {
 			const noun = kind === "all" ? "artifact" : kind;
 			return `Found ${a.length} ${noun}${a.length === 1 ? "" : "s"}`;
 		}, 620);
@@ -1943,17 +1576,20 @@ async function cmdAdd(kind, source, selector, opts) {
 			return;
 		}
 		let chosen = artifacts;
-		if (!selector && kind !== "all" && artifacts.length > 1 && !opts.all && !opts.yes && !isQuiet()) {
-			await sectionTransition("source discovery", `select ${kind}s to install`);
-			const picked = await selectArtifacts(`Select ${kind}s to install`, artifacts);
+		if (!selector && artifacts.length > 1 && !opts.all && !opts.yes && !isQuiet()) {
+			const noun = kind === "all" ? "artifacts" : `${kind}s`;
+			await sectionTransition("source discovery", `select ${noun} to install`);
+			const picked = await selectArtifacts(`Select ${noun} to install`, artifacts);
 			if (isCancelLike(picked)) {
 				outro("Cancelled.");
 				return;
 			}
 			chosen = picked;
-			await sectionTransition(`${chosen.length} ${kind}${chosen.length === 1 ? "" : "s"} selected`, "choose target agents");
-		} else if (!isQuiet() && !opts.agents.length && !opts.all && !opts.yes) await sectionTransition(`${chosen.length} ${kind}${chosen.length === 1 ? "" : "s"} ready`, "choose target agents");
-		else {
+			await sectionTransition(`${chosen.length} ${chosen.length === 1 ? "artifact" : "artifacts"} selected`, "choose target agents");
+		} else if (!isQuiet() && !opts.agents.length && !opts.all && !opts.yes) {
+			const noun = kind === "all" ? chosen.length === 1 ? "artifact" : "artifacts" : `${kind}${chosen.length === 1 ? "" : "s"}`;
+			await sectionTransition(`${chosen.length} ${noun} ready`, "choose target agents");
+		} else {
 			await delayQuiet(200);
 			blank();
 		}
@@ -2108,7 +1744,7 @@ async function cmdRemove(kind, arg1, arg2, opts) {
 		let count = 0;
 		let paths = 0;
 		for (const t of ARTIFACT_KINDS) {
-			const r = removeSelection(t, void 0, installOpts, agentList, source);
+			const r = removeSelection(t, selector, installOpts, agentList, source);
 			count += r.removedKeys.length;
 			paths += r.removedPaths.length;
 		}
@@ -2139,7 +1775,7 @@ async function cmdList(source, kind, selector, opts) {
 	try {
 		printArtifactList(await spinner("Discovering…", () => {
 			if (kind) return select(root, kind, selector);
-			return listAll(root);
+			return selector ? selectAll(root, selector) : listAll(root);
 		}, (a) => `Found ${a.length} artifact${a.length === 1 ? "" : "s"}`, 520), {
 			title: "Available in source",
 			subtitle: source
@@ -2238,22 +1874,26 @@ async function cmdUpdateAssets(kind, arg1, arg2, opts) {
 		}, 520);
 		const { root, cleanup } = await resolveSourceWithUi(source, opts);
 		try {
-			const artifacts = await spinner("Discovering…", () => kind === "all" ? listAll(root) : select(root, kind, selector), (a) => `Found ${a.length} to update`, 620);
+			const artifacts = await spinner("Discovering…", () => kind === "all" ? selector ? selectAll(root, selector) : listAll(root) : select(root, kind, selector), (a) => `Found ${a.length} to update`, 620);
 			if (!artifacts.length) {
 				warn(`Nothing found in ${source}.`);
 				return;
 			}
 			let chosen = artifacts;
-			if (!selector && kind !== "all" && artifacts.length > 1 && !opts.all && !opts.yes && !isQuiet()) {
-				await sectionTransition("source discovery", `select ${kind}s to update`);
-				const picked = await selectArtifacts(`Select ${kind}s to update`, artifacts);
+			if (!selector && artifacts.length > 1 && !opts.all && !opts.yes && !isQuiet()) {
+				const noun = kind === "all" ? "artifacts" : `${kind}s`;
+				await sectionTransition("source discovery", `select ${noun} to update`);
+				const picked = await selectArtifacts(`Select ${noun} to update`, artifacts);
 				if (isCancelLike(picked)) {
 					outro("Cancelled.");
 					return;
 				}
 				chosen = picked;
-				await sectionTransition(`${chosen.length} ${kind}${chosen.length === 1 ? "" : "s"} selected`, "choose target agents");
-			} else if (!isQuiet() && !opts.agents.length && !opts.all && !opts.yes) await sectionTransition(`${chosen.length} ${kind}${chosen.length === 1 ? "" : "s"} ready`, "choose target agents");
+				await sectionTransition(`${chosen.length} ${chosen.length === 1 ? "artifact" : "artifacts"} selected`, "choose target agents");
+			} else if (!isQuiet() && !opts.agents.length && !opts.all && !opts.yes) {
+				const noun = kind === "all" ? chosen.length === 1 ? "artifact" : "artifacts" : `${kind}${chosen.length === 1 ? "" : "s"}`;
+				await sectionTransition(`${chosen.length} ${noun} ready`, "choose target agents");
+			}
 			const agentList = await resolveAgentList(opts, "update");
 			if (!await ensureInstallScope(opts, "update")) return;
 			if (!isQuiet() && !opts.agents.length && !opts.all && !opts.yes) await sectionTransition(`${agentList.length} agent${agentList.length === 1 ? "" : "s"} selected`, "update summary");
@@ -2664,6 +2304,13 @@ async function main() {
 		await cmdUpdateAssets(kind, positional[2], positional[3], opts);
 		return;
 	}
+	if (action === "from") {
+		const source = positional[1];
+		if (!source) throw new Error("Missing URL. e.g. agentry from https://awesomeskill.ai/skill/...");
+		const selector = positional[2];
+		await cmdAdd("all", source, selector, opts);
+		return;
+	}
 	if (action === "list") {
 		const a1 = positional[1];
 		const a2 = positional[2];
@@ -2683,21 +2330,45 @@ async function main() {
 		return;
 	}
 	if (action === "add") {
-		const kind = positional[1] ? normalizeKind(positional[1]) : void 0;
-		if (!kind) throw new Error("Missing kind. e.g. agentry add skills author/repo");
-		if (kind === "profile") {
+		const a1 = positional[1];
+		if (!a1) throw new Error("Missing source or kind. e.g. agentry add author/repo, agentry add from <url>, or agentry add skills author/repo");
+		if (a1 === "from") {
+			const source = positional[2];
+			if (!source) throw new Error("Missing URL after \"from\". e.g. agentry add from https://awesomeskill.ai/skill/...");
+			const selector = positional[3];
+			await cmdAdd("all", source, selector, opts);
+			return;
+		}
+		const k1 = normalizeKind(a1);
+		if (k1 === "profile") {
 			await cmdAddProfile(positional[2], positional[3], opts);
 			return;
 		}
-		if (kind !== "all" && !isKind(kind)) throw new Error(`Unknown kind: ${kind}`);
-		await cmdAdd(kind, positional[2], positional[3], opts);
+		if (k1 === "all" || isKind(k1)) {
+			let source = positional[2];
+			let selector = positional[3];
+			if (source === "from") {
+				source = positional[3];
+				selector = positional[4];
+			}
+			if (!source) throw new Error(`Missing source. e.g. agentry add ${k1} author/repo or agentry add ${k1} from <url>`);
+			await cmdAdd(k1, source, selector, opts);
+			return;
+		}
+		const source = a1;
+		const selector = positional[2];
+		await cmdAdd("all", source, selector, opts);
 		return;
 	}
 	if (action === "remove" || action === "rm") {
-		const kind = positional[1] ? normalizeKind(positional[1]) : void 0;
-		if (!kind) throw new Error("Missing kind. e.g. agentry remove skills enhance-prompt");
-		if (kind !== "all" && !isKind(kind)) throw new Error(`Unknown kind: ${kind}`);
-		await cmdRemove(kind, positional[2], positional[3], opts);
+		const a1 = positional[1];
+		if (!a1) throw new Error("Missing kind or selector. e.g. agentry remove skills enhance-prompt");
+		const k1 = normalizeKind(a1);
+		if (k1 === "all" || isKind(k1)) {
+			await cmdRemove(k1, positional[2], positional[3], opts);
+			return;
+		}
+		await cmdRemove("all", positional[1], positional[2], opts);
 		return;
 	}
 	if (action === "init") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mhmdreza-rafiei/agentry",
-  "version": "0.2.2",
+  "version": "0.3.1",
   "description": "One CLI to install agents, skills, rules, and profiles onto AI coding agents — portable AI/agent tooling.",
   "type": "module",
   "bin": {