@minhpnq1807/contextos 0.5.33 → 0.5.35

package/CHANGELOG.md

@@ -1,10 +1,18 @@
 # Changelog
 
-## 0.5.33
+## 0.5.35
+
+- **Add GitHub Copilot agent support:** New `copilot` agent for `ctx install --agent copilot` and `ctx setup`. Creates `.github/copilot-instructions.md` with ContextOS integration marker and configures `ctx-mcp` MCP server in `.vscode/mcp.json`. Copilot is now recognized by Ruler (`ctx sync --rules`) and Skillshare (`ctx sync --skills`) alongside existing codex, claude, and agy agents.
+- **Agent selection defaults to none:** `ctx setup` and `ctx install` no longer pre-select all agents. Users must explicitly choose which agents to install via the interactive multiSelect prompt or `--agents` flag. This prevents accidental installation of unwanted agent hooks.
+- **copilot-hooks.js:** Writes a managed `copilot-instructions.md` file under `.github/`, appending to existing content if present. Uses a marker comment (`<!-- managed by ContextOS -->`) to avoid duplicate sections.
+- **copilot-mcp.js:** Configures `ctx-mcp` server in `.vscode/mcp.json` using the same pattern as existing claude/antigravity MCP modules.
+
+## 0.5.34
 
 - **Real-time streaming output during install/setup:** Replaced `captureSetupOutput` (buffered) with `streamSetupOutput` — now prints each line immediately with `│  ` prefix as it arrives, eliminating the perceived "hang" during long-running downloads and installs.
 - **Fix codex CLI output missing `│` prefix:** Changed `runCodex` from `stdio: "inherit"` to `stdio: ["ignore", "pipe", "pipe"]`. Output now flows through `console.log` → `streamSetupOutput` → `│  ` prefix, ensuring lines like "Added marketplace..." are consistently formatted.
 - **Async streaming for skillshare/ruler install:** Replaced blocking `execSync`/`runShell` calls in `installSkillshare` and `installRuler` with async `spawn` + line-by-line streaming. Download progress from PowerShell/curl/npm is now visible in real time instead of being buffered until completion.
+- **Fix `skillshare init` hang on Windows:** `skillshare init` is interactive by default (prompts for copy source, git, skill install). With stdin routed to NUL (deadlock prevention), the Go binary hangs waiting for terminal input that never arrives. Fixed by passing `--no-copy --no-git --no-skill --all-targets` flags for fully non-interactive initialization.
 
 ## 0.5.32
 

package/bin/ctx.js

@@ -24,6 +24,8 @@ import { installClaudeHooks } from "../plugins/ctx/lib/claude-hooks.js";
 import { installClaudeMcp } from "../plugins/ctx/lib/claude-mcp.js";
 import { installAntigravityHooks } from "../plugins/ctx/lib/antigravity-hooks.js";
 import { installAntigravityMcp } from "../plugins/ctx/lib/antigravity-mcp.js";
+import { installCopilotHooks } from "../plugins/ctx/lib/copilot-hooks.js";
+import { installCopilotMcp } from "../plugins/ctx/lib/copilot-mcp.js";
 import { syncRules } from "../plugins/ctx/lib/ruler-sync.js";
 import { writeInnerGitignore, ensureRootGitignore } from "../plugins/ctx/lib/gitignore.js";
 import { syncSkills } from "../plugins/ctx/lib/skillshare-sync.js";
@@ -42,11 +44,11 @@ function usage() {
 
 Usage:
   ctx install                                  Interactive multi-select agent installer
-  ctx install --agent <name>                   Install a specific agent (codex|claude|agy)
+  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          Pre-select agents to install
+  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)
@@ -56,17 +58,17 @@ Usage:
   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 --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  Sync skills to specific agents only
