@minhpnq1807/contextos 0.5.36 → 0.5.38

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 0.5.38
+
+- **Unified agent branding:** All user-facing text now shows `antigravity` instead of `agy`. Internal value remains `agy` for backward compatibility. Interactive prompts display "Antigravity" without the parenthetical alias.
+- **`ctx help` command:** Added `help` as a recognized command (alongside `--help` and `-h`). Previously returned "Unknown command".
+- **`--help` in usage:** Added `ctx --help` line to the usage display so it's discoverable.
+- **Fix `--agents` flag parsing:** `ctx install --agents antigravity` now correctly skips the interactive prompt. Previously only `--agent` (singular) was recognized.
+- **Cleaner usage text:** Replaced hardcoded agent lists (`codex,claude,antigravity,copilot`) with `<names>` placeholder for future-proof documentation.
+
+## 0.5.37
+
+- **Real-time animated progress bar for `ctx install`:** The progress spinner now updates in-place using raw stderr writes (`\r`) instead of being captured by `streamSetupOutput`. Uses a smooth 10-frame Braille spinner (`⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏`) with a visual bar (`[████████░░░░]`) that animates at 80ms intervals.
+- **Clean install output:** Reduced verbose per-agent install summary from 10+ lines of paths to a compact 4-line summary (Hooks →, MCP →, Embeddings count, restart instruction). Removed redundant "embedding model already cached" log line from `warmInstallEmbeddings`.
+- **Fix `streamSetupOutput` breaking spinner:** Previously intercepted `process.stderr.write` and converted `\r` carriage returns to newlines, preventing in-place updates. Now only intercepts `console.log` for `│  ` prefixed output, leaving stderr untouched for spinner rendering.
+- **Suppress codex command noise:** `runCodex()` no longer prints verbose stdout lines like "Added marketplace `contextos`" and "Added global MCP server 'ctx-mcp'" — the progress spinner already provides feedback.
+- **Clean context formatting:** Removed absolute paths from rules, skills, and workflows in scheduler output. Removed duplicate "ContextOS reminders" section. Truncated long skill descriptions to 80 chars. Capped rules at 5 per section instead of 8. Context now renders as clean, readable markdown:
+
 ## 0.5.36
 
 - **Fix ctx_score_context MCP output not rendering in Antigravity editor:** The `content` text block returned by the MCP tool previously only contained raw telemetry JSON, which editors cannot render as user-facing context. Now the tool uses `scheduleContext()` to produce the same human-readable markdown (Critical ContextOS rules, Suggested files, Skills, Workflows) that the hook path generates, and returns it as the primary `content[0].text` block. Telemetry JSON is pushed to a secondary content block. This ensures Antigravity (and any MCP-compatible editor) displays the scored rules and file suggestions.

package/bin/ctx.js

@@ -43,44 +43,45 @@ function usage() {
   return `ContextOS (ctx)
 
 Usage:
-  ctx install                                  Interactive multi-select agent installer
-  ctx install --agent <name>                   Install a specific agent (codex|claude|agy|copilot)
-  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,copilot  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,copilot   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,copilot  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,copilot  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
+  ctx install                                       Interactive multi-select agent installer
+  ctx install --agent <name>                        Install a specific agent (codex|claude|antigravity|copilot)
+  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 <names>                        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 <names>                 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 <names>                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 <names>             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 --help                                        Show this help message
+  ctx --version                                     Show installed version
 `;
 }
 
 const SUPPORTED_AGENTS = [
   { label: "Codex",              value: "codex",   selected: false },
   { label: "Claude Code",       value: "claude",  selected: false },
-  { label: "Antigravity (agy)",  value: "agy",     selected: false },
+  { label: "Antigravity",         value: "agy",     selected: false },
   { label: "GitHub Copilot",     value: "copilot", selected: false }
 ];
 
