contextos-agents 1.6.0 → 1.6.1

package/.agents/core/profiles/mvp.yaml

@@ -25,6 +25,7 @@ prefer_skills:
 exclude_skills:
   - ddd
   - microservices
+  - system-design
   - kubernetes
   - monitoring
   - cicd

package/.agents/ctx.js

@@ -46,6 +46,10 @@ function printHelp() {
   console.log('  audit                           Alias for validate (check skills)');
   console.log('  validate                        Validate skill sources, frontmatter, deps & sync');
   console.log('  clean-worktrees                 Clean up lingering .swarm-worktrees and swarm/* branches');
+  console.log('  doctor                          Run project diagnostic health check');
+  console.log('  stats                           Display token context savings report');
+  console.log('  watch                           Start continuous file watcher and auto-sync daemon');
+  console.log('  init                            Show initialization guide');
   console.log('  install-skill <ref>             Alias for skill add (install a plugin)');
   console.log('  skill add   <ref>               Install a plugin skill (GitHub or npm)');
   console.log('  skill remove <name>             Uninstall a plugin skill');
@@ -363,6 +367,33 @@ if (command === 'export') {
 
   console.log(`✓ Cleaned up ${dirCount} worktree directory(ies) and ${branchCount} swarm branch(es).`);
 
+// ── doctor ────────────────────────────────────────────────────────────────────
+} else if (command === 'doctor') {
+  const doctorModule = require('./doctor.js');
+  doctorModule.runDoctor(process.cwd());
+
+// ── stats ─────────────────────────────────────────────────────────────────────
+} else if (command === 'stats') {
+  const statsModule = require('./stats.js');
+  statsModule.runStats(process.cwd());
+
+// ── watch ─────────────────────────────────────────────────────────────────────
+} else if (command === 'watch') {
+  const watchModule = require('./watch.js');
+  watchModule.runWatch(process.cwd());
+
+// ── init ──────────────────────────────────────────────────────────────────────
+} else if (command === 'init') {
+  console.log('\nContextOS — Project Initialization Guide\n');
+  console.log('To set up ContextOS in your project:');
+  console.log('  npx contextos                    Install .agents/ with auto-detected profile');
+  console.log('  npx contextos --minimal          Install with minimal core skills');
+  console.log('  npx contextos --profile <name>   Install with specific profile (mvp, startup, enterprise, etc.)');
+  console.log('  npx contextos --with-mcp         Install with MCP execution server enabled');
+  console.log('\nAfter setup, verify your installation:');
+  console.log('  node .agents/ctx.js doctor');
+  console.log('  node .agents/ctx.js stats\n');
+
 // ── unknown ───────────────────────────────────────────────────────────────────
 } else {
   console.error(`Unknown command: ${command}`);

package/.agents/mcp/server.mjs

@@ -41570,121 +41570,6 @@ var require_browser = __commonJS({
   }
 });
 
-// ../node_modules/has-flag/index.js
-var require_has_flag = __commonJS({
-  "../node_modules/has-flag/index.js"(exports, module) {
-    "use strict";
-    module.exports = (flag, argv = process.argv) => {
-      const prefix = flag.startsWith("-") ? "" : flag.length === 1 ? "-" : "--";
-      const position = argv.indexOf(prefix + flag);
-      const terminatorPosition = argv.indexOf("--");
-      return position !== -1 && (terminatorPosition === -1 || position < terminatorPosition);
-    };
-  }
-});
-
-// ../node_modules/supports-color/index.js
-var require_supports_color = __commonJS({
-  "../node_modules/supports-color/index.js"(exports, module) {
-    "use strict";
-    var os7 = __require("os");
-    var tty = __require("tty");
-    var hasFlag = require_has_flag();
-    var { env } = process;
-    var forceColor;
-    if (hasFlag("no-color") || hasFlag("no-colors") || hasFlag("color=false") || hasFlag("color=never")) {
-      forceColor = 0;
-    } else if (hasFlag("color") || hasFlag("colors") || hasFlag("color=true") || hasFlag("color=always")) {
-      forceColor = 1;
-    }
-    if ("FORCE_COLOR" in env) {
-      if (env.FORCE_COLOR === "true") {
-        forceColor = 1;
-      } else if (env.FORCE_COLOR === "false") {
-        forceColor = 0;
-      } else {
-        forceColor = env.FORCE_COLOR.length === 0 ? 1 : Math.min(parseInt(env.FORCE_COLOR, 10), 3);
-      }
-    }
-    function translateLevel(level) {
-      if (level === 0) {
-        return false;
-      }
-      return {
-        level,
-        hasBasic: true,
-        has256: level >= 2,
-        has16m: level >= 3
-      };
-    }
-    function supportsColor(haveStream, streamIsTTY) {
-      if (forceColor === 0) {
-        return 0;
-      }
-      if (hasFlag("color=16m") || hasFlag("color=full") || hasFlag("color=truecolor")) {
-        return 3;
-      }
-      if (hasFlag("color=256")) {
-        return 2;
-      }
-      if (haveStream && !streamIsTTY && forceColor === void 0) {
-        return 0;
-      }
-      const min = forceColor || 0;
-      if (env.TERM === "dumb") {
-        return min;
-      }
-      if (process.platform === "win32") {
-        const osRelease = os7.release().split(".");
-        if (Number(osRelease[0]) >= 10 && Number(osRelease[2]) >= 10586) {
-          return Number(osRelease[2]) >= 14931 ? 3 : 2;
-        }
-        return 1;
-      }
-      if ("CI" in env) {
-        if (["TRAVIS", "CIRCLECI", "APPVEYOR", "GITLAB_CI", "GITHUB_ACTIONS", "BUILDKITE"].some((sign) => sign in env) || env.CI_NAME === "codeship") {
-          return 1;
-        }
-        return min;
-      }
-      if ("TEAMCITY_VERSION" in env) {
-        return /^(9\.(0*[1-9]\d*)\.|\d{2,}\.)/.test(env.TEAMCITY_VERSION) ? 1 : 0;
-      }
-      if (env.COLORTERM === "truecolor") {
-        return 3;
-      }
-      if ("TERM_PROGRAM" in env) {
-        const version2 = parseInt((env.TERM_PROGRAM_VERSION || "").split(".")[0], 10);
-        switch (env.TERM_PROGRAM) {
-          case "iTerm.app":
-            return version2 >= 3 ? 3 : 2;
-          case "Apple_Terminal":
-            return 2;
-        }
-      }
-      if (/-256(color)?$/i.test(env.TERM)) {
-        return 2;
-      }
-      if (/^screen|^xterm|^vt100|^vt220|^rxvt|color|ansi|cygwin|linux/i.test(env.TERM)) {
-        return 1;
-      }
-      if ("COLORTERM" in env) {
-        return 1;
-      }
-      return min;
-    }
-    function getSupportLevel(stream2) {
-      const level = supportsColor(stream2, stream2 && stream2.isTTY);
-      return translateLevel(level);
-    }
-    module.exports = {
-      supportsColor: getSupportLevel,
-      stdout: translateLevel(supportsColor(true, tty.isatty(1))),
-      stderr: translateLevel(supportsColor(true, tty.isatty(2)))
-    };
-  }
-});
-
 // node_modules/debug/src/node.js
 var require_node = __commonJS({
   "node_modules/debug/src/node.js"(exports, module) {
@@ -41703,7 +41588,7 @@ var require_node = __commonJS({
     );
     exports.colors = [6, 2, 3, 4, 5, 1];
     try {
-      const supportsColor = require_supports_color();
+      const supportsColor = __require("supports-color");
       if (supportsColor && (supportsColor.stderr || supportsColor).level >= 2) {
         exports.colors = [
           20,

package/.agents/validate.js

@@ -414,6 +414,58 @@ function checkValidationJson(sourceSkills) {
   info(`[validation] ${pass} VALIDATION.json files are valid`);
 }
 
+// ═════════════════════════════════════════════════════════════════════════════
+//  CHECK 9 — MCP Bundle Synchronization
+// ═════════════════════════════════════════════════════════════════════════════
+function checkMcpBundleSync() {
+  const mcpSrcDir = path.join(ROOT, 'contextos-mcp', 'src');
+  const bundlePath = path.join(AGENTS_DIR, 'mcp', 'server.mjs');
+
+  if (!fs.existsSync(mcpSrcDir)) {
+    return;
+  }
+
+  if (!fs.existsSync(bundlePath)) {
+    warn(`[mcp-sync] Missing compiled MCP server bundle at .agents/mcp/server.mjs. Run: cd contextos-mcp && npm run build:bundle`);
+    return;
+  }
+
+  const bundleStat = fs.statSync(bundlePath);
+  const bundleMtime = bundleStat.mtimeMs;
+
+  let newestSrcFile = null;
+  let newestSrcMtime = 0;
+
+  function walk(dir) {
+    let entries;
+    try {
+      entries = fs.readdirSync(dir, { withFileTypes: true });
+    } catch {
+      return;
+    }
+    for (const entry of entries) {
+      const full = path.join(dir, entry.name);
+      if (entry.isDirectory()) {
+        walk(full);
+      } else if (entry.isFile()) {
+        const stat = fs.statSync(full);
+        if (stat.mtimeMs > newestSrcMtime) {
+          newestSrcMtime = stat.mtimeMs;
+          newestSrcFile = path.relative(ROOT, full);
+        }
+      }
+    }
+  }
+
+  walk(mcpSrcDir);
+
+  if (newestSrcMtime > bundleMtime) {
+    warn(`[mcp-sync] Compiled MCP bundle (.agents/mcp/server.mjs) is older than source file ${newestSrcFile}. Run: cd contextos-mcp && npm run build:bundle`);
+  } else {
+    info(`[mcp-sync] Compiled MCP bundle (.agents/mcp/server.mjs) is up to date with contextos-mcp/src/`);
+  }
+}
+
 // ═════════════════════════════════════════════════════════════════════════════
 //  REPORT
 // ═════════════════════════════════════════════════════════════════════════════
@@ -487,6 +539,7 @@ function run() {
   checkContentQuality(sourceSkills);
   checkCostarHeaders(sourceSkills);
   checkValidationJson(sourceSkills);
+  checkMcpBundleSync();
 
   const passed = printReport();
   process.exit(passed ? 0 : 1);

package/README.md

@@ -12,7 +12,8 @@ This is an open-source set of skills and behavioral rules for AI assistants. The
 You do not need to clone anything manually. Just open your terminal in the root of your project and run:
 
 ```bash
-npx contextos-agents
+npx contextos
+# or: npx contextos-agents
 ```
 
 The script will automatically detect your project tech stack, create the `.agents` folder, configure skills, and compile them for your AI agent.
@@ -20,15 +21,16 @@ The script will automatically detect your project tech stack, create the `.agent
 ### Options
 
 ```bash
-npx contextos-agents --help          # Show all options
-npx contextos-agents --version       # Show version
-npx contextos-agents --profile mvp   # Install with specific profile (mvp, startup, enterprise, frontend, backend)
-npx contextos-agents --auto          # Auto-detect tech stack and apply recommended profile
-npx contextos-agents --with-mcp      # Install with MCP execution server enabled (.agents/mcp/)
-npx contextos-agents setup-mcp       # Add MCP server to an existing .agents/ project
-npx contextos-agents --dry-run       # Preview what will be installed
-npx contextos-agents --force         # Overwrite an existing .agents/ folder
-npx contextos-agents --skip-compile  # Skip auto-compilation step
+npx contextos --help             # Show all options
+npx contextos --version          # Show version
+npx contextos --minimal          # Install only 5 core skills (lightweight footprint)
+npx contextos --profile mvp      # Install with specific profile (mvp, startup, enterprise, frontend, backend)
+npx contextos --auto             # Auto-detect tech stack and apply recommended profile
+npx contextos --with-mcp         # Install with MCP execution server enabled (.agents/mcp/)
+npx contextos setup-mcp          # Add MCP server to an existing .agents/ project
+npx contextos --dry-run          # Preview what will be installed
+npx contextos --force            # Overwrite an existing .agents/ folder
+npx contextos --skip-compile     # Skip auto-compilation step
 ```
 
 ## Why ContextOS?
@@ -70,16 +72,17 @@ ContextOS allows you to tailor your AI rules to the project lifecycle and archit
 
 ```bash
 # Auto-detect tech stack in the current project
-node .agents/ctx.js detect
+contextos detect
+# or: node .agents/ctx.js detect
 
 # List available profiles and current active profile
-node .agents/ctx.js profile list
+contextos profile list
 
 # Apply a profile
-node .agents/ctx.js profile apply mvp
+contextos profile apply mvp
 
 # Recompile all agent exports for the active profile
-node .agents/ctx.js export all
+contextos export all
 ```
 
 ## What's Inside?
@@ -146,9 +149,9 @@ ContextOS maps development phases directly to slash commands in your AI chat:
 | `/review` | Staff Engineer + Designer | 5-axis quality gate (correctness, architecture, security, performance, design) |
 | `/ship` | Release Engineer | Verify clean CI, lint checks, docs, and rollback plan before merging |
 
-## Dynamic Skill Resolution & CLI (`ctx.js`)
+## Dynamic Skill Resolution & Unified CLI (`contextos` / `ctx.js`)
 
-The `.agents/ctx.js` file is the **Context Engine** — it resolves minimal skills on the fly and compiles exports for AI assistants.
+ContextOS provides a unified CLI (`contextos` or `npx contextos`) and local engine (`.agents/ctx.js`) to resolve minimal skills on the fly, run health diagnostics, and compile exports for AI assistants.
 
 ### Dynamic Skill Resolution (`resolve` & `index`)
 
@@ -156,48 +159,74 @@ To prevent context bloat, ContextOS dynamically resolves the exact 2–4 skills
 
 ```bash
 # Resolve skills for a task description (English):
-node .agents/ctx.js resolve "Build an accessible modal component with React and Tailwind"
+contextos resolve "Build an accessible modal component with React and Tailwind"
 
 # Output:
 # [DOMAIN: Frontend] [PHASE: Build] [ROLE: Senior Developer]
 # Skills loaded: ponytail-mindset, engineering-workflow, react, ui-ux-pro, web-accessibility
 
 # Multilingual support (Russian):
-node .agents/ctx.js resolve "создай модальное окно авторизации и напиши юнит-тесты"
+contextos resolve "создай модальное окно авторизации и напиши юнит-тесты"
 
 # Output:
 # [DOMAIN: Frontend] [PHASE: Build] [ROLE: Senior Developer]
 # Skills loaded: ponytail-mindset, engineering-workflow, react, ui-ux-pro, security, testing
 
-# Resolve skills based on active files:
-node .agents/ctx.js resolve --files "app/api/auth/route.ts"
+# Resolve skills based on active files (hybrid AST & config analysis):
+contextos resolve --files "app/api/auth/route.ts"
 
 # Generate/update progressive lightweight skills index:
-node .agents/ctx.js index
+contextos index
 
 # Clean up lingering .swarm-worktrees directories and orphaned swarm/* git branches:
-node .agents/ctx.js clean-worktrees
+contextos clean-worktrees
+```
+
+### Diagnostic Health Check (`contextos doctor`)
+
+Run a comprehensive pre-flight verification across your repository to ensure valid skills, profile alignment, symlinks, git worktree status, and compiler synchronization:
+
+```bash
+contextos doctor
+# or: npx contextos doctor
+```
+
+### Context Savings Analytics (`contextos stats`)
+
+Measure your real token savings. Compares monolithic prompt injection against ContextOS dynamic skill resolution across frontend, backend, security, and full-stack tasks:
+
+```bash
+contextos stats
+```
+
+### Continuous Auto-Sync Daemon (`contextos watch`)
+
+Watch your source skills in `.agents/core/skills/` and automatically recompile adapter outputs (`.cursorrules`, `.zed/rules.md`, `.github/copilot-instructions.md`, etc.) upon saving:
+
+```bash
+contextos watch
+# or: npm run watch
 ```
 
 ### Supported Agents & Compilation
 
 | Agent | Command | Output Format |
 |-------|---------|---------------|
-| **Gemini / Antigravity** | `export gemini` | `.agents/generated/gemini/skills/` |
-| **Claude Code** | `export claude` | `.agents/generated/claude/skills/` |
-| **Cursor IDE** | `export cursor` | `.cursor/rules/*.mdc` (modular globs) + `.cursorrules` |
-| **GitHub Copilot** | `export copilot` | `.github/copilot-instructions.md` |
-| **Aider** | `export aider` | `.aider.conf.yml` + `CONVENTIONS.md` |
-| **Zed IDE** | `export zed` | `.zed/rules.md` + `.zed/prompts/*.md` |
+| **Gemini / Antigravity** | `contextos export gemini` | `.agents/generated/gemini/skills/` |
+| **Claude Code** | `contextos export claude` | `.agents/generated/claude/skills/` |
+| **Cursor IDE** | `contextos export cursor` | `.cursor/rules/*.mdc` (modular globs) + `.cursorrules` |
+| **GitHub Copilot** | `contextos export copilot` | `.github/copilot-instructions.md` |
+| **Aider** | `contextos export aider` | `.aider.conf.yml` + `CONVENTIONS.md` |
+| **Zed IDE** | `contextos export zed` | `.zed/rules.md` + `.zed/prompts/*.md` |
 
 ```bash
-node .agents/ctx.js export all       # Compile for all agents
-node .agents/ctx.js export gemini    # Compile for Gemini / Antigravity
-node .agents/ctx.js export claude    # Compile for Claude Code
-node .agents/ctx.js export cursor    # Compile for Cursor (.cursor/rules/*.mdc)
-node .agents/ctx.js export copilot   # Compile for GitHub Copilot
-node .agents/ctx.js export aider     # Compile for Aider
-node .agents/ctx.js export zed       # Compile for Zed IDE
+contextos export all       # Compile for all agents (or: node .agents/ctx.js export all)
+contextos export gemini    # Compile for Gemini / Antigravity
+contextos export claude    # Compile for Claude Code
+contextos export cursor    # Compile for Cursor (.cursor/rules/*.mdc)
+contextos export copilot   # Compile for GitHub Copilot
+contextos export aider     # Compile for Aider
+contextos export zed       # Compile for Zed IDE
 ```
 
 ### Pre-Compiled Artifacts & Git Architecture
@@ -241,13 +270,14 @@ You can expand your `.agents` folder with community plugins or validate your own
 
 ```bash
 # Launch the interactive skill installer to browse and install community skills
-npx contextos-agents install-skill
+contextos install-skill
+# or: npx contextos install-skill
 
 # Or install a specific skill from a GitHub repository automatically
-npx contextos-agents install-skill --from-repo kok-o/awesome-skill
+contextos install-skill --from-repo kok-o/awesome-skill
 
 # Validate your local skills (checks frontmatter, dependencies, and sync)
-npx contextos-agents audit
+contextos audit
 ```
 
 ## ContextOS MCP Server & Autonomous Multi-Agent Swarm
@@ -312,39 +342,39 @@ Add ContextOS to your IDE's MCP settings (e.g. in `.agents/mcp_config.json`):
 
 Tests use the **Node.js built-in test runner** for the core framework and **Vitest** for the MCP engine — zero external test bloat.
 
-### 1. Root Test Suite (121 tests)
+### 1. Root Test Suite (131 tests)
 
 ```bash
 npm test
 ```
 
 ```text
-# tests 121
+# tests 131
 # suites 27
-# pass  121
+# pass  131
 # fail  0
 ```
 
-### 2. MCP Server Test Suite (428 tests)
+### 2. MCP Server Test Suite (440 tests)
 
 ```bash
 cd contextos-mcp && npm test
 ```
 
 ```text
-Test Files  24 passed (24)
-     Tests  428 passed (428)
+Test Files  25 passed | 1 skipped (26)
+     Tests  440 passed | 13 skipped (453)
 ```
 
 **Test coverage:**
 
-- `tests/install.test.js` — installer CLI flags (--help, --dry-run, --force)
-- `tests/export.test.js` — ctx.js export for gemini, claude, cursor (.mdc rules), copilot, aider
+- `tests/install.test.js` — installer CLI flags (--help, --minimal, --dry-run, --force)
+- `tests/export.test.js` — ctx.js export for gemini, claude, cursor (.mdc rules), copilot, aider, zed
 - `tests/skills.test.js` — validates all skill source files and frontmatter
 - `tests/profile.test.js` — profile resolution, stack auto-detection, and skill filtering
 - `tests/validate.test.js` — validator rules, dependency graph, and sync checks
 - `tests/plugins.test.js` — plugin lockfile, registry fetching, and security checks
-- `tests/resolver.test.js` — dynamic skill resolution, progressive index, and bilingual prompt matching
+- `tests/resolver.test.js` — dynamic skill resolution, AST import graph analysis, progressive index, and bilingual prompt matching
 - `tests/benchmark.test.js` — benchmark scoring engine, static AST checks, runtime sandbox, and reporters
 - `contextos-mcp/tests/unit/session-persistence.test.ts` — session disk persistence, thread state tracking, and orphan purge
 - `contextos-mcp/tests/unit/contextos-tools.test.ts` — all 6 MCP tool handlers and validation

package/bin/index.js

@@ -95,65 +95,69 @@ Examples:
 // ── Top-level Commands & Proxy Routing ────────────────────────────────────────
 const mainCommand = args[0] && !args[0].startsWith('-') ? args[0] : null;
 
-// Doctor diagnostic health check
-if (mainCommand === 'doctor') {
-  let doctorModule;
-  const localDoctor = path.join(process.cwd(), '.agents', 'doctor.js');
-  if (fs.existsSync(localDoctor)) {
-    doctorModule = require(localDoctor);
-  } else {
-    doctorModule = require('../.agents/doctor.js');
+// Proxy commands to .agents/ctx.js when executed in a ContextOS project
+const PROXY_COMMANDS = [
+  'profile', 'export', 'validate', 'resolve', 'skill', 'index',
+  'clean-worktrees', 'doctor', 'stats', 'watch', 'init'
+];
+
+const ctxPath = path.join(process.cwd(), '.agents', 'ctx.js');
+const hasLocalCtx = fs.existsSync(ctxPath);
+
+if (mainCommand && PROXY_COMMANDS.includes(mainCommand) && hasLocalCtx) {
+  const { execFileSync } = require('child_process');
+  try {
+    execFileSync(process.execPath, [ctxPath, ...args], { stdio: 'inherit' });
+  } catch (e) {
+    process.exit(e.status || 1);
   }
+  process.exit(0);
+}
+
+// Fallbacks when running outside an initialized .agents/ directory
+if (mainCommand === 'doctor') {
+  const doctorModule = require('../.agents/doctor.js');
   doctorModule.runDoctor(process.cwd());
   process.exit(0);
 }
 
-// Context savings statistics report
 if (mainCommand === 'stats') {
-  let statsModule;
-  const localStats = path.join(process.cwd(), '.agents', 'stats.js');
-  if (fs.existsSync(localStats)) {
-    statsModule = require(localStats);
-  } else {
-    statsModule = require('../.agents/stats.js');
-  }
+  const statsModule = require('../.agents/stats.js');
   statsModule.runStats(process.cwd());
   process.exit(0);
 }
 
-// Background auto-sync file watcher daemon
 if (mainCommand === 'watch') {
-  let watchModule;
-  const localWatch = path.join(process.cwd(), '.agents', 'watch.js');
-  if (fs.existsSync(localWatch)) {
-    watchModule = require(localWatch);
-  } else {
-    watchModule = require('../.agents/watch.js');
-  }
+  const watchModule = require('../.agents/watch.js');
   watchModule.runWatch(process.cwd());
 }
 
-// Proxy commands to .agents/ctx.js when executed in a ContextOS project
-const PROXY_COMMANDS = ['profile', 'export', 'validate', 'resolve', 'skill', 'index', 'clean-worktrees'];
-if (mainCommand && PROXY_COMMANDS.includes(mainCommand)) {
-  const ctxPath = path.join(process.cwd(), '.agents', 'ctx.js');
-  if (!fs.existsSync(ctxPath)) {
-    console.error('[ERROR] .agents/ctx.js not found in current directory.');
-    console.error('        Are you in a ContextOS project? Run `contextos` or `npx contextos-agents` first.');
-    process.exit(1);
-  }
-  const { execFileSync } = require('child_process');
-  try {
-    execFileSync(process.execPath, [ctxPath, ...args], { stdio: 'inherit' });
-  } catch (e) {
-    process.exit(e.status || 1);
-  }
+if (mainCommand === 'init') {
+  console.log(`
+ContextOS — Project Setup
+
+Usage:
+  npx contextos                    Install .agents/ with auto-detected stack
+  npx contextos --profile <name>   Install with specific profile (mvp, startup, enterprise, frontend, backend)
+  npx contextos --minimal          Install only 5 core skills
+  npx contextos --with-mcp         Install with MCP execution server enabled
+
+Run:
+  contextos doctor                 Verify installation health
+  contextos stats                  Show token savings report
+`);
   process.exit(0);
 }
 
+const PROJECT_ONLY_COMMANDS = ['profile', 'export', 'validate', 'resolve', 'skill', 'index', 'clean-worktrees'];
+if (mainCommand && PROJECT_ONLY_COMMANDS.includes(mainCommand) && !hasLocalCtx) {
+  console.error('[ERROR] .agents/ctx.js not found in current directory.');
+  console.error('        Are you in a ContextOS project? Run `contextos` or `npx contextos-agents` first.');
+  process.exit(1);
+}
+
 if (mainCommand === 'audit') {
-  const ctxPath = path.join(process.cwd(), '.agents', 'ctx.js');
-  if (!fs.existsSync(ctxPath)) {
+  if (!hasLocalCtx) {
     console.error('[ERROR] .agents/ctx.js not found. Are you in a ContextOS project?');
     process.exit(1);
   }
@@ -198,10 +202,10 @@ if (mainCommand === 'install-skill') {
     }
     process.exit(0);
   } else {
-    // Interactive menu
+    // Interactive menu using standard library readline
     (async () => {
       try {
-        const inquirer = require('inquirer');
+        const readline = require('readline');
         const https = require('https');
         
         console.log('Fetching community skills from registry...');
@@ -210,33 +214,68 @@ if (mainCommand === 'install-skill') {
           https.get('https://raw.githubusercontent.com/kok-o/contextos-agents/main/registry.json', (res) => {
             let data = '';
             res.on('data', chunk => data += chunk);
-            res.on('end', () => resolve(JSON.parse(data)));
+            res.on('end', () => {
+              try {
+                resolve(JSON.parse(data));
+              } catch (err) {
+                reject(err);
+              }
+            });
           }).on('error', reject);
         });
         
         const registry = await fetchRegistry();
-        const choices = registry.skills.map(s => ({
-          name: `${s.name} - ${s.description}`,
+        const skillsList = (registry.skills || []).map((s, idx) => ({
+          idx: idx + 1,
+          name: s.name,
+          desc: s.description || '',
           value: s.github ? `${s.github}${s.path ? '/' + s.path : ''}` : s.npm
         }));
-        
-        const answers = await inquirer.prompt([
-          {
-            type: 'checkbox',
-            name: 'selectedSkills',
-            message: 'Select skills to install:',
-            choices
-          }
-        ]);
-        
-        if (!answers.selectedSkills || answers.selectedSkills.length === 0) {
-          console.log('No skills selected.');
+
+        if (skillsList.length === 0) {
+          console.log('No community skills found in registry.');
           process.exit(0);
         }
-        
+
+        console.log('\nAvailable community skills:\n');
+        for (const item of skillsList) {
+          console.log(`  [${item.idx}] ${item.name.padEnd(20)} ${item.desc}`);
+        }
+        console.log('\nEnter skill numbers to install (comma-separated, e.g. 1, 3) or press Enter to cancel:');
+
+        const rl = readline.createInterface({
+          input: process.stdin,
+          output: process.stdout,
+        });
+
+        const answer = await new Promise((resolve) => {
+          rl.question('> ', (ans) => {
+            rl.close();
+            resolve(ans.trim());
+          });
+        });
+
+        if (!answer) {
+          console.log('No skills selected. Operation cancelled.');
+          process.exit(0);
+        }
+
+        const selectedIndices = answer
+          .split(/[\s,]+/)
+          .map(n => parseInt(n, 10))
+          .filter(n => !isNaN(n) && n >= 1 && n <= skillsList.length);
+
+        const selectedSkills = selectedIndices.map(n => skillsList[n - 1].value);
+
+        if (selectedSkills.length === 0) {
+          console.log('No valid skill numbers selected.');
+          process.exit(0);
+        }
+
         const { execFileSync } = require('child_process');
-        for (const skillRef of answers.selectedSkills) {
+        for (const skillRef of selectedSkills) {
           try {
+            console.log(`\nInstalling ${skillRef}...`);
             execFileSync(process.execPath, [ctxPath, 'skill', 'add', skillRef], { stdio: 'inherit' });
           } catch (e) {
             console.error(`Failed to install ${skillRef}`);
@@ -244,9 +283,6 @@ if (mainCommand === 'install-skill') {
         }
       } catch (error) {
         console.error('Failed to run interactive installer:', error.message);
-        if (error.code === 'MODULE_NOT_FOUND' && error.message.includes('inquirer')) {
-          console.error('It seems inquirer is not installed. Did you run npm install?');
-        }
         process.exit(1);
       }
     })();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "contextos-agents",
-  "version": "1.6.0",
+  "version": "1.6.1",
   "description": "Install a .agents folder into your project to teach AI assistants best practices: UI/UX, architecture, security, and engineering workflow skills.",
   "bin": {
     "contextos": "./bin/index.js",
@@ -71,7 +71,5 @@
   "devDependencies": {
     "markdownlint-cli": "^0.43.0"
   },
-  "dependencies": {
-    "inquirer": "^8.2.7"
-  }
+  "dependencies": {}
 }