@mhmdreza-rafiei/agentry 0.2.2 → 0.3.0

package/README.md

@@ -24,11 +24,15 @@ npx @mhmdreza-rafiei/agentry@latest --help
 ## Quick start
 
 ```bash
-# Browse + install skills from a repo
+# Install a standalone single-skill repository (root SKILL.md)
+agentry add author/my-skill
+
+# Browse + install from a catalog repo (kind is optional or explicit)
+agentry add mhmdreza-rafiei/agent-tools
 agentry add skills mhmdreza-rafiei/agent-tools
 
 # Install one skill to Cursor
-agentry add skills mhmdreza-rafiei/agent-tools enhance-prompt -a cursor
+agentry add mhmdreza-rafiei/agent-tools enhance-prompt -a cursor
 
 # See what is installed
 agentry list
@@ -90,36 +94,37 @@ agentry list skills
 
 | Command | Description |
 | --- | --- |
-| `agentry add <kind> <source> [selector]` | Discover and install artifacts |
+| `agentry add [kind] <source> [selector]` | Discover and install artifacts (kind is optional) |
 | `agentry add profile <name> [source]` | Apply a local `profile/<name>.yaml` bundle |
 | `agentry list` | List installed artifacts |
 | `agentry list <kind>` | List installed artifacts of one kind |
 | `agentry list <source> [kind] [selector]` | List what a repo/path contains |
-| `agentry remove <kind> [source] [selector]` | Remove installs (files + lock) |
+| `agentry remove [kind] [source] [selector]` | Remove installs (files + lock) |
 | `agentry update [kind] [source] [selector]` | Re-install from source or lockfile |
 | `agentry init <kind> [name] [category]` | Scaffold a new artifact |
 | `agentry update` | Update the Agentry CLI itself |
 | `agentry uninstall` | Uninstall the Agentry CLI |
 
-`<kind>` is `skill | rule | agent | profile | script` (plurals accepted).
+`<kind>` is `skill | rule | agent | profile | script` (plurals accepted; omit to match all).
 
 ### Source formats
 
 ```bash
-# GitHub shorthand
+# GitHub shorthand (single-skill repo or catalog)
+agentry add mhmdreza-rafiei/agent-tools
 agentry add skills mhmdreza-rafiei/agent-tools
 
 # Full GitHub URL
-agentry add skills https://github.com/mhmdreza-rafiei/agent-tools
+agentry add https://github.com/mhmdreza-rafiei/agent-tools
 
 # Tree URL (subdir + ref)
-agentry add skills https://github.com/mhmdreza-rafiei/agent-tools/tree/main/skills
+agentry add https://github.com/mhmdreza-rafiei/agent-tools/tree/main/skills
 
 # Local path
-agentry add skills ./my-skills
+agentry add ./my-skills
 
 # Any git URL
