@minhpnq1807/contextos 0.5.24 → 0.5.26

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## 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.
+- **Fix Windows shell quoting:** `shellQuote` now uses double-quotes on Windows (`process.platform === "win32"`) instead of POSIX single-quotes which are not recognized by cmd.exe/PowerShell.
+- **Fix Codex CLI invocation on Windows:** `runCodex`/`tryRunCodex` now pass `shell: true` to `execFileSync` so Windows can resolve `codex.cmd` via PATH.
+
 ## 0.5.24
 
 - **Interactive agent selection:** Replaces the comma-separated text input in `ctx setup` with an interactive multi-select prompt — use ↑/↓ to navigate, Space to toggle agents on/off, and Enter to confirm.

package/bin/ctx.js

@@ -41,11 +41,8 @@ function usage() {
   return `ContextOS (ctx)
 
 Usage:
-  ctx install
-  ctx install codex
-  ctx install claude
-  ctx install agy
-  ctx install --agent codex
+  ctx install                  (interactive agent selection)
+  ctx install --agent codex    (direct install for a specific agent)
   ctx install --agent claude
   ctx install --agent agy
   ctx install --quiet
@@ -82,6 +79,12 @@ Usage:
 `;
 }
 
+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)) {
@@ -332,7 +335,7 @@ async function warmInstallEmbeddings() {
 
 function tryRunCodex(args) {
   try {
-    execFileSync("codex", args, { stdio: "ignore" });
+    execFileSync("codex", args, { stdio: "ignore", shell: true });
   } catch {
     // Best effort cleanup for repeat installs.
   }
@@ -340,7 +343,7 @@ function tryRunCodex(args) {
 
 function runCodex(args) {
   try {
-    execFileSync("codex", args, { stdio: "inherit" });
+    execFileSync("codex", args, { stdio: "inherit", shell: true });
   } catch (error) {
     const status = typeof error.status === "number" ? error.status : 1;
     throw new Error(`codex ${args.join(" ")} failed with exit code ${status}. Make sure Codex CLI is installed and authenticated.`);
@@ -581,8 +584,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 +593,28 @@ 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 inject = args.includes("--inject") || !args.includes("--quiet");
+    const explicitAgent = installAgentFromArgs(args);
+
+    if (explicitAgent) {
+      // Direct mode: ctx install --agent <name>
+      await install({ copy, inject, 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, inject, 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.24",
+  "version": "0.5.26",
   "description": "Task-aware AGENTS.md context injection and compliance reporting for Codex, Claude Code, and Antigravity.",
   "type": "module",
   "bin": {

package/plugins/ctx/lib/antigravity-hooks.js

@@ -3,14 +3,23 @@ import os from "node:os";
 import path from "node:path";
 
 function shellQuote(value) {
-  return `'${String(value).replaceAll("'", "'\\''")}'`;
+  const s = String(value);
+  if (process.platform === "win32") {
+    return `"${s.replaceAll('"', '\\"')}"`;
+  }
+  return `'${s.replaceAll("'", "'\\''")}'`;
 }
 
 function readJsonFile(filePath, fallback) {
   if (!fs.existsSync(filePath)) return fallback;
   const raw = fs.readFileSync(filePath, "utf8").trim();
   if (!raw) return fallback;
-  return JSON.parse(raw);
+  try {
+    return JSON.parse(raw);
+  } catch {
+    console.warn(`[ctx] warning: corrupt JSON in ${filePath}, overwriting with defaults`);
+    return fallback;
+  }
 }
 
 function commandFor(installRoot, scriptName, { injectPromptContext = true } = {}) {

package/plugins/ctx/lib/antigravity-mcp.js

@@ -6,7 +6,12 @@ function readJsonFile(filePath, fallback) {
   if (!fs.existsSync(filePath)) return fallback;
   const raw = fs.readFileSync(filePath, "utf8").trim();
   if (!raw) return fallback;
-  return JSON.parse(raw);
+  try {
+    return JSON.parse(raw);
+  } catch {
+    console.warn(`[ctx] warning: corrupt JSON in ${filePath}, overwriting with defaults`);
+    return fallback;
+  }
 }
 
 export function antigravityMcpConfigPaths() {

package/plugins/ctx/lib/claude-hooks.js

@@ -8,7 +8,12 @@ function readJsonFile(filePath, fallback) {
   if (!fs.existsSync(filePath)) return fallback;
   const raw = fs.readFileSync(filePath, "utf8").trim();
   if (!raw) return fallback;
-  return JSON.parse(raw);
+  try {
+    return JSON.parse(raw);
+  } catch {
+    console.warn(`[ctx] warning: corrupt JSON in ${filePath}, overwriting with defaults`);
+    return fallback;
+  }
 }
 
 export function claudeHome() {

package/plugins/ctx/lib/global-hooks.js

@@ -6,16 +6,25 @@ const QUIET_CODE_REVIEW_GRAPH_STATUS_COMMAND =
   "git rev-parse --git-dir >/dev/null 2>&1 && code-review-graph status >/dev/null 2>&1 || true";
 
 function shellQuote(value) {
-  return `'${String(value).replaceAll("'", "'\\''")}'`;
+  const s = String(value);
+  if (process.platform === "win32") {
+    return `"${s.replaceAll('"', '\\"')}"`;
+  }
+  return `'${s.replaceAll("'", "'\\''")}'`;
 }
 
 function readHooksFile(hooksPath) {
   if (!fs.existsSync(hooksPath)) return { hooks: {} };
   const raw = fs.readFileSync(hooksPath, "utf8").trim();
   if (!raw) return { hooks: {} };
-  const parsed = JSON.parse(raw);
-  if (!parsed.hooks || typeof parsed.hooks !== "object") parsed.hooks = {};
-  return parsed;
+  try {
+    const parsed = JSON.parse(raw);
+    if (!parsed.hooks || typeof parsed.hooks !== "object") parsed.hooks = {};
+    return parsed;
+  } catch {
+    console.warn(`[ctx] warning: corrupt JSON in ${hooksPath}, overwriting with defaults`);
+    return { hooks: {} };
+  }
 }
 
 function isContextOSHookEntry(entry) {