@minhpnq1807/contextos 0.5.25 → 0.5.27

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 0.5.27
+
+- **Fix Windows `spawnSync`/`execFileSync` ENOENT across all modules:** Added `shell: true` to every remaining child-process invocation in `ruler-sync.js`, `skillshare-sync.js`, `passthrough.js`, and `measure.js`. Without this, Windows cannot resolve `.cmd`/`.ps1` shims (e.g. `npm.cmd`, `ruler.cmd`, `skillshare.cmd`) via PATH, causing `ctx setup` to crash during the Ruler/Skillshare installation step.
+
+## 0.5.26
+
+- **Interactive `ctx install`:** Running `ctx install` without `--agent` now shows an interactive multi-select prompt (↑/↓ to navigate, Space to toggle, Enter to confirm) letting you pick which agents to install in one go.
+- **Removed positional agent args:** `ctx install codex`, `ctx install claude`, `ctx install agy` no longer work as positional shortcuts. Use `ctx install` (interactive) or `ctx install --agent <name>` (direct).
+
 ## 0.5.25
 
 - **Fix Windows JSON parse crash:** All `readJsonFile`/`readHooksFile` helpers now catch corrupt JSON and warn instead of crashing, allowing fresh config to be generated automatically.

package/bin/ctx.js

@@ -41,47 +41,46 @@ function usage() {
   return `ContextOS (ctx)
 
 Usage:
-  ctx install
-  ctx install codex
-  ctx install claude
-  ctx install agy
-  ctx install --agent codex
-  ctx install --agent claude
-  ctx install --agent agy
-  ctx install --quiet
-  ctx install --inject
-  ctx install --copy
-  ctx setup
-  ctx setup --yes
-  ctx setup --agents codex,claude,agy
-  ctx setup --no-rules
-  ctx setup --no-skills
-  ctx setup --quiet
-  ctx debug -- "task"
-  ctx report
-  ctx evidence
-  ctx stats
-  ctx benchmark -- "task"
-  ctx sync --rules
-  ctx sync --rules --agents codex,claude,antigravity
-  ctx sync --rules --dry-run
-  ctx sync --rules --no-import-codex-mcp
-  ctx sync --skills
-  ctx sync --workflows
-  ctx sync --workflows --agents codex,claude,agy
-  ctx sync --workflows --dry-run
-  ctx sync --skills --dry-run
-  ctx sync --skills --no-collect
-  ctx sync --skills --no-embeddings
-  ctx sync --skills --verbose
-  ctx sync --skills --agents codex,claude,antigravity
-  ctx embeddings warm -- "task"
-  ctx ruler -- <ruler args>
-  ctx skillshare -- <skillshare args>
-  ctx --version
+  ctx install                                  Interactive multi-select agent installer
+  ctx install --agent <name>                   Install a specific agent (codex|claude|agy)
+  ctx install --copy                           Legacy: copy plugin folder only (no hooks/mcp)
+  ctx setup                                    Interactive full setup wizard
+  ctx setup --yes                              Auto-confirm all setup prompts
+  ctx setup --agents codex,claude,agy          Pre-select agents to install
+  ctx setup --no-rules                         Skip AGENTS.md rule sync
+  ctx setup --no-skills                        Skip skill sync
+  ctx setup --quiet                            Quiet mode (minimal output)
+  ctx debug -- "task"                          Debug a task with ContextOS tracing
+  ctx report                                   Show last ContextOS compliance report
+  ctx evidence                                 Show evidence from last report
+  ctx stats                                    Show workspace statistics
+  ctx benchmark -- "task"                      Benchmark workspace for a task
+  ctx sync --rules                             Sync AGENTS.md rules to all agents
+  ctx sync --rules --agents codex,claude,agy   Sync rules to specific agents only
+  ctx sync --rules --dry-run                   Preview rule sync without writing
+  ctx sync --rules --no-import-codex-mcp       Skip importing Codex MCP servers
+  ctx sync --skills                            Sync skills across agents
+  ctx sync --skills --agents codex,claude,agy  Sync skills to specific agents only
+  ctx sync --skills --dry-run                  Preview skill sync without writing
+  ctx sync --skills --no-collect               Skip collecting new skills
+  ctx sync --skills --no-embeddings            Skip embedding generation
+  ctx sync --skills --verbose                  Verbose skill sync output
+  ctx sync --workflows                         Sync workflows across agents
+  ctx sync --workflows --agents codex,claude,agy  Sync workflows to specific agents
+  ctx sync --workflows --dry-run               Preview workflow sync without writing
+  ctx embeddings warm -- "task"                Pre-warm embedding caches for a task
+  ctx ruler -- <ruler args>                    Passthrough to ruler CLI
+  ctx skillshare -- <skillshare args>          Passthrough to skillshare CLI
+  ctx --version                                Show installed version
 `;
 }
 
