@elnora-ai/cli 1.3.4 → 1.4.0

package/README.md

@@ -39,6 +39,50 @@ npm install -g @elnora-ai/cli
 brew install elnora-ai/cli/elnora
 ```
 
+## Skills & Setup
+
+After installing the CLI, configure your AI coding tools:
+
+```bash
+elnora setup
+```
+
+This auto-detects which tools you have installed and configures them:
+
+- **Claude Code** — registers the `elnora-plugins` marketplace and enables 9 skills (`elnora-tasks`, `elnora-projects`, `elnora-files`, etc.) so you can use natural language.
+- **Cursor / VS Code / Codex** — writes an MCP server config pointing at `https://mcp.elnora.ai/mcp` with your API key.
+
+Target a specific tool: `elnora setup claude` · `elnora setup cursor` · `elnora setup vscode` · `elnora setup codex`.
+
+### What You Get in Claude Code
+
+Once configured, restart Claude Code and try any natural-language request:
+
+> "Use Elnora to generate a PCR protocol for BRCA1 exon 11"
+> "Use Elnora to list my projects"
+> "Use Elnora to optimize the protocol in task abc-123"
+
+Claude will invoke the `elnora` CLI under the hood using the bundled skills. No need to memorize command syntax.
+
+### Where Everything Lives
+
+| What | Where |
+|------|-------|
+| CLI binary (macOS/Linux) | `~/.local/bin/elnora` |
+| CLI binary (Windows) | `%USERPROFILE%\.elnora\bin\elnora.exe` |
+| Auth / profiles | `~/.elnora/profiles.toml` (mode 0600) |
+| Claude Code skills | `~/.claude/plugins/marketplaces/elnora-plugins/elnora/skills/` (auto-updated) |
+| Claude Code settings | `~/.claude/settings.json` — look for `elnora@elnora-plugins: true` |
+
+### Manual Plugin Setup
+
+If `elnora setup claude` doesn't work for some reason, you can install the plugin manually:
+
+1. In Claude Code, run `/plugin`
+2. Choose "Add marketplace"
+3. Enter: `Elnora-AI/elnora-plugins`
+4. Run `/plugin` again → Plugins → Enable `elnora`
+
 ## Quick Start
 
 ```bash

package/dist/cli.js

@@ -25,7 +25,7 @@ var VERSION, PRODUCTION_BASE_URL, BASE_URL, AI_SERVER_URL, ENDPOINTS, DEFAULT_HE
 var init_config = __esm({
   "src/lib/config.ts"() {
     "use strict";
-    VERSION = true ? "1.3.4" : process.env.npm_package_version ?? "0.0.0-dev";
+    VERSION = true ? "1.4.0" : process.env.npm_package_version ?? "0.0.0-dev";
     PRODUCTION_BASE_URL = "https://platform.elnora.ai/api/v1";
     BASE_URL = process.env.ELNORA_API_URL ?? PRODUCTION_BASE_URL;
     AI_SERVER_URL = process.env.ELNORA_AI_SERVER_URL ?? "https://platform.elnora.ai/ai-server";
@@ -2005,18 +2005,70 @@ function addCompletionCommand(program2) {
 init_client();
 init_config();
 init_profiles();
-import { existsSync as existsSync3, statSync } from "node:fs";
-import pc2 from "picocolors";
+import { existsSync as existsSync4, readFileSync as readFileSync4, statSync } from "node:fs";
+import { homedir as homedir4 } from "node:os";
+import { delimiter, join as join4 } from "node:path";
+import pc3 from "picocolors";
 
-// src/lib/update-check.ts
-init_config();
+// src/lib/setup/common.ts
 import { existsSync as existsSync2, mkdirSync as mkdirSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "node:fs";
 import { homedir as homedir2 } from "node:os";
 import { join as join2 } from "node:path";
 import pc from "picocolors";
+var HOME = homedir2();
+var ELNORA_DIR = join2(HOME, ".elnora");
+var CLAUDE_DIR = join2(HOME, ".claude");
+var CLAUDE_MARKETPLACES_FILE = join2(CLAUDE_DIR, "plugins", "known_marketplaces.json");
+var CLAUDE_SETTINGS_FILE = join2(CLAUDE_DIR, "settings.json");
+var CURSOR_DIR = join2(HOME, ".cursor");
+var CURSOR_MCP_GLOBAL = join2(HOME, ".cursor", "mcp.json");
+var VSCODE_DIR = join2(HOME, ".vscode");
+var CODEX_DIR = join2(HOME, ".codex");
+var MARKETPLACE_NAME = "elnora-plugins";
+var MARKETPLACE_REPO = "Elnora-AI/elnora-plugins";
+var PLUGIN_ID = `elnora@${MARKETPLACE_NAME}`;
+var LEGACY_PLUGIN_IDS = ["elnora@elnora-local", "elnora@elnora-ai"];
+var LEGACY_MARKETPLACE_NAMES = ["elnora-local", "elnora-ai"];
+function readJsonFile(path) {
+  try {
+    return JSON.parse(readFileSync2(path, "utf-8"));
+  } catch {
+    return {};
+  }
+}
+function writeJsonFile(path, data) {
+  mkdirSync2(join2(path, ".."), { recursive: true });
+  writeFileSync2(path, `${JSON.stringify(data, null, 2)}
+`, "utf-8");
+}
+var color = isColorEnabled();
+function ok(msg) {
+  return color ? `  ${pc.green("\u2713")} ${msg}` : `  \u2713 ${msg}`;
+}
+function fail(msg) {
+  return color ? `  ${pc.red("\u2717")} ${msg}` : `  \u2717 ${msg}`;
+}
+function info(msg) {
+  return color ? `  ${pc.dim(msg)}` : `  ${msg}`;
+}
+function detectPlatforms() {
+  return [
+    { name: "claude", label: "Claude Code", installed: existsSync2(CLAUDE_DIR) },
+    { name: "cursor", label: "Cursor", installed: existsSync2(CURSOR_DIR) },
+    { name: "vscode", label: "VS Code", installed: existsSync2(VSCODE_DIR) },
+    { name: "codex", label: "OpenAI Codex", installed: existsSync2(CODEX_DIR) }
+  ];
+}
+
+// src/lib/update-check.ts
+init_config();
+import { existsSync as existsSync3, mkdirSync as mkdirSync3, readFileSync as readFileSync3, writeFileSync as writeFileSync3 } from "node:fs";
+import { homedir as homedir3 } from "node:os";
+import { join as join3 } from "node:path";
+import pc2 from "picocolors";
 var NPM_REGISTRY_URL = "https://registry.npmjs.org/@elnora-ai/cli/latest";
-var CACHE_DIR = join2(homedir2(), ".elnora");
-var CACHE_FILE = join2(CACHE_DIR, ".update-check");
+var CACHE_DIR = join3(homedir3(), ".elnora");
+var CACHE_FILE = join3(CACHE_DIR, ".update-check");
 var CHECK_INTERVAL_MS = 24 * 60 * 60 * 1e3;
 var FETCH_TIMEOUT_MS = 3e3;
 var SEMVER_RE = /^\d+\.\d+\.\d+(?:-[\w.]+)?(?:\+[\w.]+)?$/;
@@ -2027,8 +2079,8 @@ function shouldSkipEntirely() {
 }
 function readCache() {
   try {
-    if (!existsSync2(CACHE_FILE)) return null;
-    const raw = readFileSync2(CACHE_FILE, "utf-8");
+    if (!existsSync3(CACHE_FILE)) return null;
+    const raw = readFileSync3(CACHE_FILE, "utf-8");
     return JSON.parse(raw);
   } catch {
     return null;
@@ -2036,8 +2088,8 @@ function readCache() {
 }
 function writeCache(entry) {
   try {
-    mkdirSync2(CACHE_DIR, { recursive: true });
-    writeFileSync2(CACHE_FILE, JSON.stringify(entry), "utf-8");
+    mkdirSync3(CACHE_DIR, { recursive: true });
+    writeFileSync3(CACHE_FILE, JSON.stringify(entry), "utf-8");
   } catch {
   }
 }
@@ -2045,7 +2097,7 @@ function showUpdateNotice(latest) {
   if (!process.stderr.isTTY) return;
   const color2 = isColorEnabled();
   const msg = color2 ? `
