@sdods/cli 0.19.0 → 0.20.0

package/dist/commands/agent.js

@@ -36,7 +36,7 @@ export function register(program) {
             .option('--run-id <id>', 'run id (heal), default last', 'last')
             .option('--diff <range>', 'git range (upgrade), e.g. main..HEAD')
             .option('--files <list>', 'feature files (review)', collect, [])
-            .option('--adapter <name>', 'claude (API key) | claude-code (logged-in Claude Code CLI) | codex (logged-in Codex CLI) | openai | ollama (a model on this machine) | fake; default: auto-detect')
+            .option('--adapter <name>', 'claude (API key) | claude-code (logged-in Claude Code CLI) | codex (logged-in Codex CLI) | copilot (logged-in GitHub Copilot CLI) | openai | ollama (a model on this machine) | fake; default: auto-detect')
             .option('--model <id>', 'model override')
             .option('--profile <name>', 'auto | full | small — how many tools and how much prompt the model is given')
             .option('--browser', 'attach the browser MCP server even under the small profile (which omits it)')
@@ -162,13 +162,13 @@ export function register(program) {
     const installAction = async (opts, cmd, forced) => {
         const ctx = createContext(cmd);
         const target = (forced ?? opts.for ?? 'all');
-        if (!['claude', 'codex', 'all'].includes(target)) {
+        if (!['claude', 'codex', 'copilot', 'all'].includes(target)) {
             throw new SdodsError('NOT_SUPPORTED', `Unknown target "${target}".`, {
-                hint: 'Use --for claude, --for codex or --for all.',
+                hint: 'Use --for claude, --for codex, --for copilot or --for all.',
                 exitCode: 2,
             });
         }
-        const { installCodingAgents } = await import('@sdods/agents');
+        const { installCodingAgents, findOnPath } = await import('@sdods/agents');
         const written = installCodingAgents(ctx.rootDir, {
             for: target,
             project: opts.project,
@@ -177,7 +177,11 @@ export function register(program) {
         });
         if (opts.mcp !== false) {
             const { execa } = await import('execa');
-            const clients = target === 'all' ? ['claude', 'codex'] : [target];
+            // `all` registers with Copilot only when it is installed: its config lives in the home
+            // directory, and writing one for someone who does not use Copilot would be clutter.
+            const clients = target === 'all'
+                ? ['claude', 'codex', ...(findOnPath('copilot') ? ['copilot'] : [])]
+                : [target];
             for (const client of clients) {
                 const args = ['mcp', 'install', client];
                 if (opts.project)
@@ -200,8 +204,8 @@ export function register(program) {
     };
     agent
         .command('install')
-        .description('Set up coding-agent CLIs: --for claude writes .claude/agents/sdods-*.md + CLAUDE.md, --for codex writes AGENTS.md; both get AGENT.md/SKILL.md and the MCP registration')
-        .option('--for <client>', 'claude | codex | all', 'all')
+        .description('Set up coding-agent CLIs: --for claude writes .claude/agents/sdods-*.md + CLAUDE.md, --for codex writes AGENTS.md, --for copilot writes .github/agents/sdods-*.agent.md + AGENTS.md; all get AGENT.md/SKILL.md and the MCP registration')
+        .option('--for <client>', 'claude | codex | copilot | all', 'all')
         .option('-p, --project <slug>')
         .option('-e, --env <name>')
         .option('--force', 'overwrite existing files')

package/dist/commands/doctor.js

@@ -173,6 +173,7 @@ function tokenMatrix(cliStatus, localLlm) {
     const has = (k) => Boolean(process.env[k]);
     const claudeOk = cliStatus.find((c) => c.name === 'cli:claude')?.ok ?? false;
     const codexOk = cliStatus.find((c) => c.name === 'cli:codex')?.ok ?? false;
+    const copilotOk = cliStatus.find((c) => c.name === 'cli:copilot')?.ok ?? false;
     const agentsGroup = [
         {
             name: 'ANTHROPIC_API_KEY',
@@ -192,6 +193,12 @@ function tokenMatrix(cliStatus, localLlm) {
             detail: 'adapter codex: uses your Codex login (ChatGPT account)',
             hint: '`npm i -g @openai/codex && codex login`',
         },
+        {
+            name: 'copilot CLI login',
+            present: copilotOk,
+            detail: 'adapter copilot: uses your GitHub Copilot subscription',
+            hint: '`npm i -g @github/copilot && copilot login` (or COPILOT_GITHUB_TOKEN)',
+        },
         {
             name: 'OPENAI_API_KEY (+OPENAI_BASE_URL)',
             present: has('OPENAI_API_KEY'),
@@ -296,11 +303,11 @@ async function localModelStatus() {
         return { name, ok: false, optional: true, detail: 'agents package unavailable' };
     }
 }
-/** `cli:claude` / `cli:codex` rows: installed + logged in. Missing CLIs are not failures. */
+/** `cli:claude` / `cli:codex` / `cli:copilot` rows: installed + logged in. Missing CLIs are not failures. */
 async function codingCliStatus() {
     const rows = [];
     try {
-        const { ClaudeCodeCliAdapter, CodexCliAdapter } = await import('@sdods/agents');
+        const { ClaudeCodeCliAdapter, CodexCliAdapter, CopilotCliAdapter } = await import('@sdods/agents');
         const c = ClaudeCodeCliAdapter.loginStatus();
         rows.push({
             name: 'cli:claude',
@@ -317,6 +324,15 @@ async function codingCliStatus() {
             detail: x.detail,
             fix: x.installed ? 'codex login' : 'npm i -g @openai/codex (optional)',
         });
+        const g = CopilotCliAdapter.loginStatus();
+        rows.push({
+            name: 'cli:copilot',
+            // Copilot cannot report its login without a prompt; installed counts until a run says otherwise
+            ok: g.installed && g.loggedIn !== false,
+            optional: true,
+            detail: g.detail,
+            fix: g.installed ? 'copilot login' : 'npm i -g @github/copilot (optional)',
+        });
     }
     catch {
         rows.push({
@@ -331,6 +347,12 @@ async function codingCliStatus() {
             optional: true,
             detail: 'agents package unavailable',
         });
+        rows.push({
+            name: 'cli:copilot',
+            ok: false,
+            optional: true,
+            detail: 'agents package unavailable',
+        });
     }
     return rows;
 }

package/dist/commands/mcp.js

@@ -81,14 +81,14 @@ export function register(program) {
     });
     mcp
         .command('install <client>')
-        .description('Register the SDODS MCP server with a client: claude | codex | cursor | vscode | windsurf | gemini (merges, never clobbers)')
+        .description('Register the SDODS MCP server with a client: claude | codex | copilot | cursor | vscode | windsurf | gemini (merges, never clobbers)')
         .option('-p, --project <slug>')
         .option('-e, --env <name>')
         .option('--caps <list>')
         .option('--http-url <url>', 'configure the HTTP transport instead of stdio')
         .option('--token-placeholder <text>', 'placeholder written for the bearer token')
         .option('--with-playwright', 'also register the raw upstream Playwright MCP server (ungoverned; the sdods server already wraps it as browser_*)')
-        .option('--file', 'always write the config file instead of calling `claude mcp add` / `codex mcp add`')
+        .option('--file', 'always write the config file instead of calling `claude` / `codex` / `copilot mcp add`')
         .option('--print', 'print the snippet instead of writing files')
         .action(async (client, opts, cmd) => {
         const ctx = createContext(cmd);
@@ -120,11 +120,11 @@ export function register(program) {
             return;
         }
         // Prefer the client's own CLI so its config format stays authoritative.
-        if (!opts.file && (client === 'claude' || client === 'codex')) {
+        if (!opts.file && (client === 'claude' || client === 'codex' || client === 'copilot')) {
             const done = await registerViaClientCli(client, o, ctx.rootDir);
             if (done) {
                 ok(`Registered the sdods MCP server with ${client} (${cliCommands(o)[client]})`);
-                if (o.withPlaywright === true && client === 'codex')
+                if (o.withPlaywright === true && client !== 'claude')
                     out(pc.dim('Also registered the bundled Playwright MCP server as "playwright".'));
                 return;
             }
@@ -135,7 +135,7 @@ export function register(program) {
             out(pc.dim(`Alternative: ${s.cli}`));
     });
 }
-/** `claude mcp add` (project scope) or `codex mcp add`; false when the CLI is unavailable. */
+/** `claude mcp add` (project scope), `codex mcp add` or `copilot mcp add` (user config); false when the CLI is unavailable. */
 async function registerViaClientCli(client, o, cwd) {
     const { execa } = await import('execa');
     // `npx sdods` resolves only when the cwd happens to sit inside a checkout that has the binary in
@@ -148,7 +148,7 @@ async function registerViaClientCli(client, o, cwd) {
         stdio.push('--env', o.env);
     if (o.caps)
         stdio.push('--caps', o.caps);
-    const run = async (args) => {
+    const run = async (args, name = 'sdods') => {
         try {
             await execa(client, args, { cwd, timeout: 30_000 });
             return true;
@@ -159,7 +159,7 @@ async function registerViaClientCli(client, o, cwd) {
                 return false;
             // already registered → remove and re-add so the args are current
             if (/already exists/i.test(msg)) {
-                await execa(client, ['mcp', 'remove', args[2] ?? 'sdods'], { cwd, reject: false });
+                await execa(client, ['mcp', 'remove', name], { cwd, reject: false });
                 await execa(client, args, { cwd, timeout: 30_000 });
                 return true;
             }
@@ -170,26 +170,39 @@ async function registerViaClientCli(client, o, cwd) {
     };
     // A remote server without credentials answers 401 to every call, so the token is part of the
     // registration. Neither form writes the secret: Claude Code expands ${SDODS_TOKEN} from the
-    // environment when it reads .mcp.json, and Codex reads the variable named by
-    // --bearer-token-env-var at connect time.
-    const addArgs = client === 'claude'
+    // environment when it reads .mcp.json, Copilot keeps the ${SDODS_TOKEN} reference as written,
+    // and Codex reads the variable named by --bearer-token-env-var at connect time.
+    const addArgs = client === 'copilot'
         ? o.httpUrl
             ? [
                 'mcp',
                 'add',
-                '-s',
-                'project',
                 '--transport',
                 'http',
-                'sdods',
-                o.httpUrl,
                 '--header',
                 'Authorization: Bearer ${SDODS_TOKEN}',
+                'sdods',
+                o.httpUrl,
             ]
-            : ['mcp', 'add', '-s', 'project', 'sdods', '--', ...stdio]
-        : o.httpUrl
-            ? ['mcp', 'add', 'sdods', '--url', o.httpUrl, '--bearer-token-env-var', 'SDODS_TOKEN']
-            : ['mcp', 'add', 'sdods', '--', ...stdio];
+            : ['mcp', 'add', 'sdods', '--', ...stdio]
+        : client === 'claude'
+            ? o.httpUrl
+                ? [
+                    'mcp',
+                    'add',
+                    '-s',
+                    'project',
+                    '--transport',
+                    'http',
+                    'sdods',
+                    o.httpUrl,
+                    '--header',
+                    'Authorization: Bearer ${SDODS_TOKEN}',
+                ]
+                : ['mcp', 'add', '-s', 'project', 'sdods', '--', ...stdio]
+            : o.httpUrl
+                ? ['mcp', 'add', 'sdods', '--url', o.httpUrl, '--bearer-token-env-var', 'SDODS_TOKEN']
+                : ['mcp', 'add', 'sdods', '--', ...stdio];
     const ok1 = await run(addArgs);
     if (!ok1)
         return false;
@@ -208,7 +221,7 @@ async function registerViaClientCli(client, o, cwd) {
                 '--headless',
             ]
             : ['mcp', 'add', 'playwright', '--', 'npx', 'playwright', 'mcp', '--headless'];
-        await run(pw).catch(() => false);
+        await run(pw, 'playwright').catch(() => false);
     }
     return true;
 }

package/dist/commands/record.js

@@ -132,7 +132,7 @@ export function register(program) {
         .description('Ask the generator agent to turn a recorded spec into a feature + steps proposal (reviewed, never auto-applied)')
         .option('-p, --project <slug>', 'project slug (default: inferred from the spec path)')
         .option('--dry-run', 'print the prompt and plan without calling a model')
-        .option('--adapter <name>', 'claude | claude-code | codex | openai | ollama | fake; default: auto-detect')
+        .option('--adapter <name>', 'claude | claude-code | codex | copilot | openai | ollama | fake; default: auto-detect')
         .option('--model <id>', 'model override')
         .option('--profile <name>', 'auto | full | small — how much of the platform the model is shown')
         .action(async (spec, opts, cmd) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sdods/cli",
-  "version": "0.19.0",
+  "version": "0.20.0",
   "description": "SDODS command line: run, record, analyze, agents, MCP server, scheduler and the web server.",
   "license": "Apache-2.0",
   "funding": "https://sdods.com/sponsor/",
@@ -26,8 +26,8 @@
     "node": ">=22"
   },
   "dependencies": {
-    "@sdods/contracts": "0.19.0",
-    "@sdods/core": "0.19.0",
+    "@sdods/contracts": "0.20.0",
+    "@sdods/core": "0.20.0",
     "commander": "^15.0.0",
     "execa": "^10.2.1",
     "picocolors": "^1.1.1",
@@ -36,12 +36,12 @@
     "zod": "^4.6.7",
     "@playwright/test": "^1.64.0",
     "playwright-core": "^1.64.0",
-    "@sdods/integrations": "0.19.0",
-    "@sdods/mcp": "0.19.0",
-    "@sdods/agents": "0.19.0",
-    "@sdods/db": "0.19.0",
+    "@sdods/integrations": "0.20.0",
+    "@sdods/mcp": "0.20.0",
+    "@sdods/agents": "0.20.0",
+    "@sdods/db": "0.20.0",
     "csv-parse": "^7.0.3",
-    "@sdods/server": "0.19.0"
+    "@sdods/server": "0.20.0"
   },
   "homepage": "https://sdods.com",
   "bugs": {