+const SUPPORTED_AGENTS = [
+  { label: "Codex",             value: "codex",  selected: true },
+  { label: "Claude Code",      value: "claude", selected: true },
+  { label: "Antigravity (agy)", value: "agy",    selected: true }
+];
+
 function normalizeInstallAgent(agent) {
   const normalized = String(agent || "").trim().toLowerCase();
   if (/[|/]/.test(normalized)) {
@@ -180,7 +179,8 @@ function agentInstallRoot(agent) {
   return path.join(contextOSDataDir(), "agents", agent, "contextos");
 }
 
-async function install({ copy = false, inject = true, agent = "codex" } = {}) {
+async function install({ copy = false, agent = "codex" } = {}) {
+  const inject = true; // Prompt injection is always enabled
   agent = normalizeInstallAgent(agent);
   if (copy) {
     copyInstall();
@@ -513,7 +513,6 @@ async function setup({ args = [], cwd = process.cwd() } = {}) {
       options.agents = selected;
       const rl2 = readline.createInterface({ input, output });
       try {
-        options.inject = await askSetupYesNo(rl2, "Enable prompt context injection?", options.inject);
         options.syncRules = await askSetupYesNo(rl2, "Sync project rules and MCP servers through Ruler?", options.syncRules);
         options.syncSkills = await askSetupYesNo(rl2, "Sync skills through skillshare?", options.syncSkills);
       } finally {
@@ -522,7 +521,6 @@ async function setup({ args = [], cwd = process.cwd() } = {}) {
     } else {
       try {
         console.log(`◇ Install for agents:\n│  ${options.agents.join(", ")}`);
-        options.inject = await askSetupYesNo(rl, "Enable prompt context injection?", options.inject);
         options.syncRules = await askSetupYesNo(rl, "Sync project rules and MCP servers through Ruler?", options.syncRules);
         options.syncSkills = await askSetupYesNo(rl, "Sync skills through skillshare?", options.syncSkills);
       } finally {
@@ -540,7 +538,7 @@ async function setup({ args = [], cwd = process.cwd() } = {}) {
 
   for (const agent of options.agents) {
     console.log(`● Setting up ${agent}...`);
-    await install({ agent, inject: options.inject, copy: false });
+    await install({ agent, copy: false });
   }
 
   if (options.syncRules) {
@@ -581,8 +579,7 @@ const command = args[0];
 function installAgentFromArgs(args) {
   const agentFlag = args.indexOf("--agent");
   if (agentFlag >= 0) return normalizeInstallAgent(args[agentFlag + 1] || "");
-  const firstValue = args.slice(1).find((arg) => !arg.startsWith("--"));
-  return normalizeInstallAgent(firstValue || "codex");
+  return null; // no --agent flag → interactive selection
 }
 
 try {
@@ -591,11 +588,27 @@ try {
   } else if (command === "--version" || command === "-v") {
     console.log(packageVersion());
   } else if (command === "install") {
-    await install({
-      copy: args.includes("--copy"),
-      inject: args.includes("--inject") || !args.includes("--quiet"),
-      agent: installAgentFromArgs(args)
-    });
+    const copy = args.includes("--copy");
+    const explicitAgent = installAgentFromArgs(args);
+
+    if (explicitAgent) {
+      // Direct mode: ctx install --agent <name>
+      await install({ copy, agent: explicitAgent });
+    } else {
+      // Interactive mode: ctx install
+      const selected = await multiSelect({
+        message: "Select agents to install:",
+        options: SUPPORTED_AGENTS
+      });
+      if (!selected.length) {
+        console.log("No agents selected. Nothing to install.");
+      } else {
+        for (const agent of selected) {
+          await install({ copy, agent });
+          console.log("");
+        }
+      }
+    }
   } else if (command === "setup") {
     await setup({ args: args.slice(1), cwd: process.cwd() });
   } else if (command === "debug") {

package/package.json

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

package/plugins/ctx/lib/measure.js

@@ -53,7 +53,8 @@ export function readGitSnapshot({ cwd = process.cwd() } = {}) {
       cwd,
       encoding: "utf8",
       stdio: ["ignore", "pipe", "pipe"],
-      timeout: 1000
+      timeout: 1000,
+      shell: true
     });
     return parseGitDiff(diff);
   } catch {
@@ -62,7 +63,8 @@ export function readGitSnapshot({ cwd = process.cwd() } = {}) {
         cwd,
         encoding: "utf8",
         stdio: ["ignore", "pipe", "pipe"],
-        timeout: 1000
+        timeout: 1000,
+        shell: true
       });
       const changedFiles = parseStatusFiles(status);
       return {

package/plugins/ctx/lib/passthrough.js

@@ -33,7 +33,8 @@ export function runPassthrough({
   const result = spawn(command, args, {
     cwd,
     env,
-    stdio: "inherit"
+    stdio: "inherit",
+    shell: true
   });
 
   if (result.error) {

package/plugins/ctx/lib/ruler-sync.js

@@ -24,7 +24,7 @@ function statusLine(label, value) {
 
 function runCommand(command, args, { cwd = process.cwd(), stdio = "pipe", dryRun = false } = {}) {
   if (dryRun) return { stdout: "", skipped: true };
-  const stdout = execFileSync(command, args, { cwd, stdio, encoding: "utf8" });
+  const stdout = execFileSync(command, args, { cwd, stdio, encoding: "utf8", shell: true });
   return { stdout: stdout || "" };
 }
 

package/plugins/ctx/lib/setup-wizard.js

@@ -12,7 +12,6 @@ export function parseSetupArgs(args = []) {
     agentsProvided,
     yes: args.includes("--yes") || args.includes("-y"),
     quiet: args.includes("--quiet"),
-    inject: !args.includes("--quiet") && !args.includes("--no-inject"),
     syncRules: !args.includes("--no-rules"),
     syncSkills: !args.includes("--no-skills")
   };
@@ -35,14 +34,13 @@ export function normalizeSetupAgent(agent) {
 export function setupSummaryLines({
   cwd = process.cwd(),
   agents = DEFAULT_AGENTS,
-  inject = true,
   syncRules = true,
   syncSkills = true
 } = {}) {
   return [
     `Installation directory: ${cwd}`,
     `Agents: ${agents.join(", ") || "(none)"}`,
-    `Prompt context injection: ${inject ? "enabled" : "quiet logging only"}`,
+    `Prompt context injection: always enabled`,
     `Ruler rule/MCP sync: ${syncRules ? "enabled" : "skipped"}`,
     `skillshare skill sync: ${syncSkills ? "enabled" : "skipped"}`
   ];

package/plugins/ctx/lib/skillshare-sync.js

@@ -21,7 +21,7 @@ function statusLine(label, value) {
 
 function runCommand(command, args = [], { cwd = process.cwd(), stdio = "pipe", dryRun = false } = {}) {
   if (dryRun) return { stdout: "", skipped: true };
-  const stdout = execFileSync(command, args, { cwd, stdio, encoding: "utf8" });
+  const stdout = execFileSync(command, args, { cwd, stdio, encoding: "utf8", shell: true });
   return { stdout: stdout || "" };
 }