+  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  Sync workflows to specific 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
@@ -76,9 +78,10 @@ Usage:
 }
 
 const SUPPORTED_AGENTS = [
-  { label: "Codex",             value: "codex",  selected: true },
-  { label: "Claude Code",      value: "claude", selected: true },
-  { label: "Antigravity (agy)", value: "agy",    selected: true }
+  { label: "Codex",              value: "codex",   selected: false },
+  { label: "Claude Code",       value: "claude",  selected: false },
+  { label: "Antigravity (agy)",  value: "agy",     selected: false },
+  { label: "GitHub Copilot",     value: "copilot", selected: false }
 ];
 
 function normalizeInstallAgent(agent) {
@@ -90,8 +93,9 @@ function normalizeInstallAgent(agent) {
       "  ctx install --agent codex",
       "  ctx install --agent claude",
       "  ctx install --agent agy",
+      "  ctx install --agent copilot",
       "",
-      "Do not run `ctx install --agent codex|claude|agy`: `|` is a shell pipe."
+      "Do not run `ctx install --agent codex|claude|agy|copilot`: `|` is a shell pipe."
     ].join("\n"));
   }
   if (normalized === "antigravity") return "agy";
@@ -271,8 +275,35 @@ async function install({ copy = false, agent = "codex" } = {}) {
       return;
     }
 
+    if (agent === "copilot") {
+      progress.step(10, "copying package");
+      const installRoot = copyPackageRoot({ rootDir, targetRoot: agentInstallRoot("copilot") });
+      progress.step(25, "installing hooks");
+      const hooksPath = installCopilotHooks({ cwd: process.cwd(), installRoot });
+      progress.step(40, "installing mcp");
+      const mcpConfigPath = installCopilotMcp({ cwd: process.cwd(), installRoot });
+      progress.step(50, "configuring gitignore");
+      writeInnerGitignore(installRoot);
+      ensureRootGitignore(process.cwd());
+      progress.step(55, "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.");
+      return;
+    }
+
     if (agent !== "codex") {
-      throw new Error(`Unknown agent '${agent}'. Expected codex, claude, or agy.`);
+      throw new Error(`Unknown agent '${agent}'. Expected codex, claude, agy, or copilot.`);
     }
 
     progress.step(10, "copying marketplace");
@@ -547,9 +578,10 @@ async function setup({ args = [], cwd = process.cwd() } = {}) {
       const selected = await multiSelect({
         message: "Select agents to install:",
         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: "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: "GitHub Copilot",     value: "copilot", selected: options.agents.includes("copilot") }
         ]
       });
       options.agents = selected;