-${pc.yellow(`Update available: v${VERSION} \u2192 v${latest}`)}
+${pc2.yellow(`Update available: v${VERSION} \u2192 v${latest}`)}
 Run: elnora update
 ` : `
 Update available: v${VERSION} \u2192 v${latest}
@@ -2101,99 +2153,275 @@ function registerUpdateCheck() {
 }
 
 // src/commands/doctor.ts
+var EXPECTED_SKILLS = [
+  "elnora-admin",
+  "elnora-agent",
+  "elnora-files",
+  "elnora-folders",
+  "elnora-orgs",
+  "elnora-platform",
+  "elnora-projects",
+  "elnora-search",
+  "elnora-tasks"
+];
+async function runCheck(fn) {
+  try {
+    return await fn();
+  } catch (e) {
+    return { status: "fail", msg: `${e instanceof Error ? e.message : String(e)}` };
+  }
+}
+async function checkApiReachable() {
+  const start = Date.now();
+  const res = await fetch("https://platform.elnora.ai/health", { signal: AbortSignal.timeout(5e3) });
+  const ms = Date.now() - start;
+  if (res.ok) return { status: "pass", msg: `API reachable         platform.elnora.ai (${res.status} OK, ${ms}ms)` };
+  return { status: "fail", msg: `API unreachable       platform.elnora.ai (HTTP ${res.status})` };
+}
+async function checkAuthenticated() {
+  const key = resolveApiKey();
+  const client = new ElnoraApiClient(key);
+  const result = await client.get("projects", {
+    queryParams: { page: 1, pageSize: 1 }
+  });
+  const count = result?.totalCount ?? result?.items?.length ?? 0;
+  return { status: "pass", msg: `Authenticated         profile: default (${count} projects accessible)` };
+}
+async function checkVersionCurrent() {
+  try {
+    const res = await fetch("https://registry.npmjs.org/@elnora-ai/cli/latest", {
+      signal: AbortSignal.timeout(3e3)
+    });
+    if (!res.ok) return { status: "pass", msg: `Version               v${VERSION} (registry check failed)` };
+    const data = await res.json();
+    const latest = data.version ?? "unknown";
+    if (latest === VERSION || latest === "unknown" || !isNewerVersion(latest, VERSION)) {
+      return { status: "pass", msg: `Version current       v${VERSION} (latest: v${latest})` };
+    }
+    return { status: "warn", msg: `Update available      v${VERSION} \u2192 v${latest}` };
+  } catch {
+    return { status: "pass", msg: `Version               v${VERSION} (registry unreachable)` };
+  }
+}
+function checkConfigPermissions() {
+  if (process.platform === "win32") {
+    return { status: "pass", msg: "Config permissions    (skipped on Windows)" };
+  }
+  if (!existsSync4(PROFILES_FILE)) {
+    return { status: "warn", msg: "Config permissions    ~/.elnora/profiles.toml not found" };
+  }
+  const mode = statSync(PROFILES_FILE).mode & 511;
+  if (mode === 384) {
+    return { status: "pass", msg: `Config permissions    ${PROFILES_FILE} (0600)` };
+  }
+  return { status: "warn", msg: `Config permissions    ${PROFILES_FILE} (0${mode.toString(8)}) \u2014 should be 0600` };
+}
+async function checkAiServerReachable() {
+  const start = Date.now();
+  const res = await fetch(`${AI_SERVER_URL}/health`, { signal: AbortSignal.timeout(5e3) });
+  const ms = Date.now() - start;
+  const host = new URL(AI_SERVER_URL).hostname;
+  if (res.ok) return { status: "pass", msg: `AI Server reachable   ${host} (${res.status} OK, ${ms}ms)` };
+  return { status: "fail", msg: `AI Server unreachable ${host} (HTTP ${res.status})` };
+}
+function checkPathConfigured() {
+  const installDirs = [join4(homedir4(), ".local", "bin"), join4(homedir4(), ".elnora", "bin")];
+  const pathVar = process.env.PATH ?? "";
+  const entries = pathVar.split(delimiter).filter(Boolean);
+  const matched = installDirs.find((d) => entries.includes(d));
+  if (matched) {
+    return { status: "pass", msg: `PATH configured       ${matched}` };
+  }
+  return {
+    status: "warn",
+    msg: "PATH configured       standard install dirs not in PATH (OK if installed via npm/brew)"
+  };
+}
+function checkClaudePlugin() {
+  if (!existsSync4(CLAUDE_DIR)) {
+    return { status: "skip", msg: "Plugin enabled         (Claude Code not installed)" };
+  }
+  if (!existsSync4(CLAUDE_SETTINGS_FILE)) {
+    return { status: "fail", msg: "Plugin enabled         settings.json not found \u2014 run 'elnora setup claude'" };
+  }
+  let settings;
+  try {
+    settings = JSON.parse(readFileSync4(CLAUDE_SETTINGS_FILE, "utf-8"));
+  } catch (e) {
+    return {
+      status: "fail",
+      msg: `Plugin enabled         settings.json unreadable (${e instanceof Error ? e.message : "parse error"})`
+    };
+  }
+  const raw = settings.enabledPlugins;
+  const enabledPlugins = typeof raw === "object" && raw !== null && !Array.isArray(raw) ? raw : {};
+  const isEnabled = enabledPlugins[PLUGIN_ID] === true;
+  const legacyKeys = Object.keys(enabledPlugins).filter((k) => k.startsWith("elnora@") && k !== PLUGIN_ID);
+  if (isEnabled && legacyKeys.length === 0) {
+    return { status: "pass", msg: `Plugin enabled         ${PLUGIN_ID}` };
+  }
+  if (isEnabled && legacyKeys.length > 0) {
+    return {
+      status: "warn",
+      msg: `Plugin enabled         ${PLUGIN_ID} \u2014 but stale legacy entries also present: ${legacyKeys.join(", ")}`
+    };
+  }
+  if (legacyKeys.length > 0) {
+    return {
+      status: "fail",
+      msg: `Plugin enabled         found legacy entries ${legacyKeys.join(", ")} but not ${PLUGIN_ID} \u2014 run 'elnora setup claude'`
+    };
+  }
+  return { status: "fail", msg: "Plugin enabled         not found \u2014 run 'elnora setup claude'" };
+}
+function checkSkillsInstalled() {
+  if (!existsSync4(CLAUDE_DIR)) {
+    return { status: "skip", msg: "Skills installed       (Claude Code not installed)" };
+  }
+  const skillsDir = join4(CLAUDE_DIR, "plugins", "marketplaces", MARKETPLACE_NAME, "elnora", "skills");
+  if (!existsSync4(skillsDir)) {
+    return {
+      status: "warn",
+      msg: "Skills installed       marketplace not cloned yet \u2014 restart Claude Code to trigger clone"
+    };
+  }
+  const found = EXPECTED_SKILLS.filter((s) => existsSync4(join4(skillsDir, s, "SKILL.md")));
+  if (found.length === EXPECTED_SKILLS.length) {
+    return { status: "pass", msg: `Skills installed       ${found.length} skills` };
+  }
+  const missing = EXPECTED_SKILLS.filter((s) => !found.includes(s));
+  return {
+    status: "fail",
+    msg: `Skills installed       ${found.length}/${EXPECTED_SKILLS.length} \u2014 missing: ${missing.join(", ")}`
+  };
+}
+function checkPluginVersion() {
+  if (!existsSync4(CLAUDE_DIR)) {
+    return { status: "skip", msg: "Plugin version         (Claude Code not installed)" };
+  }
+  const pluginJsonPath = join4(
+    CLAUDE_DIR,
+    "plugins",
+    "marketplaces",
+    MARKETPLACE_NAME,
+    "elnora",
+    ".claude-plugin",
+    "plugin.json"
+  );
+  if (!existsSync4(pluginJsonPath)) {
+    return { status: "skip", msg: "Plugin version         (plugin not cloned yet)" };
+  }
+  try {
+    const pj = JSON.parse(readFileSync4(pluginJsonPath, "utf-8"));
+    const pluginVersion = pj.version ?? "unknown";
+    if (pluginVersion === VERSION) {
+      return { status: "pass", msg: `Plugin version         v${pluginVersion} (matches CLI)` };
+    }
+    return {
+      status: "warn",
+      msg: `Plugin version         v${pluginVersion} (CLI is v${VERSION}) \u2014 restart Claude Code to refresh`
+    };
+  } catch (e) {
+    return {
+      status: "fail",
+      msg: `Plugin version         plugin.json unreadable (${e instanceof Error ? e.message : "parse error"})`
+    };
+  }
+}
+async function checkMcpReachable() {
+  const start = Date.now();
+  try {
+    const res = await fetch("https://mcp.elnora.ai/mcp", {
+      method: "HEAD",
+      signal: AbortSignal.timeout(5e3)
+    });
+    const ms = Date.now() - start;
+    if (res.status < 500) {
+      return { status: "pass", msg: `Server reachable       mcp.elnora.ai (${res.status}, ${ms}ms)` };
+    }
+    return { status: "fail", msg: `Server unreachable     mcp.elnora.ai (HTTP ${res.status})` };
+  } catch (e) {
+    return {
+      status: "fail",
+      msg: `Server unreachable     mcp.elnora.ai (${e instanceof Error ? e.message : "network error"})`
+    };
+  }
+}
 function addDoctorCommand(program2) {
   program2.command("doctor").description("Check Elnora CLI configuration and connectivity").action(async () => {
     const color2 = isColorEnabled();
-    const ok2 = (msg) => color2 ? `  ${pc2.green("\u2713")} ${msg}` : `  \u2713 ${msg}`;
-    const fail2 = (msg) => color2 ? `  ${pc2.red("\u2717")} ${msg}` : `  \u2717 ${msg}`;
-    const warn = (msg) => color2 ? `  ${pc2.yellow("!")} ${msg}` : `  ! ${msg}`;
+    const ok2 = (msg) => color2 ? `  ${pc3.green("\u2713")} ${msg}` : `  \u2713 ${msg}`;
+    const fail2 = (msg) => color2 ? `  ${pc3.red("\u2717")} ${msg}` : `  \u2717 ${msg}`;
+    const warn = (msg) => color2 ? `  ${pc3.yellow("!")} ${msg}` : `  ! ${msg}`;
+    const skip = (msg) => color2 ? `  ${pc3.dim("\u25CB")} ${msg}` : `  \u25CB ${msg}`;
+    const section = (name) => color2 ? pc3.bold(`  ${name}`) : `  ${name}`;
+    const render = (r) => {
+      switch (r.status) {
+        case "pass":
+          return ok2(r.msg);
+        case "fail":
+          return fail2(r.msg);
+        case "warn":
+          return warn(r.msg);
+        case "skip":
+          return skip(r.msg);
+      }
+    };
     console.error(`
 Elnora CLI v${VERSION}
 `);
     let passed = 0;
+    let failed = 0;
+    let warnings = 0;
     let total = 0;
-    total++;
-    try {
-      const start = Date.now();
-      const res = await fetch("https://platform.elnora.ai/health", { signal: AbortSignal.timeout(5e3) });
-      const ms = Date.now() - start;
-      if (res.ok) {
-        console.error(ok2(`API reachable         platform.elnora.ai (${res.status} OK, ${ms}ms)`));
+    const tally = (r) => {
+      total++;
+      if (r.status === "pass" || r.status === "skip") passed++;
+      else if (r.status === "warn") {
         passed++;
-      } else console.error(fail2(`API unreachable       platform.elnora.ai (HTTP ${res.status})`));
-    } catch (e) {
-      console.error(
-        fail2(`API unreachable       platform.elnora.ai (${e instanceof Error ? e.message : "network error"})`)
-      );
-    }
-    total++;
-    try {
-      const key = resolveApiKey();
-      const client = new ElnoraApiClient(key);
-      const result = await client.get("projects", {
-        queryParams: { page: 1, pageSize: 1 }
-      });
-      const count = result?.totalCount ?? result?.items?.length ?? 0;
-      console.error(ok2(`Authenticated         profile: default (${count} projects accessible)`));
-      passed++;
-    } catch (e) {
-      console.error(fail2(`Authentication failed ${e instanceof Error ? e.message : "no API key"}`));
-    }
-    total++;
-    try {
-      const res = await fetch("https://registry.npmjs.org/@elnora-ai/cli/latest", {
-        signal: AbortSignal.timeout(3e3)
-      });
-      if (res.ok) {
-        const data = await res.json();
-        const latest = data.version ?? "unknown";
-        if (latest === VERSION || latest === "unknown" || !isNewerVersion(latest, VERSION)) {
-          console.error(ok2(`Version current       v${VERSION} (latest: v${latest})`));
-        } else {
-          console.error(warn(`Update available      v${VERSION} \u2192 v${latest}`));
-        }
-        passed++;
-      } else {
-        console.error(ok2(`Version               v${VERSION} (registry check failed)`));
-        passed++;
-      }
-    } catch {
-      console.error(ok2(`Version               v${VERSION} (registry unreachable)`));
-      passed++;
+        warnings++;
+      } else failed++;
+    };
+    console.error(section("CLI"));
+    const cliChecks = [
+      await runCheck(() => checkApiReachable()),
+      await runCheck(() => checkAuthenticated()),
+      await runCheck(() => checkVersionCurrent()),
+      await runCheck(() => checkConfigPermissions()),
+      await runCheck(() => checkAiServerReachable()),
+      await runCheck(() => checkPathConfigured())
+    ];
+    for (const r of cliChecks) {
+      console.error(render(r));
+      tally(r);
     }
-    total++;
-    if (process.platform === "win32") {
-      console.error(ok2("Config permissions    (skipped on Windows)"));
-      passed++;
-    } else if (!existsSync3(PROFILES_FILE)) {
-      console.error(warn("Config permissions    ~/.elnora/profiles.toml not found"));
-    } else {
-      const mode = statSync(PROFILES_FILE).mode & 511;
-      if (mode === 384) {
-        console.error(ok2(`Config permissions    ${PROFILES_FILE} (0600)`));
-        passed++;
-      } else {
-        console.error(warn(`Config permissions    ${PROFILES_FILE} (0${mode.toString(8)}) \u2014 should be 0600`));
-      }
+    console.error("");
+    console.error(section("Claude Code"));
+    const claudeChecks = [
+      await runCheck(() => checkClaudePlugin()),
+      await runCheck(() => checkSkillsInstalled()),
+      await runCheck(() => checkPluginVersion())
+    ];
+    for (const r of claudeChecks) {
+      console.error(render(r));
+      tally(r);
     }
-    total++;
-    try {
-      const start = Date.now();
-      const res = await fetch(`${AI_SERVER_URL}/health`, { signal: AbortSignal.timeout(5e3) });
-      const ms = Date.now() - start;
-      if (res.ok) {
-        console.error(ok2(`AI Server reachable   ${new URL(AI_SERVER_URL).hostname} (${res.status} OK, ${ms}ms)`));
-        passed++;
-      } else console.error(fail2(`AI Server unreachable ${new URL(AI_SERVER_URL).hostname} (HTTP ${res.status})`));
-    } catch {
-      console.error(fail2(`AI Server unreachable ${AI_SERVER_URL}`));
+    console.error("");
+    console.error(section("MCP"));
+    const mcpChecks = [await runCheck(() => checkMcpReachable())];
+    for (const r of mcpChecks) {
+      console.error(render(r));
+      tally(r);
     }
     console.error("");
-    if (passed === total) {
+    if (failed === 0 && warnings === 0) {
       console.error("All checks passed.");
+    } else if (failed === 0) {
+      console.error(`${passed}/${total} checks passed (${warnings} warning${warnings === 1 ? "" : "s"}).`);
     } else {
-      console.error(`${passed}/${total} checks passed.`);
-      if (!existsSync3(PROFILES_FILE)) console.error("\nRun: elnora auth login");
+      const warnSuffix = warnings > 0 ? ` (${warnings} warning${warnings === 1 ? "" : "s"})` : "";
+      console.error(`${passed}/${total} checks passed \u2014 ${failed} failed${warnSuffix}.`);
+      if (!existsSync4(PROFILES_FILE)) console.error("\nRun: elnora auth login");
     }
   });
 }
@@ -2586,7 +2814,7 @@ var filesUpdate = {
 
 // src/commands/files/upload.ts
 init_client();
-import { readFileSync as readFileSync3, statSync as statSync2 } from "node:fs";
+import { readFileSync as readFileSync5, statSync as statSync2 } from "node:fs";
 import { basename } from "node:path";
 import { z as z37 } from "zod";
 var inputSchema36 = z37.object({
@@ -2602,7 +2830,7 @@ var filesUpload = {
   inputSchema: inputSchema36,
   outputSchema: z37.any(),
   async execute(input, ctx) {
-    const fileBuffer = readFileSync3(input.filePath);
+    const fileBuffer = readFileSync5(input.filePath);
     const fileName = input.fileName ?? basename(input.filePath);
     const contentType = input.contentType ?? "application/octet-stream";
     const fileSize = statSync2(input.filePath).size;
@@ -2633,7 +2861,7 @@ var filesUpload = {
 // src/commands/files/upload-batch.ts
 init_client();
 init_errors();
-import { readFileSync as readFileSync4, statSync as statSync3 } from "node:fs";
+import { readFileSync as readFileSync6, statSync as statSync3 } from "node:fs";
 import { basename as basename2 } from "node:path";
 import { z as z38 } from "zod";
 var inputSchema37 = z38.object({
@@ -2662,7 +2890,7 @@ var filesUploadBatch = {
     for (const filePath of paths) {
       const fileName = basename2(filePath);
       try {
-        const fileBuffer = readFileSync4(filePath);
+        const fileBuffer = readFileSync6(filePath);
         const contentType = "application/octet-stream";
         const fileSize = statSync3(filePath).size;
         const uploadInfo = await ctx.client.post("file_upload", {
@@ -4132,58 +4360,6 @@ init_profiles();
 
 // src/lib/setup/claude.ts
 import { existsSync as existsSync5 } from "node:fs";
-
-// src/lib/setup/common.ts
-import { existsSync as existsSync4, mkdirSync as mkdirSync3, readFileSync as readFileSync5, writeFileSync as writeFileSync3 } from "node:fs";
-import { homedir as homedir3 } from "node:os";
-import { join as join3 } from "node:path";
-import pc3 from "picocolors";
-var HOME = homedir3();
-var ELNORA_DIR = join3(HOME, ".elnora");
-var CLAUDE_DIR = join3(HOME, ".claude");
-var CLAUDE_MARKETPLACES_FILE = join3(CLAUDE_DIR, "plugins", "known_marketplaces.json");
-var CLAUDE_SETTINGS_FILE = join3(CLAUDE_DIR, "settings.json");
-var CURSOR_DIR = join3(HOME, ".cursor");
-var CURSOR_MCP_GLOBAL = join3(HOME, ".cursor", "mcp.json");
-var VSCODE_DIR = join3(HOME, ".vscode");
-var CODEX_DIR = join3(HOME, ".codex");
-var MARKETPLACE_NAME = "elnora-ai";
-var MARKETPLACE_REPO = "Elnora-AI/elnora-plugins";
-var PLUGIN_ID = `elnora@${MARKETPLACE_NAME}`;
-var LEGACY_PLUGIN_IDS = ["elnora@elnora-local"];
-var LEGACY_MARKETPLACE_NAMES = ["elnora-local"];
-function readJsonFile(path) {
-  try {
-    return JSON.parse(readFileSync5(path, "utf-8"));
-  } catch {
-    return {};
-  }
-}
-function writeJsonFile(path, data) {
-  mkdirSync3(join3(path, ".."), { recursive: true });
-  writeFileSync3(path, `${JSON.stringify(data, null, 2)}
-`, "utf-8");
-}
-var color = isColorEnabled();
-function ok(msg) {
-  return color ? `  ${pc3.green("\u2713")} ${msg}` : `  \u2713 ${msg}`;
-}
-function fail(msg) {
-  return color ? `  ${pc3.red("\u2717")} ${msg}` : `  \u2717 ${msg}`;
-}
-function info(msg) {
-  return color ? `  ${pc3.dim(msg)}` : `  ${msg}`;
-}
-function detectPlatforms() {
-  return [
-    { name: "claude", label: "Claude Code", installed: existsSync4(CLAUDE_DIR) },
-    { name: "cursor", label: "Cursor", installed: existsSync4(CURSOR_DIR) },
-    { name: "vscode", label: "VS Code", installed: existsSync4(VSCODE_DIR) },
-    { name: "codex", label: "OpenAI Codex", installed: existsSync4(CODEX_DIR) }
-  ];
-}
-
-// src/lib/setup/claude.ts
 function setupClaude() {
   if (!existsSync5(CLAUDE_DIR)) {
     console.error(fail("Claude Code not found (~/.claude/ does not exist)"));
@@ -4223,8 +4399,8 @@ function setupClaude() {
 
 // src/lib/setup/codex.ts
 import { existsSync as existsSync6 } from "node:fs";
-import { join as join4 } from "node:path";
-var CODEX_MCP_FILE = join4(CODEX_DIR, "mcp.json");
+import { join as join5 } from "node:path";
+var CODEX_MCP_FILE = join5(CODEX_DIR, "mcp.json");
 function setupCodex(apiKey) {
   if (!existsSync6(CODEX_DIR)) {
     console.error(fail("Codex CLI not found (~/.codex/ does not exist)"));
@@ -4280,8 +4456,8 @@ function setupCursor(apiKey) {
 
 // src/lib/setup/vscode.ts
 import { existsSync as existsSync8 } from "node:fs";
-import { join as join5 } from "node:path";
-var VSCODE_MCP_GLOBAL = join5(HOME, ".vscode", "mcp.json");
+import { join as join6 } from "node:path";
+var VSCODE_MCP_GLOBAL = join6(HOME, ".vscode", "mcp.json");
 function setupVscode(apiKey) {
   if (!existsSync8(VSCODE_DIR)) {
     console.error(fail("VS Code not found (~/.vscode/ does not exist)"));
@@ -4384,6 +4560,10 @@ function addSetupCommand(program2) {
     const platforms = installed.map((p) => p.name);
     runSetup(platforms, opts.profile);
   });
+  program2.command("setup-claude").description("Set up Claude Code (alias for 'setup claude')").option("--profile <name>", "API key profile to use", "default").action((opts) => {
+    console.error("");
+    runSetup(["claude"], opts.profile);
+  });
 }
 
 // src/commands/tasks/archive.ts
@@ -4871,9 +5051,9 @@ function registerTaskCommands() {
 init_config();
 import { execFileSync } from "node:child_process";
 import { createHash } from "node:crypto";
-import { chmodSync as chmodSync2, copyFileSync, createWriteStream, mkdirSync as mkdirSync4, readFileSync as readFileSync6, rmSync } from "node:fs";
+import { chmodSync as chmodSync2, copyFileSync, createWriteStream, mkdirSync as mkdirSync4, readFileSync as readFileSync7, rmSync } from "node:fs";
 import { tmpdir } from "node:os";
-import { join as join6 } from "node:path";
+import { join as join7 } from "node:path";
 import { Readable } from "node:stream";
 import { pipeline } from "node:stream/promises";
 import pc5 from "picocolors";
@@ -4940,9 +5120,9 @@ async function installBinaryUpdate(latest) {
   const { target, ext } = platformInfo;
   const binaryUrl = `https://github.com/${GITHUB_REPO}/releases/download/v${latest}/${target}.${ext}`;
   const checksumUrl = `https://github.com/${GITHUB_REPO}/releases/download/v${latest}/${target}.sha256`;
-  const tmp = join6(tmpdir(), `elnora-update-${Date.now()}`);
+  const tmp = join7(tmpdir(), `elnora-update-${Date.now()}`);
   mkdirSync4(tmp, { recursive: true });
-  const archivePath = join6(tmp, `${target}.${ext}`);
+  const archivePath = join7(tmp, `${target}.${ext}`);
   try {
     console.error("Downloading...");
     await downloadToFile(binaryUrl, archivePath);
@@ -4953,7 +5133,7 @@ async function installBinaryUpdate(latest) {
         const checksumText = await checksumRes.text();
         const expected = checksumText.split(/\s/)[0].trim();
         if (expected.length === 64) {
-          const actual = createHash("sha256").update(readFileSync6(archivePath)).digest("hex");
+          const actual = createHash("sha256").update(readFileSync7(archivePath)).digest("hex");
           if (actual.toLowerCase() !== expected.toLowerCase()) {
             console.error("Checksum verification failed. The download may be corrupted.");
             process.exitCode = 1;
@@ -4968,21 +5148,21 @@ async function installBinaryUpdate(latest) {
       console.error("Warning: Could not verify download checksum. Proceeding anyway.");
     }
     if (process.platform === "win32") {
-      const extractDir = join6(tmp, "extracted");
+      const extractDir = join7(tmp, "extracted");
       execFileSync("powershell", [
         "-NoProfile",
         "-Command",
         `Expand-Archive -Path '${archivePath}' -DestinationPath '${extractDir}' -Force`
       ]);
-      const installDir = join6(process.env.USERPROFILE ?? process.env.HOME ?? "", ".elnora", "bin");
+      const installDir = join7(process.env.USERPROFILE ?? process.env.HOME ?? "", ".elnora", "bin");
       mkdirSync4(installDir, { recursive: true });
-      copyFileSync(join6(extractDir, target), join6(installDir, "elnora.exe"));
+      copyFileSync(join7(extractDir, target), join7(installDir, "elnora.exe"));
     } else {
       execFileSync("tar", ["-xzf", archivePath, "-C", tmp]);
-      const installDir = process.env.ELNORA_INSTALL_DIR ?? join6(process.env.HOME ?? "", ".local", "bin");
+      const installDir = process.env.ELNORA_INSTALL_DIR ?? join7(process.env.HOME ?? "", ".local", "bin");
       mkdirSync4(installDir, { recursive: true });
-      const dest = join6(installDir, "elnora");
-      copyFileSync(join6(tmp, target), dest);
+      const dest = join7(installDir, "elnora");
+      copyFileSync(join7(tmp, target), dest);
       chmodSync2(dest, 493);
     }
     const done = color2 ? `${pc5.green("\u2713")} Updated to v${latest}` : `\u2713 Updated to v${latest}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elnora-ai/cli",
-  "version": "1.3.4",
+  "version": "1.4.0",
   "description": "Elnora AI Platform CLI",
   "type": "module",
   "bin": {
@@ -9,6 +9,7 @@
   "main": "dist/cli.js",
   "files": [
     "dist/",
+    "scripts/postinstall.mjs",
     "README.md",
     "LICENSE"
   ],
@@ -53,6 +54,7 @@
     "vitest": "^4.1.2"
   },
   "scripts": {
+    "postinstall": "node scripts/postinstall.mjs",
     "build": "node scripts/build-npm.mjs",
     "build:binary": "node scripts/build.mjs --pkg",
     "dev": "tsx src/cli.ts",

package/scripts/postinstall.mjs

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+
+/**
+ * npm postinstall — show setup instructions after `npm install -g @elnora-ai/cli`.
+ *
+ * Intentionally non-interactive: npm postinstall runs in contexts where stdin
+ * may not be available (CI, Docker, scripts). Interactive prompts belong in
+ * `elnora auth login` which the user runs manually after install.
+ */
+
+// Skip in CI or when output is suppressed
+if (process.env.CI || process.env.GITHUB_ACTIONS || !process.stderr.isTTY) {
+	process.exit(0);
+}
+
+const msg = `
+  ┌──────────────────────────────────────────────────────────────┐
+  │                                                              │
+  │   Elnora CLI installed successfully!                         │
+  │                                                              │
+  │   To get started, run:                                       │
+  │     elnora auth login                                        │
+  │                                                              │
+  │   Set up your AI coding tools:                                │
+  │     elnora setup                                             │
+  │                                                              │
+  │   Documentation:                                             │
+  │     https://github.com/Elnora-AI/elnora-cli                  │
+  │                                                              │
+  └──────────────────────────────────────────────────────────────┘
+`;
+
+console.error(msg);