@minhpnq1807/contextos 0.5.37 → 0.5.38

package/CHANGELOG.md

@@ -1,10 +1,20 @@
 # 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
 

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,10 +93,10 @@ 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";
@@ -369,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.`);
   }
@@ -551,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") }
         ]
       });
@@ -579,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}...`);
@@ -621,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.37",
+  "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/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) {