@@ -576,7 +608,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.");
+  if (!options.agents.length) throw new Error("No agents selected. Use --agents codex,claude,agy,copilot.");
 
   for (const agent of options.agents) {
     console.log(`◇ Setting up ${agent}...`);

package/package.json

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

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

@@ -0,0 +1,58 @@
+import fs from "node:fs";
+import path from "node:path";
+
+/**
+ * Copilot reads instructions from:
+ *   1. .github/copilot-instructions.md (repo-level)
+ *   2. AGENTS.md files (nearest in directory tree)
+ *
+ * Since ContextOS already syncs AGENTS.md through Ruler,
+ * this module writes a copilot-instructions.md that signals
+ * ContextOS integration and points Copilot at the ctx-mcp MCP server.
+ */
+
+const MARKER = "<!-- managed by ContextOS -->";
+
+function buildCopilotInstructions({ installRoot } = {}) {
+  return [
+    MARKER,
+    "# ContextOS Integration",
+    "",
+    "This project uses [ContextOS](https://github.com/khovan123/contextOS) for task-aware context injection.",
+    "",
+    "## MCP Server",
+    "",
+    "The `ctx-mcp` MCP server is configured in `.vscode/mcp.json`.",
+    "It provides semantic file search, skill discovery, and rule scoring for this workspace.",
+    "",
+    "## Rules",
+    "",
+    "Project rules are defined in `AGENTS.md` files managed by Ruler.",
+    "These rules are automatically injected into your prompt context.",
+    ""
+  ].join("\n");
+}
+
+export function copilotInstructionsPath(cwd = process.cwd()) {
+  return path.join(cwd, ".github", "copilot-instructions.md");
+}
+
+export function installCopilotHooks({ cwd = process.cwd(), installRoot } = {}) {
+  const instructionsPath = copilotInstructionsPath(cwd);
+  const dir = path.dirname(instructionsPath);
+  fs.mkdirSync(dir, { recursive: true });
+
+  // If the file exists and wasn't created by us, don't overwrite
+  if (fs.existsSync(instructionsPath)) {
+    const existing = fs.readFileSync(instructionsPath, "utf8");
+    if (!existing.includes(MARKER)) {
+      // Append our section
+      const content = existing.trimEnd() + "\n\n" + buildCopilotInstructions({ installRoot });
+      fs.writeFileSync(instructionsPath, content, "utf8");
+      return instructionsPath;
+    }
+  }
+
+  fs.writeFileSync(instructionsPath, buildCopilotInstructions({ installRoot }), "utf8");
+  return instructionsPath;
+}

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

@@ -0,0 +1,43 @@
+import fs from "node:fs";
+import path from "node:path";
+
+/**
+ * Copilot MCP configuration lives at .vscode/mcp.json (workspace-level).
+ * This is the standard location for VS Code / GitHub Copilot agent mode.
+ */
+
+function readJsonFile(filePath, fallback) {
+  if (!fs.existsSync(filePath)) return fallback;
+  const raw = fs.readFileSync(filePath, "utf8").trim();
+  if (!raw) return fallback;
+  try {
+    return JSON.parse(raw);
+  } catch {
+    console.warn(`[ctx] warning: corrupt JSON in ${filePath}, overwriting with defaults`);
+    return fallback;
+  }
+}
+
+export function copilotMcpConfigPath(cwd = process.cwd()) {
+  return path.join(cwd, ".vscode", "mcp.json");
+}
+
+export function buildCopilotMcpConfig(existingConfig, { installRoot } = {}) {
+  const config = existingConfig && typeof existingConfig === "object" ? structuredClone(existingConfig) : {};
+  if (!config.mcpServers || typeof config.mcpServers !== "object") config.mcpServers = {};
+  config.mcpServers["ctx-mcp"] = {
+    type: "stdio",
+    command: "node",
+    args: [path.join(installRoot, "plugins", "ctx", "mcp", "server.js")]
+  };
+  return config;
+}
+
+export function installCopilotMcp({ cwd = process.cwd(), configPath, installRoot } = {}) {
+  const mcpPath = configPath || copilotMcpConfigPath(cwd);
+  const existing = readJsonFile(mcpPath, {});
+  const next = buildCopilotMcpConfig(existing, { installRoot });
+  fs.mkdirSync(path.dirname(mcpPath), { recursive: true });
+  fs.writeFileSync(mcpPath, `${JSON.stringify(next, null, 2)}\n`, "utf8");
+  return mcpPath;
+}

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

@@ -7,7 +7,7 @@ import { execFileSync, spawn } from "node:child_process";
 
 import { defaultDataRoot } from "./workspace-data.js";
 
-const DEFAULT_AGENTS = ["codex", "claude", "antigravity"];
+const DEFAULT_AGENTS = ["codex", "claude", "antigravity", "copilot"];
 const CTX_MCP_NAME = "ctx-mcp";
 const CONTEXTOS_PROXY_MARKER = "/contextos/plugins/ctx/mcp/proxy.js";
 const MCP_SERVER_RELATIVE = path.join("plugins", "ctx", "mcp", "server.js");
@@ -15,7 +15,8 @@ const AGENT_ALIASES = new Map([
   ["agy", "antigravity"],
   ["antigravity", "antigravity"],
   ["codex", "codex"],
-  ["claude", "claude"]
+  ["claude", "claude"],
+  ["copilot", "copilot"]
 ]);
 
 function statusLine(label, value) {
@@ -508,6 +509,10 @@ export function verifySync({ cwd = process.cwd(), agents = DEFAULT_AGENTS } = {}
       path.join(cwd, ".gemini", "mcp.json"),
       ...antigravityMcpConfigPaths(),
       path.join(cwd, "AGENTS.md")
+    ],
+    copilot: [
+      path.join(cwd, ".vscode", "mcp.json"),
+      path.join(cwd, ".github", "copilot-instructions.md")
     ]
   };
 
@@ -526,6 +531,7 @@ function resolveStableMcpServerPath(rootDir) {
     path.join(codexRoot, MCP_SERVER_RELATIVE),
     path.join(dataRoot, "agents", "claude", "contextos", MCP_SERVER_RELATIVE),
     path.join(dataRoot, "agents", "agy", "contextos", MCP_SERVER_RELATIVE),
+    path.join(dataRoot, "agents", "copilot", "contextos", MCP_SERVER_RELATIVE),
     path.join(rootDir, MCP_SERVER_RELATIVE)
   ];
   for (const candidate of candidates) {
@@ -542,7 +548,7 @@ export async function syncRules({
   logger = console.log
 } = {}) {
   const options = parseSyncRulesArgs(args);
-  if (!options.rules) throw new Error("Usage: ctx sync --rules [--agents codex,claude,antigravity] [--dry-run] [--force]");
+  if (!options.rules) throw new Error("Usage: ctx sync --rules [--agents codex,claude,antigravity,copilot] [--dry-run] [--force]");
 
   logger("");
   const ruler = checkRulerInstalled({ run });
@@ -608,6 +614,23 @@ export async function syncRules({
     logger(statusLine("Syncing Antigravity MCP config...", antigravityMcp.servers.length ? `✓ ${antigravityMcp.servers.join(", ")}` : "none found"));
   }
 
+  let copilotMcp = { changed: false };
+  if (options.agents.includes("copilot")) {
+    // Copilot MCP is managed by copilot-mcp.js during install,
+    // but we verify it's still in place during sync.
+    const vscodeMcpPath = path.join(cwd, ".vscode", "mcp.json");
+    if (fs.existsSync(vscodeMcpPath)) {
+      try {
+        const content = JSON.parse(fs.readFileSync(vscodeMcpPath, "utf8"));
+        copilotMcp.changed = Boolean(content?.mcpServers?.[CTX_MCP_NAME]);
+        logger(statusLine("Verifying Copilot MCP config...", copilotMcp.changed ? "✓ ctx-mcp found" : "not configured"));
+      } catch {
+        logger(statusLine("Verifying Copilot MCP config...", "⚠ parse error"));
+      }
+    } else {
+      logger(statusLine("Verifying Copilot MCP config...", "not installed (run ctx install --agent copilot)"));
+    }
+  }
   logger("[ctx] Verifying sync...");
   const checks = options.dryRun ? options.agents.map((agent) => ({ agent, ok: true, filePath: "(dry-run)" })) : verifySync({ cwd, agents: options.agents });
   for (const check of checks) {

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

@@ -1,4 +1,5 @@
-const DEFAULT_AGENTS = ["codex", "claude", "agy"];
+// No agents pre-selected by default — user must choose explicitly
+const DEFAULT_AGENTS = [];
 
 export function parseSetupArgs(args = []) {
   const agentsFlag = args.indexOf("--agents");

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

@@ -5,14 +5,15 @@ import readline from "node:readline/promises";
 import { stdin as input, stdout as output } from "node:process";
 import { execFileSync, execSync, spawn } from "node:child_process";
 
-const DEFAULT_AGENTS = ["codex", "claude", "antigravity"];
+const DEFAULT_AGENTS = ["codex", "claude", "antigravity", "copilot"];
 const INSTALL_SH_URL = "https://raw.githubusercontent.com/runkids/skillshare/main/install.sh";
 const INSTALL_PS_URL = "https://raw.githubusercontent.com/runkids/skillshare/main/install.ps1";
 const AGENT_ALIASES = new Map([
   ["agy", "antigravity"],
   ["antigravity", "antigravity"],
   ["codex", "codex"],
-  ["claude", "claude"]
+  ["claude", "claude"],
+  ["copilot", "copilot"]
 ]);
 
 function statusLine(label, value) {
@@ -412,7 +413,10 @@ export async function syncSkills({
       logger("[ctx] No existing skills found.");
     }
 
-    run("skillshare", ["init"], { cwd, stdio: "pipe", dryRun: options.dryRun });
+    // --no-copy --no-git --no-skill --all-targets: fully non-interactive init.
+    // skillshare init is interactive by default; with stdin routed to NUL
+    // (deadlock prevention) the Go binary hangs waiting for terminal input.
+    run("skillshare", ["init", "--no-copy", "--no-git", "--no-skill", "--all-targets"], { cwd, stdio: "pipe", dryRun: options.dryRun });
     logger(statusLine("Initializing skillshare...", options.dryRun ? "dry-run" : "✓ initialized"));
 
     if (existing.length && !options.noCollect) {