aicores 1.0.0 → 1.0.2

package/README.md

@@ -6,6 +6,57 @@ The CLI for the open agent ecosystem. Install and manage **agents** and **skills
 Supports **OpenCode**, **Claude Code**, **Codex**, **Cursor**, and [37 more](#available-agents).
 <!-- agent-list:end -->
 
+## Installation
+
+No installation required — use directly with `npx`:
+
+```bash
+# Install agents + skills from a GitHub repo
+npx aicores wizeline/my-aicore
+
+# Install from a full GitHub URL
+npx aicores https://github.com/wizeline/my-aicore
+
+# List available agents and skills without installing
+npx aicores wizeline/my-aicore --list
+
+# Install everything globally, skip all prompts
+npx aicores wizeline/my-aicore -g -y
+
+# Install only to Claude Code
+npx aicores wizeline/my-aicore -a claude-code
+
+# Install specific skills only
+npx aicores wizeline/my-aicore --skill frontend-design
+
+# Install agents separately
+npx aicores agents add wizeline/agent-skills
+
+# Install skills separately
+npx aicores skills add wizeline/agent-skills
+```
+
+Or install globally to use without `npx`:
+
+```bash
+# npm
+npm install -g aicores
+
+# pnpm
+pnpm add -g aicores
+
+# yarn
+yarn global add aicores
+```
+
+Once installed globally, use `aicore`, `agents`, or `skills` directly:
+
+```bash
+aicore wizeline/my-aicore
+agents add wizeline/agent-skills
+skills add wizeline/agent-skills
+```
+
 > [!TIP]
 > **Three interchangeable commands**: `aicore`, `agents`, and `skills` all work the same way. Use `npx aicore` to install a bundled package of agents + skills at once, or use `npx agents` / `npx skills` to install them separately.
 
@@ -72,7 +123,7 @@ npx aicore ./my-local-aicore
 ### Examples
 
 ```bash
-# List agents and skills in a package without installing
+# List aicores from a folder or URL without installing
 npx aicore wizeline/my-aicore --list
 
 # Install everything globally and skip all prompts

package/dist/cli.mjs

@@ -648,6 +648,78 @@ async function discoverAgentFiles(dir) {
   }
   return agents2;
 }
+async function discoverAicoresFromDir(baseDir) {
+  const aicores = [];
+  let entries;
+  try {
+    entries = await readdir(baseDir, { withFileTypes: true });
+  } catch {
+    return aicores;
+  }
+  for (const entry of entries) {
+    if (!entry.isDirectory()) continue;
+    const dirName = entry.name;
+    if (["node_modules", ".git", "dist", "build", "__pycache__"].includes(dirName)) continue;
+    const aicoreDir = join3(baseDir, dirName);
+    const agentsDir = join3(aicoreDir, "agents");
+    const skillsDir = join3(aicoreDir, "skills");
+    let hasAgents = false;
+    let hasSkills = false;
+    try {
+      const s = await stat(agentsDir);
+      hasAgents = s.isDirectory();
+    } catch {
+    }
+    try {
+      const s = await stat(skillsDir);
+      hasSkills = s.isDirectory();
+    } catch {
+    }
+    if (!hasAgents && !hasSkills) continue;
+    const agents2 = hasAgents ? await discoverAgentFiles(agentsDir) : [];
+    const skills = hasSkills ? await discoverSkillsBasic(skillsDir) : [];
+    aicores.push({ name: dirName, agents: agents2, skills });
+  }
+  return aicores.sort((a, b) => a.name.localeCompare(b.name));
+}
+async function discoverSkillsBasic(dir) {
+  const skills = [];
+  const scan = async (currentDir, depth) => {
+    if (depth > 3) return;
+    let entries;
+    try {
+      entries = await readdir(currentDir, { withFileTypes: true });
+    } catch {
+      return;
+    }
+    for (const entry of entries) {
+      if (entry.isFile() && entry.name === "SKILL.md") {
+        const parsed = await parseSkillMdBasic(join3(currentDir, "SKILL.md"));
+        if (parsed) skills.push(parsed);
+      } else if (entry.isDirectory() && !["node_modules", ".git"].includes(entry.name)) {
+        await scan(join3(currentDir, entry.name), depth + 1);
+      }
+    }
+  };
+  await scan(dir, 0);
+  return skills;
+}
+async function parseSkillMdBasic(filePath) {
+  try {
+    const content = await readFile2(filePath, "utf-8");
+    let data = {};
+    try {
+      const parsed = matter(content);
+      data = parsed.data || {};
+    } catch {
+    }
+    const name = typeof data.name === "string" && data.name ? data.name : basename(join3(filePath, ".."));
+    const description = typeof data.description === "string" ? data.description : "";
+    return { name, description, path: filePath, rawContent: content };
+  } catch {
+    return null;
+  }
+}
 var SKIP_DIRS = ["node_modules", ".git", "dist", "build", "__pycache__"];
 function shouldInstallInternalSkills() {
   const envValue = process.env.INSTALL_INTERNAL_SKILLS;
@@ -2321,13 +2393,14 @@ function createEmptyLocalLock() {
 // package.json
 var package_default = {
   name: "aicores",
-  version: "1.0.0",
+  version: "1.0.2",
   description: "The open agent skills & subagents ecosystem",
   type: "module",
   bin: {
     skills: "bin/cli.mjs",
     agents: "bin/agents.mjs",
     aicore: "bin/aicore.mjs",
+    aicores: "bin/aicore.mjs",
     "add-skill": "bin/cli.mjs"
   },
   files: [
@@ -3079,6 +3152,51 @@ async function runAdd(args, options = {}) {
       const baseDir = parsed.subpath ? join8(skillsDir, parsed.subpath) : skillsDir;
       const aiAgentsSubDir = join8(baseDir, "agents");
       const aiSkillsSubDir = join8(baseDir, "skills");
+      if (options.list) {
+        spinner4.start("Discovering aicores...");
+        const aicores = await discoverAicoresFromDir(baseDir);
+        if (aicores.length > 0) {
+          spinner4.stop(`Found ${pc2.green(aicores.length)} aicore(s)`);
+          console.log();
+          for (const aicore of aicores) {
+            const totalItems = aicore.agents.length + aicore.skills.length;
+            console.log(
+              pc2.bold(pc2.cyan(aicore.name)) + pc2.dim(` (${totalItems} item${totalItems !== 1 ? "s" : ""})`)
+            );
+            const sections = [];
+            if (aicore.agents.length > 0) sections.push({ label: "Agents", items: aicore.agents });
+            if (aicore.skills.length > 0)
+              sections.push({
+                label: "Skills",
+                items: aicore.skills.map((s) => ({
+                  name: getSkillDisplayName(s),
+                  description: s.description
+                }))
+              });
+            for (let si = 0; si < sections.length; si++) {
+              const section = sections[si];
+              const isLastSection = si === sections.length - 1;
+              const sectionPrefix = isLastSection ? "\u2514\u2500\u2500 " : "\u251C\u2500\u2500 ";
+              const childIndent = isLastSection ? "    " : "\u2502   ";
+              console.log(
+                `${sectionPrefix}${pc2.bold(section.label)} ${pc2.dim(`(${section.items.length})`)}`
+              );
+              for (let ii = 0; ii < section.items.length; ii++) {
+                const item = section.items[ii];
+                const isLastItem = ii === section.items.length - 1;
+                const itemPrefix = isLastItem ? "\u2514\u2500\u2500 " : "\u251C\u2500\u2500 ";
+                const desc = item.description ? pc2.dim(` \u2014 ${item.description}`) : "";
+                console.log(`${childIndent}${itemPrefix}${pc2.cyan(item.name)}${desc}`);
+              }
+            }
+            console.log();
+          }
+          p.outro(pc2.dim("Run without --list to install"));
+          await cleanup(tempDir);
+          process.exit(0);
+        }
+        spinner4.stop("");
+      }
       if (existsSync2(aiAgentsSubDir) || existsSync2(aiSkillsSubDir)) {
         spinner4.start("Discovering aicore contents...");
         const agentFiles = existsSync2(aiAgentsSubDir) ? await discoverAgentFiles(aiAgentsSubDir) : [];
@@ -3095,24 +3213,40 @@ async function runAdd(args, options = {}) {
           process.exit(1);
         }
         if (options.list) {
-          if (agentFiles.length > 0) {
-            console.log();
-            p.log.step(pc2.bold("Agents"));
-            for (const af of agentFiles) {
-              p.log.message(`  ${pc2.cyan(af.name)}`);
-              if (af.description) p.log.message(`    ${pc2.dim(af.description)}`);
-            }
-          }
-          if (discoveredSkills.length > 0) {
-            console.log();
-            p.log.step(pc2.bold("Skills"));
-            for (const s of discoveredSkills) {
-              p.log.message(`  ${pc2.cyan(getSkillDisplayName(s))}`);
-              if (s.description) p.log.message(`    ${pc2.dim(s.description)}`);
+          const name = parsed.subpath ? basename3(parsed.subpath) : basename3(parsed.url);
+          const totalItems = agentFiles.length + discoveredSkills.length;
+          console.log();
+          console.log(
+            pc2.bold(pc2.cyan(name)) + pc2.dim(` (${totalItems} item${totalItems !== 1 ? "s" : ""})`)
+          );
+          const sections = [];
+          if (agentFiles.length > 0) sections.push({ label: "Agents", items: agentFiles });
+          if (discoveredSkills.length > 0)
+            sections.push({
+              label: "Skills",
+              items: discoveredSkills.map((s) => ({
+                name: getSkillDisplayName(s),
+                description: s.description
+              }))
+            });
+          for (let si = 0; si < sections.length; si++) {
+            const section = sections[si];
+            const isLastSection = si === sections.length - 1;
+            const sectionPrefix = isLastSection ? "\u2514\u2500\u2500 " : "\u251C\u2500\u2500 ";
+            const childIndent = isLastSection ? "    " : "\u2502   ";
+            console.log(
+              `${sectionPrefix}${pc2.bold(section.label)} ${pc2.dim(`(${section.items.length})`)}`
+            );
+            for (let ii = 0; ii < section.items.length; ii++) {
+              const item = section.items[ii];
+              const isLastItem = ii === section.items.length - 1;
+              const itemPrefix = isLastItem ? "\u2514\u2500\u2500 " : "\u251C\u2500\u2500 ";
+              const desc = item.description ? pc2.dim(` \u2014 ${item.description}`) : "";
+              console.log(`${childIndent}${itemPrefix}${pc2.cyan(item.name)}${desc}`);
             }
           }
           console.log();
-          p.outro("Run without --list to install");
+          p.outro(pc2.dim("Run without --list to install"));
           await cleanup(tempDir);
           process.exit(0);
         }
@@ -5681,9 +5815,17 @@ async function main() {
       break;
     }
     case "list":
-    case "ls":
-      await runList(restArgs);
+    case "ls": {
+      const listSources = restArgs.filter((a) => !a.startsWith("-"));
+      if (listSources.length > 0) {
+        showLogo();
+        const { source: addSource, options: addOpts } = parseAddOptions([...restArgs, "--list"]);
+        await runAdd(addSource, addOpts);
+      } else {
+        await runList(restArgs);
+      }
       break;
+    }
     case "check":
       runCheck(restArgs);
       break;
@@ -5700,8 +5842,14 @@ async function main() {
       console.log(VERSION);
       break;
     default:
-      console.log(`Unknown command: ${command}`);
-      console.log(`Run ${BOLD3}${binaryName} --help${RESET3} for usage.`);
+      if (process.env.IS_AICORE_CLI) {
+        showLogo();
+        const { source: addSource, options: addOpts } = parseAddOptions(args);
+        await runAdd(addSource, addOpts);
+      } else {
+        console.log(`Unknown command: ${command}`);
+        console.log(`Run ${BOLD3}${binaryName} --help${RESET3} for usage.`);
+      }
   }
 }
 main();

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "aicores",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "The open agent skills & subagents ecosystem",
   "type": "module",
   "bin": {
     "skills": "bin/cli.mjs",
     "agents": "bin/agents.mjs",
     "aicore": "bin/aicore.mjs",
+    "aicores": "bin/aicore.mjs",
     "add-skill": "bin/cli.mjs"
   },
   "files": [