@minhpnq1807/contextos 0.5.40 → 0.5.42

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 0.5.42
+
+- **Setup fallback when no skills found:** During `ctx setup`, if `syncSkills` completes but `detectExistingSkills` finds zero skills on the machine, the CLI now automatically offers the community skill library installer. After successful install, `syncSkills` re-runs to distribute the newly installed skills to all selected agents.
+- **Reusable `runCommunitySkillInstaller()`:** Extracted the fetch → select → install flow into a shared function used by both `ctx skills` and the `ctx setup` fallback. Returns the number of successfully installed sources for downstream branching.
+
+## 0.5.41
+
+- **Interactive community skill installer (`ctx skills`):** Replaced the info-only display with a fully functional multi-select installer. Users can now toggle multiple community library sources with `Space`, confirm with `Enter`, and the CLI automatically runs the appropriate install command for each selected source (`npx`, `git clone`, etc.).
+- **Compact selection UI with URL hints:** The skill source picker now shows a clean box-styled header and each option displays its GitHub URL as a dimmed sub-line hint, matching the `◇ / │` visual language used throughout contextOS.
+- **Prefixed install output (`runPrefixed`):** All child-process output during installation (including interactive npx prompts like "Ok to proceed?") is piped through a line-by-line prefixer that prepends `│  ` to every line. This keeps the visual box style consistent and prevents raw command output from breaking the layout. `stdin` remains inherited so users can still answer interactive prompts.
+- **`multiSelect` hint support:** The multi-select component now accepts an optional `hint` property on each option, rendered as a dimmed indented line below the label. Used for URLs but available for any contextual sub-text.
+- **Library install metadata:** `skill-library.js` now exports `getInstallCommands(libraryId)` returning structured install info (command, verify step, type) for each library source, keeping install logic out of the main CLI.
+
 ## 0.5.40
 
 - **Update notifier:** `ctx` now checks npm for newer versions in the background (once per day, 3s timeout). If a newer release exists, a boxed notice is printed at the very end of any command: `Update available: 0.5.39 → 0.5.40`. Check result is cached in `$CONTEXTOS_DATA/.update-check.json` to avoid repeated network calls.

package/bin/ctx.js

@@ -5,7 +5,7 @@ import path from "node:path";
 import readline from "node:readline/promises";
 import { stdin as input, stdout as output } from "node:process";
 import { fileURLToPath } from "node:url";
-import { execFileSync } from "node:child_process";
+import { execFileSync, execSync, spawn } from "node:child_process";
 
 import { readAgentsChain } from "../plugins/ctx/lib/reader.js";
 import { filterActionableRules, parseRules, scoreRules } from "../plugins/ctx/lib/analyzer.js";
@@ -28,14 +28,153 @@ import { installCopilotHooks } from "../plugins/ctx/lib/copilot-hooks.js";
 import { installCopilotMcp } from "../plugins/ctx/lib/copilot-mcp.js";
 import { syncRules } from "../plugins/ctx/lib/ruler-sync.js";
 import { writeInnerGitignore, ensureRootGitignore } from "../plugins/ctx/lib/gitignore.js";
-import { syncSkills } from "../plugins/ctx/lib/skillshare-sync.js";
+import { syncSkills, detectExistingSkills } from "../plugins/ctx/lib/skillshare-sync.js";
 import { scanSkills, warmSkillEmbeddings } from "../plugins/ctx/lib/skill-discoverer.js";
 import { parsePassthroughArgs, runPassthrough } from "../plugins/ctx/lib/passthrough.js";
 import { parseAgentList, parseSetupArgs, setupSummaryLines } from "../plugins/ctx/lib/setup-wizard.js";
 import { multiSelect } from "../plugins/ctx/lib/multi-select.js";
 import { syncWorkflows, warmWorkflowEmbeddings } from "../plugins/ctx/lib/workflow-discoverer.js";
 import { checkForUpdate } from "../plugins/ctx/lib/update-notifier.js";