-agentry add skills git@github.com:mhmdreza-rafiei/agent-tools.git
+agentry add git@github.com:mhmdreza-rafiei/agent-tools.git
 ```
 
 ### Options
@@ -145,10 +150,10 @@ agentry add skills git@github.com:mhmdreza-rafiei/agent-tools.git
 # List everything in a catalog repo
 agentry list mhmdreza-rafiei/agent-tools
 agentry list mhmdreza-rafiei/agent-tools skills
-agentry list mhmdreza-rafiei/agent-tools skills enhance-prompt
+agentry list mhmdreza-rafiei/agent-tools enhance-prompt
 
 # Install
-agentry add skills mhmdreza-rafiei/agent-tools
+agentry add mhmdreza-rafiei/agent-tools
 agentry add skills mhmdreza-rafiei/agent-tools enhance-prompt -a cursor -a claude-code
 agentry add rules mhmdreza-rafiei/agent-tools ask-dont-guess
 agentry add agents mhmdreza-rafiei/agent-tools frontend-developer
@@ -159,7 +164,7 @@ agentry list skills
 
 # Update / remove by selector or by install source
 agentry update skills mhmdreza-rafiei/agent-tools
-agentry remove skills enhance-prompt
+agentry remove enhance-prompt
 agentry remove skills mhmdreza-rafiei/agent-tools
 
 # Scaffold
@@ -173,18 +178,33 @@ Example catalog used throughout this README: [`mhmdreza-rafiei/agent-tools`](htt
 ## How it works
 
 1. Resolve a source (local path or shallow git clone).
-2. Discover artifacts under `<kind>s/` **and** root markers (`SKILL.md`, `.mdc`).
-3. Let you pick what to install (searchable list + `All`).
-4. Install once to `.agents/skills/<id>` for universal providers; symlink (or `--copy`) for others.
-5. Track installs in `.agentry/lock.json` for remove/update.
+2. Discover artifacts under `<kind>s/` **and** root markers:
+   - Root `SKILL.md` (standalone single-skill repo)
+   - Root `AGENT.md` / `RULE.md` / `.cursorrules` / `.mdc` files
+   - Root `profile/<name>.yaml` / `*.profile.yaml` / `profile.yaml`
+   - Root scripts (`run.sh`, `script.sh`, `run.js`)
+3. Filter out directories/files ignored by `.agentryignore` or `.agentry.ignore` (and built-in VCS ignores like `.git`).
+4. Let you pick what to install (searchable list + `All`).
+5. Install once to `.agents/skills/<id>` for universal providers; symlink (or `--copy`) for others.
+6. Track installs in `.agentry/lock.json` for remove/update.
 
 If a clone fails and a prior cache exists, Agentry asks whether to load from cache (`~/.cache/agentry/repos`).
 
 ## Artifact layouts
 
-Author installable tools in a source repo like this:
+Author installable tools in a source repo:
 
-### Skills
+### Single-skill repo (Root layout)
+
+```text
+SKILL.md
+references/
+  GUIDE.md
+scripts/
+  tool.sh
+```
+
+### Multi-skill catalog
 
 ```text
 skills/
