@nucleoicons/skills 0.1.5 → 0.1.7

package/README.md

@@ -4,7 +4,7 @@ CLI to install and update **Nucleo** MCP + icon skills on your machine.
 
 Once installed, your AI coding tool can help you **use Nucleo icons in code**. Typical uses:
 
-- Search icons by name or idea across your licensed families (core, ui, sharp, micro, pixel)
+- Search icons by name or idea across your installed families (Pro and/or free)
 - Pick an icon and get the right React component or SVG for your project
 - Customize icons when inserting them (color, secondary color, stroke width, duo opacity, corners)
 
@@ -14,15 +14,23 @@ Requires **Node.js 20+**.
 
 ## Install
 
+**Pro** (Nucleo account — licensed families):
+
 ```bash
 npx @nucleoicons/skills setup --target react --tools cursor
 ```
 
+**Free** (no account — glass, arcade, isometric, flags, cursors, social-media, credit-cards):
+
+```bash
+npx @nucleoicons/skills setup --free --target react --tools cursor
+```
+
 **Required for setup:** `--target` (`react` or `vanilla`) and `--tools` (`cursor`, `claude`, `codex`).
 
 ```bash
 npx @nucleoicons/skills setup --target react --tools cursor
-npx @nucleoicons/skills setup --target vanilla --tools cursor,claude
+npx @nucleoicons/skills setup --free --target vanilla --tools cursor,claude
 ```
 
 Setup installs the package under your user home (`~/.nucleo/skills`) and configures the editors you choose (skills + MCP, no manual config step).
@@ -35,6 +43,8 @@ What Nucleo icon families do I have?
 
 ## Update
 
+Same command for free and Pro — the CLI remembers which package you installed (`--free` is not needed again):
+
 ```bash
 npx @nucleoicons/skills update
 ```

package/dist/api.d.ts