-import { fetchSkillsForAgents, printSkillRecommendations, getAllLibraries } from "../plugins/ctx/lib/skill-library.js";
+import { fetchSkillsForAgents, printSkillRecommendations, getAllLibraries, getInstallCommands } from "../plugins/ctx/lib/skill-library.js";
+
+/**
+ * Run a shell command with all output lines prefixed by │  
+ * Keeps the visual box style consistent during child-process output.
+ * stdin is inherited so interactive prompts (e.g. npx "Ok to proceed?") still work.
+ */
+function runPrefixed(cmd) {
+  const DIM = "\x1B[2m";
+  const RST = "\x1B[0m";
+  const pfx = `${DIM}│${RST}  `;
+  return new Promise((resolve, reject) => {
+    const child = spawn("sh", ["-c", cmd], { stdio: ["inherit", "pipe", "pipe"] });
+    function pipe(stream, target) {
+      let needPrefix = true;
+      stream.on("data", (buf) => {
+        const str = buf.toString();
+        let out = "";
+        for (const ch of str) {
+          if (needPrefix) { out += pfx; needPrefix = false; }
+          out += ch;
+          if (ch === "\n") needPrefix = true;
+        }
+        target.write(out);
+      });
+    }
+    pipe(child.stdout, process.stdout);
+    pipe(child.stderr, process.stderr);
+    child.on("close", (code) => code === 0 ? resolve() : reject(new Error(`exit code ${code}`)));
+  });
+}
+
+/**
+ * Interactive community skill library installer.
+ * Fetches library metadata, shows a multiSelect, and runs install commands.
+ * @param {string[]} agents - Agent names to filter libraries for.
+ * @returns {Promise<number>} Number of successfully installed sources.
+ */
+async function runCommunitySkillInstaller(agents = []) {
+  const RESET = "\x1B[0m";
+  const DIM = "\x1B[2m";
+  const CYAN = "\x1B[36m";
+  const GREEN = "\x1B[32m";
+  const YELLOW = "\x1B[33m";
+  const BOLD = "\x1B[1m";
+
+  console.log("Fetching community skill libraries...\n");
+  const libraryResults = await fetchSkillsForAgents(agents, { dataDir: contextOSDataDir() });
+
+  const totalSkills = libraryResults.reduce((sum, r) => sum + r.count, 0);
+  if (totalSkills === 0) {
+    console.log("No skills found. Check your network connection or try --refresh.");
+    return 0;
+  }
+
+  // Compact header
+  console.log(`${CYAN}◇${RESET} ${BOLD}Community skill libraries available:${RESET}`);
+  console.log(`${DIM}│${RESET}  Browse and install curated skills from the community.`);
+  console.log(`${DIM}│${RESET}`);
+
+  const allLibs = getAllLibraries();
+  const availableLibs = allLibs.filter((lib) => {
+    const result = libraryResults.find((r) => r.library.id === lib.id);
+    return result && result.count > 0;
+  });
+
+  if (availableLibs.length === 0) {
+    console.log("No installable libraries available.");
+    return 0;
+  }
+
+  const selectedSources = await multiSelect({
+    message: "Select skill sources to install:",
+    options: availableLibs.map((lib) => {
+      const result = libraryResults.find((r) => r.library.id === lib.id);
+      return {
+        label: `${lib.name} (${result?.count || 0} skills)`,
+        value: lib.id,
+        hint: lib.url,
+        selected: false
+      };
+    })
+  });
+
+  if (!selectedSources || selectedSources.length === 0) {
+    console.log(`\n${DIM}No sources selected.${RESET}`);
+    return 0;
+  }
+
+  // Install each selected source
+  let successCount = 0;
+  for (const libId of selectedSources) {
+    const lib = allLibs.find((l) => l.id === libId);
+    if (!lib) continue;
+
+    const installInfo = getInstallCommands(libId);
+    if (!installInfo) {
+      console.log(`${YELLOW}⚠${RESET}  No install info for ${lib.name}. Visit: ${lib.url}`);
+      continue;
+    }
+
+    console.log("");
+    console.log(`${CYAN}◇${RESET} ${BOLD}Installing from ${lib.name}${RESET}`);
+
+    if (installInfo.type === "manual") {
+      console.log(`${DIM}│${RESET}  ${installInfo.instructions}`);
+      console.log(`${DIM}│${RESET}  ${DIM}URL: ${lib.url}${RESET}`);
+      continue;
+    }
+
+    const installCmd = installInfo.fullInstall;
+    if (installCmd) {
+      console.log(`${DIM}│${RESET}  ${GREEN}$ ${installCmd}${RESET}`);
+      console.log(`${DIM}│${RESET}`);
+
+      try {
+        await runPrefixed(installCmd);
+        successCount++;
+
+        if (installInfo.verify) {
+          try { await runPrefixed(installInfo.verify); } catch { /* best-effort */ }
+        }
+        console.log(`${DIM}│${RESET}`);
+        console.log(`${GREEN}✔${RESET} ${lib.name} installed successfully.`);
+      } catch (err) {
+        console.error(`${YELLOW}⚠${RESET}  Install failed for ${lib.name}. Try manually:`);
+        console.error(`   ${installCmd}`);
+        console.error(`   ${DIM}${err.message}${RESET}`);
+      }
+    }
+  }
+
+  // Summary
+  console.log("");
+  if (successCount > 0) {
+    console.log(`${GREEN}✔${RESET} ${BOLD}${successCount} source${successCount > 1 ? "s" : ""} installed.${RESET}`);
+    console.log(`${DIM}│${RESET}  Restart your agent to pick up new skills.`);
+  }
+  return successCount;
+}
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const rootDir = path.resolve(__dirname, "..");
@@ -596,7 +735,8 @@ async function setup({ args = [], cwd = process.cwd() } = {}) {
     const skillAgents = options.agents.map((agent) => agent === "agy" ? "antigravity" : agent).join(",");
     const syncArgs = ["--skills", "--agents", skillAgents];
     if (options.yes) syncArgs.push("--yes");
-    await streamSetupOutput(() => syncSkills({
+
+    const doSyncSkills = async () => streamSetupOutput(() => syncSkills({
       cwd,
       args: syncArgs,
       rebuildSkillEmbeddings: async ({ cwd: skillCwd, sourceDir }) => warmSkillEmbeddings({
@@ -606,6 +746,25 @@ async function setup({ args = [], cwd = process.cwd() } = {}) {
         skills: scanSkills({ cwd: skillCwd, roots: [sourceDir] })
       })
     }));
+
+    await doSyncSkills();
+
+    // Fallback: if no skills were found, offer community library installer
+    const existing = detectExistingSkills({ cwd });
+    const totalExisting = existing.reduce((sum, e) => sum + e.count, 0);
+    if (totalExisting === 0) {
+      console.log("");
+      console.log(`${YELLOW}⚠${RESET}  No skills found on this machine.`);
+      console.log(`${DIM}│${RESET}  Install community skills to get started.`);
+      console.log("");
+
+      const installed = await runCommunitySkillInstaller(options.agents);
+      if (installed > 0) {
+        console.log("");
+        console.log("◇ Re-syncing skills after install...");
+        await doSyncSkills();
+      }
+    }
   }
 
   console.log("");
@@ -613,12 +772,6 @@ async function setup({ args = [], cwd = process.cwd() } = {}) {
   console.log("│  Next: restart/open your agent from this project directory.");
   console.log("│  Try: ctx debug -- \"Recheck authen flow\"");
   console.log("");
-
-  // Recommend community skills based on selected agents
-  try {
-    const libraryResults = await fetchSkillsForAgents(options.agents, { dataDir: contextOSDataDir() });
-    printSkillRecommendations(libraryResults);
-  } catch { /* skill library is best-effort */ }
 }
 
 const args = process.argv.slice(2);
@@ -701,7 +854,7 @@ try {
     if (!task.trim()) throw new Error('Usage: ctx benchmark -- "task"');
     console.log(formatBenchmark(benchmarkWorkspace({ cwd: process.cwd(), task })));
   } else if (command === "skills") {
-    // Browse community skill libraries
+    // Interactive community skill library selector + installer
     const agentsFlag = args.indexOf("--agents");
     const forceRefresh = args.includes("--refresh");
     let agents;
@@ -710,21 +863,19 @@ try {
     } else {
       agents = ["codex", "claude", "agy", "copilot"];
     }
-    console.log("Fetching community skill libraries...\n");
-    const libraryResults = await fetchSkillsForAgents(agents, {
-      dataDir: contextOSDataDir()
-    });
-    printSkillRecommendations(libraryResults);
-    console.log("");
-    const totalSkills = libraryResults.reduce((sum, r) => sum + r.count, 0);
-    if (totalSkills === 0) {
-      console.log("No skills found. Check your network connection or try --refresh.");
-    } else {
-      console.log(`Total: ${totalSkills} skills across ${libraryResults.filter((r) => r.count > 0).length} libraries.`);
-      console.log("");
-      console.log("To install skills, visit the library URLs above or use:");
-      console.log("  ctx sync --skills       Sync skills across agents via skillshare");
+
+    const DIM = "\x1B[2m";
+    const RESET = "\x1B[0m";
+    const CYAN = "\x1B[36m";
+    const GREEN = "\x1B[32m";
+    const YELLOW = "\x1B[33m";
+    const BOLD = "\x1B[1m";
+
+    const installed = await runCommunitySkillInstaller(agents);
+    if (installed === 0) {
+      console.log(`\n${DIM}No installations were completed.${RESET}`);
     }
+    console.log("");
   } else if (command === "sync") {
     if (args.includes("--workflows")) {
       await syncWorkflows({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@minhpnq1807/contextos",
-  "version": "0.5.40",
+  "version": "0.5.42",
   "description": "Task-aware AGENTS.md context injection and compliance reporting for Codex, Claude Code, and Antigravity.",
   "type": "module",
   "bin": {

package/plugins/ctx/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "ctx",
-  "version": "0.5.37",
+  "version": "0.5.41",
   "description": "Inject task-relevant AGENTS.md rules into Codex through plugin hooks.",
   "author": {
     "name": "ContextOS"

package/plugins/ctx/lib/multi-select.js

@@ -62,6 +62,9 @@ export function multiSelect({ message, options }) {
         const label = isCursor ? `${BOLD}${CYAN}${options[i].label}${RESET}` : options[i].label;
         const pointer = isCursor ? `${CYAN}❯${RESET}` : " ";
         lines.push(`  ${pointer} ${checkbox} ${label}`);
+        if (options[i].hint) {
+          lines.push(`        ${DIM}${options[i].hint}${RESET}`);
+        }
       }
       return lines;
     }
@@ -140,3 +143,113 @@ export function multiSelect({ message, options }) {
     draw();
   });
 }
+
+/**
+ * Interactive single-select prompt (radio-button style).
+ *
+ * @param {{ message: string, options: Array<{label: string, value: string, disabled?: boolean, isHeader?: boolean}> }} config
+ * @returns {Promise<string|null>} selected value or null
+ */
+export function singleSelect({ message, options }) {
+  return new Promise((resolve) => {
+    if (!process.stdin.isTTY) {
+      // Non-interactive: return first non-disabled
+      const first = options.find((o) => !o.disabled);
+      resolve(first ? first.value : null);
+      return;
+    }
+
+    // Filter to only selectable items, but keep the full list for rendering
+    const selectableIndices = options
+      .map((o, i) => (o.disabled ? -1 : i))
+      .filter((i) => i >= 0);
+    if (selectableIndices.length === 0) { resolve(null); return; }
+
+    let cursorIdx = 0; // index into selectableIndices
+    let cursor = selectableIndices[0]; // actual index in options
+
+    function render() {
+      const lines = [];
+      lines.push(`${CYAN}◇${RESET} ${message}`);
+      lines.push(`${DIM}  Use ↑/↓ to navigate, Enter to select${RESET}`);
+      for (let i = 0; i < options.length; i++) {
+        const opt = options[i];
+        if (opt.disabled || opt.isHeader) {
+          lines.push(`  ${DIM}${opt.label}${RESET}`);
+          continue;
+        }
+        const isCursor = i === cursor;
+        const radio = isCursor ? `${GREEN}◉${RESET}` : `${DIM}○${RESET}`;
+        const label = isCursor ? `${BOLD}${CYAN}${opt.label}${RESET}` : opt.label;
+        const pointer = isCursor ? `${CYAN}❯${RESET}` : " ";
+        lines.push(`  ${pointer} ${radio} ${label}`);
+      }
+      return lines;
+    }
+
+    let prevLineCount = 0;
+
+    function draw() {
+      const lines = render();
+      if (prevLineCount > 0) {
+        process.stdout.write(`\x1B[${prevLineCount}A`);
+        for (let i = 0; i < prevLineCount; i++) {
+          process.stdout.write("\x1B[2K");
+          if (i < prevLineCount - 1) process.stdout.write("\x1B[1B");
+        }
+        process.stdout.write(`\x1B[${prevLineCount - 1}A`);
+      }
+      process.stdout.write(lines.join("\n") + "\n");
+      prevLineCount = lines.length;
+    }
+
+    process.stdout.write(HIDE_CURSOR);
+
+    const wasRaw = process.stdin.isRaw;
+    process.stdin.setRawMode(true);
+    process.stdin.resume();
+    process.stdin.setEncoding("utf8");
+
+    function cleanup() {
+      process.stdin.setRawMode(wasRaw || false);
+      process.stdin.pause();
+      process.stdin.removeListener("data", onData);
+      process.stdout.write(SHOW_CURSOR);
+    }
+
+    function onData(data) {
+      if (matchKey(data, KEYS.CTRL_C)) {
+        cleanup();
+        process.exit(0);
+      }
+
+      if (matchKey(data, KEYS.UP) || matchKey(data, KEYS.K)) {
+        cursorIdx = (cursorIdx - 1 + selectableIndices.length) % selectableIndices.length;
+        cursor = selectableIndices[cursorIdx];
+        draw();
+      } else if (matchKey(data, KEYS.DOWN) || matchKey(data, KEYS.J)) {
+        cursorIdx = (cursorIdx + 1) % selectableIndices.length;
+        cursor = selectableIndices[cursorIdx];
+        draw();
+      } else if (matchKey(data, KEYS.ENTER)) {
+        cleanup();
+        const selected = options[cursor];
+        // Clear and show result
+        if (prevLineCount > 0) {
+          process.stdout.write(`\x1B[${prevLineCount}A`);
+          for (let i = 0; i < prevLineCount; i++) {
+            process.stdout.write("\x1B[2K");
+            if (i < prevLineCount - 1) process.stdout.write("\x1B[1B");
+          }
+          process.stdout.write(`\x1B[${prevLineCount - 1}A`);
+        }
+        process.stdout.write(`${CYAN}◇${RESET} ${message}\n`);
+        process.stdout.write(`${DIM}│${RESET}  ${GREEN}${selected.label}${RESET}\n`);
+        resolve(selected.value);
+      }
+    }
+
+    process.stdin.on("data", onData);
+    draw();
+  });
+}

package/plugins/ctx/lib/skill-library.js

@@ -19,25 +19,64 @@ const SKILL_LIBRARIES = [
     url: "https://github.com/sickn33/antigravity-awesome-skills",
     rawReadmeUrl: "https://raw.githubusercontent.com/sickn33/antigravity-awesome-skills/main/README.md",
     agents: ["agy", "claude", "codex", "copilot"],   // universal library
-    description: "1,400+ agentic skills for all agents"
+    description: "1,400+ agentic skills for all agents",
+    install: {
+      type: "npx",
+      fullInstall: "npx antigravity-awesome-skills",
+      agentFlags: {
+        codex: "npx antigravity-awesome-skills --codex",
+        claude: "npx antigravity-awesome-skills --claude",
+        agy: "npx antigravity-awesome-skills --antigravity",
+        copilot: "npx antigravity-awesome-skills --cursor",
+        gemini: "npx antigravity-awesome-skills --gemini"
+      },
+      verify: 'test -d ~/.agents/skills && echo "Skills installed in ~/.agents/skills"'
+    }
   },
   {
     id: "awesome-claude",
     name: "Awesome Claude Skills",
     repo: "ComposioHQ/awesome-claude-skills",
     url: "https://github.com/ComposioHQ/awesome-claude-skills",
-    rawReadmeUrl: "https://raw.githubusercontent.com/ComposioHQ/awesome-claude-skills/main/README.md",
+    rawReadmeUrl: "https://raw.githubusercontent.com/ComposioHQ/awesome-claude-skills/master/README.md",
     agents: ["claude"],
-    description: "Curated Claude Code skills & workflows"
+    description: "Curated Claude Code skills & workflows",
+    install: {
+      type: "git-clone",
+      clone: "git clone https://github.com/ComposioHQ/awesome-claude-skills.git",
+      skillDir: "~/.claude/skills",
+      copyCommand: (skillName) =>
+        `cp -r awesome-claude-skills/${skillName} ~/.claude/skills/${skillName}`,
+      fullInstall: [
+        "git clone https://github.com/ComposioHQ/awesome-claude-skills.git",
+        "mkdir -p ~/.claude/skills",
+        'for d in awesome-claude-skills/*/; do [ -f "$d/SKILL.md" ] && cp -r "$d" ~/.claude/skills/; done'
+      ].join(" && "),
+      verify: 'ls ~/.claude/skills/'
+    }
   },
   {
     id: "awesome-codex",
     name: "Awesome Codex Skills",
     repo: "ComposioHQ/awesome-codex-skills",
     url: "https://github.com/ComposioHQ/awesome-codex-skills",
-    rawReadmeUrl: "https://raw.githubusercontent.com/ComposioHQ/awesome-codex-skills/main/README.md",
+    rawReadmeUrl: "https://raw.githubusercontent.com/ComposioHQ/awesome-codex-skills/master/README.md",
     agents: ["codex"],
-    description: "Practical Codex CLI skills & automations"
+    description: "Practical Codex CLI skills & automations",
+    install: {
+      type: "git-clone-python",
+      clone: "git clone https://github.com/ComposioHQ/awesome-codex-skills.git",
+      skillDir: "~/.codex/skills",
+      installScript: (skillName) =>
+        `python awesome-codex-skills/skill-installer/scripts/install-skill-from-github.py --repo ComposioHQ/awesome-codex-skills --path ${skillName}`,
+      fullInstall: [
+        "git clone https://github.com/ComposioHQ/awesome-codex-skills.git",
+        "cd awesome-codex-skills",
+        "mkdir -p ~/.codex/skills",
+        'for d in */; do [ -f "$d/SKILL.md" ] && [ "$d" != "skill-installer/" ] && cp -r "$d" ~/.codex/skills/; done'
+      ].join(" && "),
+      verify: 'ls ~/.codex/skills/'
+    }
   },
   {
     id: "awesome-copilot",
@@ -46,7 +85,13 @@ const SKILL_LIBRARIES = [
     url: "https://github.com/github/awesome-copilot",
     rawReadmeUrl: "https://raw.githubusercontent.com/github/awesome-copilot/main/README.md",
     agents: ["copilot"],
-    description: "Community GitHub Copilot instructions & agents"
+    description: "Community GitHub Copilot instructions & agents",
+    install: {
+      type: "manual",
+      fullInstall: null,
+      instructions: "Browse the repository and copy relevant .instructions.md files to your .github/ directory.",
+      url: "https://github.com/github/awesome-copilot"
+    }
   }
 ];
 
@@ -288,3 +333,32 @@ export function printSkillRecommendations(libraryResults, { logger = console.log
 export function getAllLibraries() {
   return SKILL_LIBRARIES;
 }
+
+/**
+ * Get install commands for a specific library.
+ * @param {string} libraryId
+ * @param {string} [agent] - optional agent to target
+ * @returns {{ fullInstall: string|null, agentInstall: string|null, verify: string|null, instructions: string|null, type: string }}
+ */
+export function getInstallCommands(libraryId, agent) {
+  const lib = SKILL_LIBRARIES.find((l) => l.id === libraryId);
+  if (!lib || !lib.install) return null;
+
+  const inst = lib.install;
+  const result = {
+    type: inst.type,
+    fullInstall: typeof inst.fullInstall === "string" ? inst.fullInstall : null,
+    agentInstall: null,
+    verify: inst.verify || null,
+    instructions: inst.instructions || null,
+    url: inst.url || lib.url
+  };
+
+  // Agent-specific install (only for npx-based libs)
+  if (agent && inst.agentFlags) {
+    const normalized = agent.toLowerCase().replace("antigravity", "agy");
+    result.agentInstall = inst.agentFlags[normalized] || null;
+  }
+
+  return result;
+}