@@ -216,7 +236,18 @@ profiles/
   frontend.yaml
 ```
 
-Local install profiles (consumed by `agentry add profile`) live at `profile/<name>.yaml`.
+Local install profiles live at `profile/<name>.yaml`.
+
+### Excluding development assets (`.agentryignore`)
+
+Place `.agentryignore` (or `.agentry.ignore`) in the root of your repo to prevent internal tools from being discovered or installed:
+
+```gitignore
+# Exclude internal dev skills
+dev-skills/
+skills/internal-*
+*.draft.mdc
+```
 
 ## Supported agents
 

package/dist/cli.mjs

@@ -5,7 +5,7 @@ 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 { basename, dirname, join, relative, resolve, sep } from "node:path";
 import { xdgCache, xdgConfig } from "xdg-basedir";
 import { parse, stringify } from "yaml";
 import { z } from "zod";
@@ -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.0";
 const ARTIFACT_KINDS = [
 	"skill",
 	"rule",
@@ -243,7 +243,100 @@ async function resolveSource(source, opts = {}) {
 	saveToCache(parsed, tmp);
 	return withSubpath(tmp, parsed.subpath, tmp);
 }
+const DEFAULT_IGNORES = [
+	".git",
+	".github",
+	"node_modules",
+	".agents",
+	".agentry",
+	".cursor",
+	".claude",
+	".vscode",
+	"dist",
+	"build",
+	".DS_Store"
+];
+function parseIgnorePattern(pattern) {
+	const trimmed = pattern.trim();
+	if (!trimmed || trimmed.startsWith("#")) return null;
+	const isDirOnly = trimmed.endsWith("/");
+	let p = isDirOnly ? trimmed.slice(0, -1) : trimmed;
+	const isRootAnchored = p.startsWith("/");
+	if (isRootAnchored) p = p.slice(1);
+	let regexStr = "";
+	for (let i = 0; i < p.length; i++) {
+		const char = p[i];
+		if (char === "*") if (p[i + 1] === "*") {
+			regexStr += ".*";
+			i++;
+			if (p[i + 1] === "/") i++;
+		} else regexStr += "[^/]*";
+		else if (char === "?") regexStr += "[^/]";
+		else if ([
+			".",
+			"+",
+			"^",
+			"$",
+			"{",
+			"}",
+			"(",
+			")",
+			"|",
+			"[",
+			"]",
+			"\\"
+		].includes(char)) regexStr += "\\" + char;
+		else regexStr += char;
+	}
+	let regex;
+	if (isRootAnchored) regex = new RegExp(`^${regexStr}(/.*)?$`, "i");
+	else if (p.includes("/")) regex = new RegExp(`(^|/)${regexStr}(/.*)?$`, "i");
+	else regex = new RegExp(`(^|/)${regexStr}($|/)`, "i");
+	return {
+		raw: trimmed,
+		isDirOnly,
+		regex
+	};
+}
+function parseIgnoreFile(content) {
+	return content.split(/\r?\n/).map((line) => parseIgnorePattern(line)).filter((r) => r !== null);
+}
+function loadIgnoreRules(root) {
+	const candidates = [".agentryignore", ".agentry.ignore"];
+	const rules = [];
+	for (const name of candidates) {
+		const file = join(root, name);
+		if (existsSync(file)) try {
+			const text = readFileSync(file, "utf8");
+			rules.push(...parseIgnoreFile(text));
+		} catch {}
+	}
+	return rules;
+}
+function isDefaultIgnored(relPath) {
+	return relPath.replace(/\\/g, "/").replace(/^\/+|\/+$/g, "").split("/").some((s) => DEFAULT_IGNORES.includes(s));
+}
+function createIgnoreMatcher(root) {
+	const fileRules = loadIgnoreRules(root);
+	return (relPath, isDirectory = false) => {
+		if (!relPath || relPath === "." || relPath === "./") return false;
+		const normalized = relPath.replace(/\\/g, "/").replace(/^\/+|\/+$/g, "");
+		if (!normalized) return false;
+		if (isDefaultIgnored(normalized)) return true;
+		for (const rule of fileRules) {
+			if (rule.isDirOnly && !isDirectory) {
+				if (rule.regex.test(normalized + "/")) return true;
+				continue;
+			}
+			if (rule.regex.test(normalized)) return true;
+		}
+		return false;
+	};
+}
 const SKILL_MARKER = "SKILL.md";
+const AGENT_MARKER = "AGENT.md";
+const RULE_MARKER = "RULE.md";
+const CURSORRULES_MARKER = ".cursorrules";
 const FILE_EXT = ".mdc";
 const PROFILE_EXTS = [".yaml", ".yml"];
 const KIND_DIRS = {
@@ -273,6 +366,12 @@ function firstHeading(md) {
 	const m = md.match(/^#\s+(.+)$/m);
 	return m ? m[1].trim() : "";
 }
+function frontmatterName(md) {
+	const fm = md.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+	if (!fm) return "";
+	const m = fm[1].match(/^name:\s*(.+)$/m);
+	return m ? m[1].trim().replace(/^['"]|['"]$/g, "") : "";
+}
 function frontmatterDescription(md) {
 	const fm = md.match(/^---\r?\n([\s\S]*?)\r?\n---/);
 	if (!fm) return "";
@@ -320,69 +419,178 @@ function makeArtifact(kind, category, name, srcPath, isFile) {
 		description: isFile ? readDescription(srcPath) : folderDescription(srcPath)
 	};
 }
-function collectSkills(base, out) {
+function rel(root, fullPath) {
+	return relative(root, fullPath).replace(/\\/g, "/");
+}
+function collectSkills(root, base, out, matcher) {
 	for (const child of entries(base)) {
 		if (!child.isDirectory()) continue;
 		const childDir = join(base, child.name);
+		if (matcher(rel(root, childDir), true)) continue;
 		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 (matcher(rel(root, itemDir), true)) continue;
 			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 collectMdc(root, kind, base, out, matcher) {
+	for (const child of entries(base)) {
+		const childPath = join(base, child.name);
+		if (child.isFile() && child.name.endsWith(FILE_EXT)) {
+			if (matcher(rel(root, childPath), false)) continue;
+			out.push(makeArtifact(kind, null, child.name.slice(0, -4), childPath, true));
+		} else if (child.isDirectory()) {
+			if (matcher(rel(root, childPath), true)) continue;
+			for (const item of entries(childPath)) {
+				const itemPath = join(childPath, item.name);
+				if (item.isFile() && item.name.endsWith(FILE_EXT)) {
+					if (matcher(rel(root, itemPath), false)) continue;
+					out.push(makeArtifact(kind, child.name, item.name.slice(0, -4), itemPath, 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 collectProfiles(root, base, out, matcher) {
+	for (const child of entries(base)) {
+		const childPath = join(base, child.name);
+		if (child.isFile() && PROFILE_EXTS.some((e) => child.name.endsWith(e))) {
+			if (matcher(rel(root, childPath), false)) continue;
+			const stem = child.name.replace(/\.(yaml|yml)$/, "");
+			out.push(makeArtifact("profile", null, stem, childPath, true));
+		} else if (child.isDirectory()) {
+			if (matcher(rel(root, childPath), true)) continue;
+			for (const item of entries(childPath)) {
+				const itemPath = join(childPath, item.name);
+				if (item.isFile() && PROFILE_EXTS.some((e) => item.name.endsWith(e))) {
+					if (matcher(rel(root, itemPath), false)) continue;
+					const stem = item.name.replace(/\.(yaml|yml)$/, "");
+					out.push(makeArtifact("profile", child.name, stem, itemPath, true));
+				}
+			}
 		}
 	}
 }
-function collectScripts(base, out) {
+function collectScripts(root, base, out, matcher) {
 	for (const child of entries(base)) {
 		if (!child.isDirectory()) continue;
 		const childDir = join(base, child.name);
+		if (matcher(rel(root, childDir), true)) continue;
 		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));
+		else for (const item of entries(childDir)) {
+			const itemDir = join(childDir, item.name);
+			if (!item.isDirectory() || matcher(rel(root, itemDir), true)) continue;
+			if (entries(itemDir).some((e) => e.isFile())) out.push(makeArtifact("script", child.name, item.name, join(childDir, item.name), false));
+		}
 	}
 }
-function collectRootSkills(root, out) {
+function collectRootSkills(root, out, matcher) {
+	const rootSkillFile = join(root, SKILL_MARKER);
+	if (existsSync(rootSkillFile) && !matcher(SKILL_MARKER, false)) {
+		let name = "";
+		try {
+			name = frontmatterName(readFileSync(rootSkillFile, "utf8"));
+		} catch {}
+		if (!name) name = basename(root) || "skill";
+		out.push(makeArtifact("skill", null, name, root, false));
+	}
 	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 (matcher(child.name, true)) continue;
 		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));
+		else for (const item of entries(childDir)) {
+			if (!item.isDirectory()) continue;
+			const itemDir = join(childDir, item.name);
+			if (matcher(rel(root, itemDir), true)) continue;
+			if (existsSync(join(itemDir, SKILL_MARKER))) out.push(makeArtifact("skill", child.name, item.name, itemDir, 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 collectRootMdc(kind, root, out, matcher) {
+	if (kind === "agent") {
+		const rootAgent = join(root, AGENT_MARKER);
+		if (existsSync(rootAgent) && !matcher(AGENT_MARKER, false)) {
+			let name = "";
+			try {
+				name = frontmatterName(readFileSync(rootAgent, "utf8"));
+			} catch {}
+			out.push(makeArtifact("agent", null, name || "agent", rootAgent, true));
+		}
+	}
+	if (kind === "rule") {
+		const rootRule = join(root, RULE_MARKER);
+		if (existsSync(rootRule) && !matcher(RULE_MARKER, false)) {
+			let name = "";
+			try {
+				name = frontmatterName(readFileSync(rootRule, "utf8"));
+			} catch {}
+			out.push(makeArtifact("rule", null, name || "rule", rootRule, true));
+		}
+		const cursorRules = join(root, CURSORRULES_MARKER);
+		if (existsSync(cursorRules) && !matcher(CURSORRULES_MARKER, false)) out.push(makeArtifact("rule", null, "cursorrules", cursorRules, true));
+	}
+	for (const child of entries(root)) {
+		const childPath = join(root, child.name);
+		if (child.isFile() && child.name.endsWith(FILE_EXT) && !child.name.startsWith(".")) {
+			if (matcher(child.name, false)) continue;
+			out.push(makeArtifact(kind, null, child.name.slice(0, -4), childPath, true));
+		} else if (child.isDirectory() && !child.name.startsWith(".") && !ROOT_SKIP.has(child.name)) {
+			if (matcher(child.name, true)) continue;
+			for (const item of entries(childPath)) {
+				const itemPath = join(childPath, item.name);
+				if (item.isFile() && item.name.endsWith(FILE_EXT)) {
+					if (matcher(rel(root, itemPath), false)) continue;
+					out.push(makeArtifact(kind, child.name, item.name.slice(0, -4), itemPath, true));
+				}
+			}
+		}
+	}
+}
+function collectRootProfiles(root, out, matcher) {
+	const localProfileDir = join(root, "profile");
+	if (existsSync(localProfileDir) && !matcher("profile", true)) collectProfiles(root, localProfileDir, out, matcher);
+	for (const child of entries(root)) {
+		if (!child.isFile()) continue;
+		if (matcher(child.name, false)) continue;
+		const lower = child.name.toLowerCase();
+		if (lower === "profile.yaml" || lower === "profile.yml" || lower.endsWith(".profile.yaml") || lower.endsWith(".profile.yml")) {
+			const stem = child.name.replace(/\.(profile\.)?(yaml|yml)$/i, "");
+			out.push(makeArtifact("profile", null, stem, join(root, child.name), true));
+		}
+	}
+}
+function collectRootScripts(root, out, matcher) {
+	const localScriptDir = join(root, "script");
+	if (existsSync(localScriptDir) && !matcher("script", true)) collectScripts(root, localScriptDir, out, matcher);
+	if (!existsSync(join(root, SKILL_MARKER))) {
+		for (const sf of [
+			"run.sh",
+			"script.sh",
+			"run.js",
+			"main.py"
+		]) if (existsSync(join(root, sf)) && !matcher(sf, false)) {
+			const name = basename(root) || "script";
+			out.push(makeArtifact("script", null, name, root, false));
+			break;
+		}
 	}
 }
 function listKind(root, kind) {
 	const out = [];
+	const matcher = createIgnoreMatcher(root);
 	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);
+	if (existsSync(base) && !matcher(KIND_DIRS[kind], true)) if (kind === "skill") collectSkills(root, base, out, matcher);
+	else if (kind === "profile") collectProfiles(root, base, out, matcher);
+	else if (kind === "script") collectScripts(root, base, out, matcher);
+	else collectMdc(root, kind, base, out, matcher);
+	if (kind === "skill") collectRootSkills(root, out, matcher);
+	else if (kind === "agent" || kind === "rule") collectRootMdc(kind, root, out, matcher);
+	else if (kind === "profile") collectRootProfiles(root, out, matcher);
+	else if (kind === "script") collectRootScripts(root, out, matcher);
 	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));
 }
@@ -391,7 +599,8 @@ function listAll(root) {
 		"skill",
 		"rule",
 		"agent",
-		"profile"
+		"profile",
+		"script"
 	].flatMap((k) => listKind(root, k));
 }
 function select(root, kind, selector) {
@@ -402,6 +611,14 @@ function select(root, kind, selector) {
 	if (byCategory.length) return byCategory;
 	return items.filter((a) => a.name === selector);
 }
+function selectAll(root, selector) {
+	const items = listAll(root);
+	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 +800,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 +811,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 +824,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 +962,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 +970,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 +1010,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 +2156,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 +2171,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 +2339,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 +2370,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 +2469,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");
@@ -2683,21 +2918,33 @@ 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 or agentry add skills author/repo");
+		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)) {
+			const source = positional[2];
+			if (!source) throw new Error(`Missing source. e.g. agentry add ${k1} author/repo`);
+			await cmdAdd(k1, source, positional[3], 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.0",
   "description": "One CLI to install agents, skills, rules, and profiles onto AI coding agents — portable AI/agent tooling.",
   "type": "module",
   "bin": {