@@ -27,6 +27,7 @@ export interface SkillsReleaseFile {
 export interface SkillsReleaseData {
     version: string;
     target: PackageTarget | string;
+    tier?: "free" | "pro" | string;
     families: string[];
     downloadReady: boolean;
     files: SkillsReleaseFile[];
@@ -47,6 +48,10 @@ export declare function skillsLogin(email: string, password: string): Promise<Sk
  * Response: { data: { version, families, files, downloadReady } }
  */
 export declare function fetchSkillsRelease(token: string, target: PackageTarget): Promise<SkillsReleaseData>;
+/**
+ * GET /skills/release-free?target=react|vanilla (no auth)
+ */
+export declare function fetchSkillsFreeRelease(target: PackageTarget): Promise<SkillsReleaseData>;
 declare function formatBytes(bytes: number): string;
 /** Download a remote file (signed R2 URL) to disk, with optional progress. */
 export declare function downloadUrlToFile(url: string, destPath: string, onProgress?: (progress: DownloadProgress) => void): Promise<{

package/dist/api.js

@@ -83,7 +83,26 @@ export async function fetchSkillsRelease(token, target) {
     if (!json.data?.version || !Array.isArray(json.data.files)) {
         throw new ApiError("Release response missing version/files.", res.status, body);
     }
-    return json.data;
+    return { ...json.data, tier: json.data.tier ?? "pro" };
+}
+/**
+ * GET /skills/release-free?target=react|vanilla (no auth)
+ */
+export async function fetchSkillsFreeRelease(target) {
+    const url = new URL(`${getApiBaseUrl()}/skills/release-free`);
+    url.searchParams.set("target", target);
+    const res = await fetch(url, {
+        headers: { Accept: "application/json" },
+    });
+    const body = await readErrorBody(res);
+    if (!res.ok) {
+        throw new ApiError(parseApiErrorMessage(body, `Could not fetch free release (${res.status}).`), res.status, body);
+    }
+    const json = JSON.parse(body);
+    if (!json.data?.version || !Array.isArray(json.data.files)) {
+        throw new ApiError("Free release response missing version/files.", res.status, body);
+    }
+    return { ...json.data, tier: json.data.tier ?? "free" };
 }
 function formatBytes(bytes) {
     if (bytes < 1024) {

package/dist/commands/setup.d.ts

@@ -6,5 +6,7 @@ export interface SetupOptions {
     tools?: AgentTool[];
     email?: string;
     yes?: boolean;
+    /** Free icons package — no Nucleo login */
+    free?: boolean;
 }
 export declare function runSetup(options?: SetupOptions): Promise<void>;

package/dist/commands/setup.js

@@ -1,11 +1,11 @@
-import { mkdir } from "node:fs/promises";
 import { confirm, select, checkbox } from "@inquirer/prompts";
-import { ApiError, fetchSkillsRelease } from "../api.js";
+import { mkdir } from "node:fs/promises";
+import { ApiError, fetchSkillsFreeRelease, fetchSkillsRelease } from "../api.js";
 import { installRoot, nucleoHomeDir } from "../config.js";
 import { buildMcp, ensureManifestTarget, installFromLocalDir, installFromRelease, readInstallManifest, } from "../install.js";
 import { configureTool } from "../adapters/agents.js";
 import { ensureSkillsSession, isInvalidTokenError } from "../session.js";
-async function fetchReleaseWithSession(target, emailHint) {
+async function fetchProReleaseWithSession(target, emailHint) {
     let session = await ensureSkillsSession(emailHint);
     try {
         return await fetchSkillsRelease(session.token, target);
@@ -20,8 +20,9 @@ async function fetchReleaseWithSession(target, emailHint) {
     }
 }
 export async function runSetup(options = {}) {
-    console.log("\nNucleo Skills setup");
-    console.log("───────────────────\n");
+    const free = Boolean(options.free);
+    console.log(free ? "\nNucleo Skills setup (free)" : "\nNucleo Skills setup");
+    console.log(free ? "─────────────────────────\n" : "───────────────────\n");
     const target = options.target ??
         (await select({
             message: "Which package?",
@@ -57,13 +58,34 @@ export async function runSetup(options = {}) {
             }
         }
         await installFromLocalDir(options.from);
-        await ensureManifestTarget(target);
+        await ensureManifestTarget(target, {
+            tier: free ? "free" : "pro",
+            product: free ? "nucleo-skills-free" : "nucleo-skills",
+        });
+    }
+    else if (free) {
+        console.log(`Fetching free ${target} release…`);
+        let release;
+        try {
+            release = await fetchSkillsFreeRelease(target);
+        }
+        catch (error) {
+            if (error instanceof ApiError) {
+                throw new Error(error.message);
+            }
+            throw error;
+        }
+        console.log(`  Version:  ${release.version}`);
+        console.log(`  Families: ${release.families.join(", ")}`);
+        console.log(`  Files:    ${release.files.map((f) => f.id).join(", ")}`);
+        console.log("\nDownloading…");
+        await installFromRelease(release, target);
     }
     else {
         console.log(`Fetching ${target} release…`);
         let release;
         try {
-            release = await fetchReleaseWithSession(target, options.email);
+            release = await fetchProReleaseWithSession(target, options.email);
         }
         catch (error) {
             if (error instanceof ApiError) {
@@ -87,8 +109,7 @@ export async function runSetup(options = {}) {
     console.log("\n✓ Done");
     console.log(`  Install path: ${installRoot()}`);
     console.log(`  Target:       ${manifest?.target ?? target}`);
+    console.log(`  Tier:         ${manifest?.tier ?? (free ? "free" : "pro")}`);
     console.log(`  Version:      ${manifest?.version ?? "(none)"}`);
-    console.log(`  Families:     ${(manifest?.families ?? []).join(", ") || "(see manifest)"}`);
-    console.log("\nNext: reload MCP in your editor, then ask:");
-    console.log('  “What Nucleo icon families do I have?”\n');
+    console.log("\nReload MCP in your editor, then try asking about Nucleo icons.\n");
 }

package/dist/commands/status.js

@@ -23,6 +23,7 @@ export async function runStatus() {
     const manifest = await readInstallManifest();
     console.log(`Version:     ${manifest?.version ?? "(missing)"}`);
     console.log(`Target:      ${manifest?.target ?? "(missing)"}`);
+    console.log(`Tier:        ${manifest?.tier ?? "(missing)"}`);
     console.log(`Product:     ${manifest?.product ?? "(missing)"}`);
     console.log(`Families:    ${(manifest?.families ?? []).join(", ") || "(none)"}`);
     console.log(`MCP entry:   ${existsSync(mcpEntryPath()) ? mcpEntryPath() : "(missing — run setup/update)"}`);

package/dist/commands/update.js

@@ -1,10 +1,10 @@
 import { confirm } from "@inquirer/prompts";
-import { ApiError, fetchSkillsRelease } from "../api.js";
+import { ApiError, fetchSkillsFreeRelease, fetchSkillsRelease } from "../api.js";
 import { installRoot } from "../config.js";
 import { buildMcp, ensureManifestTarget, installFromLocalDir, installFromRelease, readInstallManifest, } from "../install.js";
 import { configureTool } from "../adapters/agents.js";
 import { ensureSkillsSession, isInvalidTokenError } from "../session.js";
-async function fetchReleaseWithSession(target) {
+async function fetchProReleaseWithSession(target) {
     let session = await ensureSkillsSession();
     try {
         return await fetchSkillsRelease(session.token, target);
@@ -18,6 +18,18 @@ async function fetchReleaseWithSession(target) {
         throw error;
     }
 }
+function isFreeInstall(manifest) {
+    if (!manifest) {
+        return false;
+    }
+    if (manifest.tier === "free") {
+        return true;
+    }
+    if (typeof manifest.product === "string" && manifest.product.includes("free")) {
+        return true;
+    }
+    return false;
+}
 export async function runUpdate(options = {}) {
     console.log("\nNucleo Skills update");
     console.log("────────────────────\n");
@@ -27,10 +39,14 @@ export async function runUpdate(options = {}) {
     }
     const target = manifest?.target ?? "react";
     const localVersion = manifest?.version ?? "0.0.0";
+    const free = isFreeInstall(manifest);
     if (options.from) {
         console.log(`Updating from local folder:\n  ${options.from}\n`);
         await installFromLocalDir(options.from);
-        await ensureManifestTarget(target);
+        await ensureManifestTarget(target, {
+            tier: free ? "free" : "pro",
+            product: free ? "nucleo-skills-free" : "nucleo-skills",
+        });
         console.log("Building MCP…");
         await buildMcp();
         await reconfigure(options.tools);
@@ -41,7 +57,14 @@ export async function runUpdate(options = {}) {
     }
     let release;
     try {
-        release = await fetchReleaseWithSession(target);
+        if (free) {
+            console.log("Channel:     free");
+            release = await fetchSkillsFreeRelease(target);
+        }
+        else {
+            console.log("Channel:     pro");
+            release = await fetchProReleaseWithSession(target);
+        }
     }
     catch (error) {
         if (error instanceof ApiError) {

package/dist/config.d.ts

@@ -15,6 +15,8 @@ export interface NucleoCredentials {
 }
 export interface InstallManifest {
     product?: string;
+    /** free | pro — drives update channel without requiring --free again */
+    tier?: "free" | "pro" | string;
     target?: PackageTarget | string;
     version?: string;
     families?: string[];

package/dist/index.js

@@ -54,6 +54,7 @@ program
     .description("Sign in, download your licensed package, configure your editor")
     .option("-t, --target <target>", "react | vanilla")
     .option("--tools <list>", "comma-separated: cursor,claude,codex (default: prompt, or cursor with --yes)")
+    .option("--free", "Install free icon families (no Nucleo login)")
     .option("--from <dir>", "Install from a local prepared package (skip API download)")
     .option("--email <email>", "Nucleo account email (skip prompt)")
     .option("-y, --yes", "Skip confirmation prompts")
@@ -70,6 +71,7 @@ program
             tools,
             email: opts.email,
             yes: Boolean(opts.yes),
+            free: Boolean(opts.free),
         });
     }
     catch (error) {

package/dist/install.d.ts

@@ -1,5 +1,11 @@
 import { type SkillsReleaseData } from "./api.js";
 import { type InstallManifest, type PackageTarget } from "./config.js";
+/**
+ * Resolve a real npm binary. Prefer the one next to the running Node
+ * (`process.execPath`) so we don't depend on PATH / shell aliases
+ * (common cause of `spawn npm ENOENT` even when `npm -v` works in zsh).
+ */
+export declare function resolveNpmBin(): string;
 export declare function readInstallManifest(root?: string): Promise<InstallManifest | null>;
 export declare function cleanInstallRoot(root?: string): Promise<void>;
 /**

package/dist/install.js

@@ -1,12 +1,47 @@
 import { existsSync } from "node:fs";
 import { cp, mkdir, readdir, readFile, rm, stat, writeFile } from "node:fs/promises";
-import { join } from "node:path";
+import { dirname, join } from "node:path";
 import { execFile } from "node:child_process";
 import { promisify } from "node:util";
 import extract from "extract-zip";
 import { downloadUrlToFile, formatBytes } from "./api.js";
 import { installRoot, nucleoHomeDir } from "./config.js";
 const execFileAsync = promisify(execFile);
+/**
+ * Resolve a real npm binary. Prefer the one next to the running Node
+ * (`process.execPath`) so we don't depend on PATH / shell aliases
+ * (common cause of `spawn npm ENOENT` even when `npm -v` works in zsh).
+ */
+export function resolveNpmBin() {
+    const binDir = dirname(process.execPath);
+    const candidates = process.platform === "win32"
+        ? [join(binDir, "npm.cmd"), join(binDir, "npm.exe"), "npm.cmd", "npm"]
+        : [join(binDir, "npm"), "npm"];
+    for (const candidate of candidates) {
+        if (candidate === "npm" || candidate === "npm.cmd" || existsSync(candidate)) {
+            return candidate;
+        }
+    }
+    return process.platform === "win32" ? "npm.cmd" : "npm";
+}
+async function runNpm(args, cwd) {
+    const npmBin = resolveNpmBin();
+    try {
+        await execFileAsync(npmBin, args, {
+            cwd,
+            env: process.env,
+            // Windows .cmd shims need a shell; Unix absolute paths do not.
+            shell: process.platform === "win32",
+        });
+    }
+    catch (error) {
+        const detail = error instanceof Error ? error.message : String(error);
+        throw new Error(`${detail}\n` +
+            `Tried to run: ${npmBin} ${args.join(" ")}\n` +
+            `If npm is installed, ensure it sits next to node (${process.execPath}), or run:\n` +
+            `  cd ${cwd} && npm ${args.join(" ")}`);
+    }
+}
 export async function readInstallManifest(root = installRoot()) {
     const path = join(root, "manifest.json");
     if (!existsSync(path)) {
@@ -138,7 +173,8 @@ export async function installFromRelease(release, target, root = installRoot())
         await rm(downloadsDir, { recursive: true, force: true }).catch(() => undefined);
     }
     await writeInstallManifest({
-        product: "nucleo-skills",
+        product: release.tier === "free" ? "nucleo-skills-free" : "nucleo-skills",
+        tier: release.tier === "free" ? "free" : "pro",
         target,
         version: release.version,
         families: release.families,
@@ -191,10 +227,7 @@ export async function buildMcp(root = installRoot()) {
     const hasDist = existsSync(distEntry);
     console.log("  npm install (mcp)…");
     try {
-        await execFileAsync("npm", ["install", "--omit=dev"], {
-            cwd: mcpDir,
-            env: process.env,
-        });
+        await runNpm(["install", "--omit=dev"], mcpDir);
     }
     catch (error) {
         const detail = error instanceof Error ? error.message : String(error);
@@ -203,10 +236,7 @@ export async function buildMcp(root = installRoot()) {
     if (!hasDist || existsSync(join(mcpDir, "src"))) {
         console.log("  npm run build (mcp)…");
         try {
-            await execFileAsync("npm", ["run", "build"], {
-                cwd: mcpDir,
-                env: process.env,
-            });
+            await runNpm(["run", "build"], mcpDir);
         }
         catch (error) {
             if (!existsSync(distEntry)) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nucleoicons/skills",
-  "version": "0.1.5",
-  "description": "CLI to install and update Nucleo Pro MCP + icon skills",
+  "version": "0.1.7",
+  "description": "CLI to install and update Nucleo MCP + icon skills (Pro and free)",
   "type": "module",
   "bin": {
     "nucleo-skills": "./dist/index.js"