@minhpnq1807/contextos 0.5.34 → 0.5.35

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 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.

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.34",
+  "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.34",
+  "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) {