@@ -92,55 +93,52 @@ function normalizeInstallAgent(agent) {
       "Install one agent per command:",
       "  ctx install --agent codex",
       "  ctx install --agent claude",
-      "  ctx install --agent agy",
+      "  ctx install --agent antigravity",
       "  ctx install --agent copilot",
       "",
-      "Do not run `ctx install --agent codex|claude|agy|copilot`: `|` is a shell pipe."
+      "Do not run `ctx install --agent codex|claude|antigravity|copilot`: `|` is a shell pipe."
     ].join("\n"));
   }
   if (normalized === "antigravity") return "agy";
   return normalized;
 }
 /**
- * Intercept console.log and process.stderr.write from an async fn,
+ * Intercept console.log from an async fn,
  * printing each line immediately with "│  " prefix for real-time feedback.
+ * stderr is left untouched so \r-based spinner writes render in-place.
  * Returns the collected lines array (for callers that inspect it).
  */
 async function streamSetupOutput(fn) {
   const lines = [];
   const origLog = console.log;
-  const origStderrWrite = process.stderr.write;
   const emit = (text) => {
     lines.push(text);
     origLog(`│  ${text}`);
   };
   console.log = (...args) => emit(args.map(String).join(" "));
-  process.stderr.write = (chunk) => {
-    const text = String(chunk).replace(/\r/g, "").trim();
-    if (text) emit(text);
-    return true;
-  };
   try {
     await fn();
   } finally {
     console.log = origLog;
-    process.stderr.write = origStderrWrite;
   }
   return lines;
 }
 
 function createInstallProgress({ quiet = false } = {}) {
-  const enabled = !quiet && process.stderr.isTTY;
-  const frames = ["-", "\\", "|", "/"];
+  const isTTY = !quiet && process.stderr.isTTY;
+  const frames = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
   let percent = 0;
   let label = "starting";
   let frame = 0;
   let timer = null;
+  // Use the raw stderr binding so streamSetupOutput cannot intercept spinner writes.
+  const rawStderrWrite = process.stderr.write.bind(process.stderr);
 
   function render() {
-    if (!enabled) return;
-    const text = `[ctx] install ${String(percent).padStart(3)}% ${frames[frame % frames.length]} ${label}`;
-    process.stderr.write(`\r${text.padEnd(92)}`);
+    if (!isTTY) return;
+    const bar = progressBar(percent);
+    const text = `  ${frames[frame % frames.length]} ${bar} ${label}`;
+    rawStderrWrite(`\r${text.padEnd(72)}`);
     frame += 1;
   }
 
@@ -148,43 +146,48 @@ function createInstallProgress({ quiet = false } = {}) {
     start(initialLabel = "starting") {
       label = initialLabel;
       percent = 0;
-      if (enabled) {
+      if (isTTY) {
         render();
-        timer = setInterval(render, 120);
+        timer = setInterval(render, 80);
       } else if (!quiet) {
-        console.log(`[ctx] install 0% ${label}`);
+        console.log(`[ctx] ${label}...`);
       }
     },
     step(nextPercent, nextLabel) {
       percent = Math.max(percent, Math.min(100, nextPercent));
       label = nextLabel;
-      if (enabled) render();
-      else if (!quiet) console.log(`[ctx] install ${percent}% ${label}`);
+      if (isTTY) render();
     },
     done(finalLabel = "done") {
       percent = 100;
       label = finalLabel;
       if (timer) clearInterval(timer);
       timer = null;
-      if (enabled) {
-        render();
-        process.stderr.write("\n");
+      if (isTTY) {
+        const bar = progressBar(100);
+        rawStderrWrite(`\r  ✓ ${bar} ${label}`.padEnd(72) + "\n");
       } else if (!quiet) {
-        console.log(`[ctx] install 100% ${label}`);
+        console.log(`[ctx] ✓ ${label}`);
       }
     },
     fail(errorLabel = "failed") {
       label = errorLabel;
       if (timer) clearInterval(timer);
       timer = null;
-      if (enabled) {
-        render();
-        process.stderr.write("\n");
+      if (isTTY) {
+        rawStderrWrite(`\r  ✗ ${errorLabel}`.padEnd(72) + "\n");
       }
     }
   };
 }
 
+function progressBar(percent) {
+  const width = 20;
+  const filled = Math.round(width * percent / 100);
+  const empty = width - filled;
+  return `[${'█'.repeat(filled)}${'░'.repeat(empty)}] ${String(percent).padStart(3)}%`;
+}
+
 function packageVersion() {
   try {
     const packageJson = JSON.parse(fs.readFileSync(path.join(rootDir, "package.json"), "utf8"));
@@ -224,81 +227,60 @@ async function install({ copy = false, agent = "codex" } = {}) {
     if (agent === "claude") {
       progress.step(10, "copying package");
       const installRoot = copyPackageRoot({ rootDir, targetRoot: agentInstallRoot("claude") });
-      progress.step(25, "installing hooks");
+      progress.step(30, "installing hooks");
       const hooksPath = installClaudeHooks({ installRoot, injectPromptContext: inject });
-      progress.step(40, "installing mcp");
+      progress.step(50, "installing mcp");
       const mcpConfigPath = installClaudeMcp({ installRoot });
-      progress.step(50, "configuring gitignore");
+      progress.step(60, "configuring gitignore");
       writeInnerGitignore(installRoot);
       ensureRootGitignore(process.cwd());
-      progress.step(55, "warming embeddings");
+      progress.step(70, "warming embeddings");
       const warmResult = await warmInstallEmbeddings();
-      progress.done("claude installed");
-      console.log("Installed ctx hooks for Claude Code.");
-      console.log(`Stable install root: ${installRoot}`);
-      console.log(`Installed ContextOS hooks to ${hooksPath}`);
-      console.log(`Installed ctx-mcp MCP server to ${mcpConfigPath}`);
-      console.log(`Embedding model cache: ${modelCacheDir(contextOSDataDir())}`);
-      console.log(`Embedding vectors cache: ${warmResult.cachePath}`);
-      console.log(`File path embeddings warmed: ${warmResult.fileCount || 0}`);
-      console.log(`Skill embeddings warmed: ${warmResult.skillCount || 0}`);
-      console.log(`Workflow embeddings warmed: ${warmResult.workflowCount || 0}`);
-      console.log(`Prompt context injection: ${inject ? "enabled" : "quiet logging only"}`);
-      console.log("Restart Claude Code if it was already running, then submit a task to trigger ContextOS.");
+      progress.done("claude ✓");
+      console.log(`Hooks → ${hooksPath}`);
+      console.log(`MCP   → ${mcpConfigPath}`);
+      console.log(`Embeddings: ${warmResult.fileCount || 0} files, ${warmResult.skillCount || 0} skills`);
+      console.log("Restart Claude Code to activate ContextOS.");
       return;
     }
 
     if (agent === "agy") {
       progress.step(10, "copying package");
       const installRoot = copyPackageRoot({ rootDir, targetRoot: agentInstallRoot("agy") });
-      progress.step(25, "installing hooks");
+      progress.step(30, "installing hooks");
       const hooksPath = installAntigravityHooks({ installRoot, injectPromptContext: inject });
-      progress.step(40, "installing mcp");
+      progress.step(50, "installing mcp");
       const mcpConfigPaths = installAntigravityMcp({ installRoot });
-      progress.step(50, "configuring gitignore");
+      progress.step(60, "configuring gitignore");
       writeInnerGitignore(installRoot);
       ensureRootGitignore(process.cwd());
-      progress.step(55, "warming embeddings");
+      progress.step(70, "warming embeddings");
       const warmResult = await warmInstallEmbeddings();
-      progress.done("agy installed");
-      console.log("Installed ctx hooks for Antigravity.");
-      console.log(`Stable install root: ${installRoot}`);
-      console.log(`Installed ContextOS hooks to ${hooksPath}`);
-      console.log(`Installed ctx-mcp MCP server to ${mcpConfigPaths.join(", ")}`);
-      console.log(`Embedding model cache: ${modelCacheDir(contextOSDataDir())}`);
-      console.log(`Embedding vectors cache: ${warmResult.cachePath}`);
-      console.log(`File path embeddings warmed: ${warmResult.fileCount || 0}`);
-      console.log(`Skill embeddings warmed: ${warmResult.skillCount || 0}`);
-      console.log(`Workflow embeddings warmed: ${warmResult.workflowCount || 0}`);
-      console.log(`Prompt context injection: ${inject ? "enabled" : "quiet logging only"}`);
-      console.log("Restart Antigravity or agy if it was already running, then submit a task to trigger ContextOS.");
+      progress.done("antigravity ✓");
+      console.log(`Hooks → ${hooksPath}`);
+      console.log(`MCP   → ${mcpConfigPaths.join(", ")}`);
+      console.log(`Embeddings: ${warmResult.fileCount || 0} files, ${warmResult.skillCount || 0} skills`);
+      console.log("Restart Antigravity to activate ContextOS.");
       return;
     }
 
     if (agent === "copilot") {
       progress.step(10, "copying package");
       const installRoot = copyPackageRoot({ rootDir, targetRoot: agentInstallRoot("copilot") });
-      progress.step(25, "installing hooks");
+      progress.step(30, "installing hooks");
       const hooksPath = installCopilotHooks({ cwd: process.cwd(), installRoot });
-      progress.step(40, "installing mcp");
+      progress.step(50, "installing mcp");
       const mcpConfigPath = installCopilotMcp({ cwd: process.cwd(), installRoot });
-      progress.step(50, "configuring gitignore");
+      progress.step(60, "configuring gitignore");
       writeInnerGitignore(installRoot);
       ensureRootGitignore(process.cwd());
-      progress.step(55, "warming embeddings");
+      progress.step(70, "warming embeddings");
       const warmResult = await warmInstallEmbeddings();
-      progress.done("copilot installed");
-      console.log("Installed ctx hooks for GitHub Copilot.");
-      console.log(`Stable install root: ${installRoot}`);
-      console.log(`Installed ContextOS instructions to ${hooksPath}`);
-      console.log(`Installed ctx-mcp MCP server to ${mcpConfigPath}`);
-      console.log(`Embedding model cache: ${modelCacheDir(contextOSDataDir())}`);
-      console.log(`Embedding vectors cache: ${warmResult.cachePath}`);
-      console.log(`File path embeddings warmed: ${warmResult.fileCount || 0}`);
-      console.log(`Skill embeddings warmed: ${warmResult.skillCount || 0}`);
-      console.log(`Workflow embeddings warmed: ${warmResult.workflowCount || 0}`);
-      console.log(`Prompt context injection: ${inject ? "enabled" : "quiet logging only"}`);
-      console.log("Restart VS Code or Copilot if it was already running, then submit a task to trigger ContextOS.");
+      progress.done("copilot ✓");
+      console.log(`Instructions → ${hooksPath}`);
+      console.log(`MCP          → ${mcpConfigPath}`);
+      console.log(`Embeddings: ${warmResult.fileCount || 0} files, ${warmResult.skillCount || 0} skills`);
+      console.log("Restart VS Code to activate ContextOS.");
       return;
     }
 
@@ -310,38 +292,31 @@ async function install({ copy = false, agent = "codex" } = {}) {
     const marketplaceRoot = path.join(codexHome(), "marketplaces", "contextos");
     copyPackageRoot({ rootDir, targetRoot: marketplaceRoot });
 
-    progress.step(20, "refreshing codex plugin");
+    progress.step(25, "refreshing codex plugin");
     tryRunCodex(["plugin", "remove", "ctx@contextos"]);
     tryRunCodex(["plugin", "marketplace", "remove", "contextos"]);
     tryRunCodex(["mcp", "remove", "ctx-mcp"]);
     runCodex(["plugin", "marketplace", "add", marketplaceRoot]);
     runCodex(["plugin", "add", "ctx@contextos"]);
-    progress.step(40, "installing mcp");
+    progress.step(45, "installing mcp");
     runCodex(["mcp", "add", "ctx-mcp", "--", "node", path.join(marketplaceRoot, "plugins", "ctx", "mcp", "server.js")]);
-    progress.step(50, "installing telemetry proxies");
+    progress.step(55, "installing telemetry proxies");
     const proxyResult = installMcpTelemetryProxies({ codexHome: codexHome(), marketplaceRoot });
-    progress.step(60, "installing hooks");
+    progress.step(65, "installing hooks");
     const hooksPath = installGlobalHooks({ codexHome: codexHome(), marketplaceRoot, injectPromptContext: inject });
 
-    progress.step(65, "configuring gitignore");
+    progress.step(70, "configuring gitignore");
     writeInnerGitignore(marketplaceRoot);
     ensureRootGitignore(process.cwd());
 
-    progress.step(70, "warming embeddings");
+    progress.step(80, "warming embeddings");
     const warmResult = await warmInstallEmbeddings();
-    progress.done("codex installed");
-    console.log("Installed ctx through Codex plugin marketplace.");
-    console.log(`Stable marketplace root: ${marketplaceRoot}`);
-    console.log(`Installed ContextOS global hooks to ${hooksPath}`);
-    console.log("Installed ctx-mcp MCP server.");
-    console.log(`MCP telemetry proxies: ${proxyResult.wrapped.length ? proxyResult.wrapped.map((item) => item.name).join(", ") : "none changed"}`);
-    console.log(`Embedding model cache: ${modelCacheDir(contextOSDataDir())}`);
-    console.log(`Embedding vectors cache: ${warmResult.cachePath}`);
-    console.log(`File path embeddings warmed: ${warmResult.fileCount || 0}`);
-    console.log(`Skill embeddings warmed: ${warmResult.skillCount || 0}`);
-    console.log(`Workflow embeddings warmed: ${warmResult.workflowCount || 0}`);
-    console.log(`Prompt context injection: ${inject ? "enabled" : "quiet logging only"}`);
-    console.log("Restart Codex if it was already running, then submit a task to trigger ContextOS.");
+    progress.done("codex ✓");
+    console.log(`Hooks   → ${hooksPath}`);
+    console.log(`MCP     → ctx-mcp installed`);
+    console.log(`Proxies → ${proxyResult.wrapped.length ? proxyResult.wrapped.map((item) => item.name).join(", ") : "none changed"}`);
+    console.log(`Embeddings: ${warmResult.fileCount || 0} files, ${warmResult.skillCount || 0} skills`);
+    console.log("Restart Codex to activate ContextOS.");
   } catch (error) {
     progress.fail("install failed");
     throw error;
@@ -351,9 +326,6 @@ async function install({ copy = false, agent = "codex" } = {}) {
 async function warmInstallEmbeddings() {
   const dataDir = contextOSDataDir();
   const modelReady = isModelCacheReady(dataDir);
-  console.log(modelReady
-    ? "Required local embedding model already cached."
-    : "Preparing required local embedding model...");
   const result = await warmRuleEmbeddings({
     rules: [
       { content: "Always use project rules that are semantically relevant to the user prompt." },
@@ -398,23 +370,14 @@ function tryRunCodex(args) {
 
 function runCodex(args) {
   try {
-    const stdout = execFileSync("codex", args, {
+    execFileSync("codex", args, {
       stdio: ["ignore", "pipe", "pipe"],
       encoding: "utf8",
       shell: true
     });
-    if (stdout && stdout.trim()) {
-      for (const line of stdout.trim().split(/\r?\n/)) {
-        console.log(line);
-      }
-    }
+    // Suppress stdout (e.g. "Added marketplace…", "Added global MCP server…")
+    // — the progress spinner already provides feedback.
   } catch (error) {
-    // Log any output captured before the error
-    if (error.stdout && error.stdout.trim()) {
-      for (const line of error.stdout.trim().split(/\r?\n/)) {
-        console.log(line);
-      }
-    }
     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.`);
   }
@@ -580,7 +543,7 @@ async function setup({ args = [], cwd = process.cwd() } = {}) {
         options: [
           { label: "Codex",              value: "codex",   selected: options.agents.includes("codex") },
           { label: "Claude",             value: "claude",  selected: options.agents.includes("claude") },
-          { label: "Antigravity (agy)",  value: "agy",     selected: options.agents.includes("agy") },
+          { label: "Antigravity",         value: "agy",     selected: options.agents.includes("agy") },
           { label: "GitHub Copilot",     value: "copilot", selected: options.agents.includes("copilot") }
         ]
       });
@@ -608,7 +571,7 @@ async function setup({ args = [], cwd = process.cwd() } = {}) {
   for (const line of setupSummaryLines({ cwd, ...options })) console.log(`│  ${line}`);
   console.log("");
 
-  if (!options.agents.length) throw new Error("No agents selected. Use --agents codex,claude,agy,copilot.");
+  if (!options.agents.length) throw new Error("No agents selected. Use --agents codex,claude,antigravity,copilot.");
 
   for (const agent of options.agents) {
     console.log(`◇ Setting up ${agent}...`);
@@ -650,26 +613,33 @@ async function setup({ args = [], cwd = process.cwd() } = {}) {
 const args = process.argv.slice(2);
 const command = args[0];
 
-function installAgentFromArgs(args) {
-  const agentFlag = args.indexOf("--agent");
-  if (agentFlag >= 0) return normalizeInstallAgent(args[agentFlag + 1] || "");
-  return null; // no --agent flag → interactive selection
+function installAgentsFromArgs(args) {
+  const agentFlag = Math.max(args.indexOf("--agent"), args.indexOf("--agents"));
+  if (agentFlag >= 0) {
+    const value = args[agentFlag + 1] || "";
+    return parseAgentList(value).map(normalizeInstallAgent).filter(Boolean);
+  }
+  return null; // no flag → interactive selection
 }
 
 try {
-  if (!command || command === "--help" || command === "-h") {
+  if (!command || command === "--help" || command === "-h" || command === "help") {
     console.log(usage());
   } else if (command === "--version" || command === "-v") {
     console.log(packageVersion());
   } else if (command === "install") {
     const copy = args.includes("--copy");
-    const explicitAgent = installAgentFromArgs(args);
-
-    if (explicitAgent) {
-      // Direct mode: ctx install --agent <name>
-      console.log(`◇ Installing ${explicitAgent}...`);
-      await streamSetupOutput(() => install({ copy, agent: explicitAgent }));
-      console.log("");
+    const explicitAgents = installAgentsFromArgs(args);
+
+    if (explicitAgents && explicitAgents.length) {
+      // Direct mode: ctx install --agents antigravity,codex
+      for (const agent of explicitAgents) {
+        console.log(`◇ Installing ${agent}...`);
+        await streamSetupOutput(() => install({ copy, agent }));
+        console.log("");
+      }
+    } else if (explicitAgents && !explicitAgents.length) {
+      console.log("No valid agents specified. Use --agents codex,claude,antigravity,copilot.");
     } else {
       // Interactive mode: ctx install
       const selected = await multiSelect({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@minhpnq1807/contextos",
-  "version": "0.5.36",
+  "version": "0.5.38",
   "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.36",
+  "version": "0.5.37",
   "description": "Inject task-relevant AGENTS.md rules into Codex through plugin hooks.",
   "author": {
     "name": "ContextOS"

package/plugins/ctx/lib/scheduler.js

@@ -1,3 +1,4 @@
+
 const MAX_CONTEXT_CHARS = 4000;
 
 export function scheduleContext({ rules = [], relevantFiles = [], suggestedSkills = [], suggestedWorkflows = [], maxChars = MAX_CONTEXT_CHARS } = {}) {
@@ -8,7 +9,7 @@ export function scheduleContext({ rules = [], relevantFiles = [], suggestedSkill
 
   const sections = [];
   if (high.length) {
-    sections.push(section("Critical ContextOS rules", high.slice(0, 8).map(formatRule)));
+    sections.push(section("Critical ContextOS rules", high.slice(0, 5).map(formatRule)));
   }
   if (relevantFiles.length) {
     sections.push(section("Suggested files to check", relevantFiles.map((file) => `- ${file.path}`)));
@@ -20,10 +21,7 @@ export function scheduleContext({ rules = [], relevantFiles = [], suggestedSkill
     sections.push(section("Suggested workflow for this task", suggestedWorkflows.map(formatWorkflow)));
   }
   if (mid.length) {
-    sections.push(section("Additional relevant rules", mid.slice(0, 8).map(formatRule)));
-  }
-  if (high.length) {
-    sections.push(section("ContextOS reminders", high.slice(0, 5).map(formatRule)));
+    sections.push(section("Additional relevant rules", mid.slice(0, 5).map(formatRule)));
   }
 
   const additionalContext = trimToLimit(sections.filter(Boolean).join("\n\n"), maxChars);
@@ -57,24 +55,28 @@ function section(title, lines) {
   return `## ${title}\n${lines.join("\n")}`;
 }
 
+
 function formatRule(rule) {
-  const source = rule.sourcePath && rule.sourcePath !== "unknown" ? ` (${rule.sourcePath})` : "";
-  return `- ${rule.content}${source}`;
+  return `- ${rule.content}`;
 }
 
 function formatSkill(skill) {
-  const description = skill.description ? `: ${skill.description}` : "";
-  const location = skill.path ? ` (${skill.path})` : "";
-  return `- ${skill.name}${description}${location}`;
+  const desc = skill.description
+    ? `: ${truncate(skill.description, 80)}`
+    : "";
+  return `- ${skill.name}${desc}`;
 }
 
 function formatWorkflow(workflow) {
   const name = workflow.title || workflow.name;
   const hint = workflow.hint ? `: ${workflow.hint}` : "";
   const chain = workflow.chain?.length ? `\n  chain: ${workflow.chain.join(" -> ")}` : "";
-  const location = workflow.relativePath || workflow.path;
-  const source = location ? `\n  see: ${location}` : "";
-  return `- ${name}${hint}${chain}${source}`;
+  return `- ${name}${hint}${chain}`;
+}
+
+function truncate(text, maxLen) {
+  if (text.length <= maxLen) return text;
+  return `${text.slice(0, maxLen - 1)}…`;
 }
 
 function trimToLimit(value, maxChars) {