@enfyra/mcp-server 0.0.122 → 0.1.0

package/README.md

@@ -1,6 +1,6 @@
 # Enfyra MCP Server
 
-Manage Enfyra instances from MCP-compatible coding tools such as **Codex**, **Claude Code**, **Cursor**, MCP Inspector, and other STDIO MCP hosts.
+Manage Enfyra instances from MCP-compatible coding tools such as **Codex**, **Claude Code**, **Cursor**, **VS Code / GitHub Copilot**, **Google Antigravity**, MCP Inspector, and other STDIO MCP hosts.
 
 This package is the MCP bridge only. Assistant rules, schema behavior, dynamic script guidance, and examples are served through the MCP server itself from `src/lib/mcp-instructions.js`, `src/lib/mcp-examples.js`, and tool descriptions in `src/mcp-server-entry.mjs`.
 
@@ -12,7 +12,7 @@ From your project root:
 npx @enfyra/mcp-server config
 ```
 
-The config command writes project config for Codex, Claude Code, and Cursor. It preserves other MCP servers and replaces only the `enfyra` entry.
+The config command writes project config for Codex, Claude Code, Cursor, VS Code / GitHub Copilot, and Google Antigravity. It preserves other MCP servers and replaces only the `enfyra` entry.
 
 Interactive setup asks for your Enfyra app/admin URL, then guides you to the token page when needed and asks for `ENFYRA_API_TOKEN`.
 
@@ -25,6 +25,8 @@ npx @enfyra/mcp-server config --yes \
 # One or more clients
 npx @enfyra/mcp-server config --codex
 npx @enfyra/mcp-server config --cursor --claude-code
+npx @enfyra/mcp-server config --vscode
+npx @enfyra/mcp-server config --antigravity
 ```
 
 Equivalent in this repo:
@@ -40,7 +42,9 @@ yarn mcp:config
 | Codex | `npx @enfyra/mcp-server config --codex` | `.codex/config.toml` |
 | Claude Code | `npx @enfyra/mcp-server config --claude-code` | `.mcp.json` |
 | Cursor | `npx @enfyra/mcp-server config --cursor` | `.cursor/mcp.json` |
-| MCP Inspector / other hosts | Paste the shared STDIO config below | Host-specific `mcpServers` config |
+| VS Code / GitHub Copilot | `npx @enfyra/mcp-server config --vscode` | `.vscode/mcp.json` |
+| Google Antigravity | `npx @enfyra/mcp-server config --antigravity` | `.agents/mcp_config.json` |
+| MCP Inspector / other project-scoped hosts | Paste the shared STDIO config below | Host-specific project config |
 
 <details>
 <summary><strong>Codex setup</strong></summary>
@@ -108,10 +112,71 @@ Official reference: [Cursor MCP](https://cursor.com/docs/context/mcp).
 
 </details>
 
+<details>
+<summary><strong>VS Code / GitHub Copilot setup</strong></summary>
+
+```bash
+npx @enfyra/mcp-server config --vscode
+```
+
+VS Code workspace config is written to `.vscode/mcp.json`:
+
+```json
+{
+  "servers": {
+    "enfyra": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@enfyra/mcp-server"],
+      "env": {
+        "ENFYRA_API_URL": "http://localhost:3000/api",
+        "ENFYRA_API_TOKEN": "efy_pat_your-token"
+      }
+    }
+  }
+}
+```
+
+Use the VS Code command `MCP: List Servers` to inspect or start the server after setup. This is a workspace config, so it stays tied to the current project.
+
+Official references: [VS Code MCP servers](https://code.visualstudio.com/docs/copilot/chat/mcp-servers) and [VS Code MCP configuration](https://code.visualstudio.com/docs/agents/reference/mcp-configuration).
+
+</details>
+
+<details>
+<summary><strong>Google Antigravity setup</strong></summary>
+
+```bash
+npx @enfyra/mcp-server config --antigravity
+```
+
+Antigravity project config is written to `.agents/mcp_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "enfyra": {
+      "command": "npx",
+      "args": ["-y", "@enfyra/mcp-server"],
+      "env": {
+        "ENFYRA_API_URL": "http://localhost:3000/api",
+        "ENFYRA_API_TOKEN": "efy_pat_your-token"
+      }
+    }
+  }
+}
+```
+
+Antigravity also documents a shared user config at `~/.gemini/config/mcp_config.json`; this helper intentionally writes the project-local `.agents/mcp_config.json` file so Enfyra URL and token stay scoped to the current workspace.
+
+Official reference: [Antigravity MCP](https://antigravity.google/docs/mcp).
+
+</details>
+
 <details>
 <summary><strong>Other MCP hosts and MCP Inspector</strong></summary>
 
-Use the shared STDIO config with any host that accepts an `mcpServers` JSON block:
+Use the shared STDIO config with any project-scoped host that accepts an `mcpServers` JSON block:
 
 ```json
 {
@@ -145,11 +210,12 @@ npx @enfyra/mcp-server config [options]
 | `--app-url` | Set the Enfyra app/admin URL |
 | `--api-token`, `-t` | Set `ENFYRA_API_TOKEN` |
 | `--yes` | Non-interactive mode for CI/scripts |
-| `--global` | Write global/user config instead of project config |
 | `--reconfig` | Prompt for target clients again and replace the existing `enfyra` entry |
 | `--codex` | Write Codex config |
 | `--claude-code`, `--claude` | Write Claude Code config |
 | `--cursor` | Write Cursor config |
+| `--vscode`, `--copilot` | Write VS Code / GitHub Copilot config |
+| `--antigravity` | Write Google Antigravity config |
 | `-h`, `--help` | Show CLI help |
 
 Without a target flag, interactive mode asks which client to configure. Non-interactive mode defaults to all supported clients.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@enfyra/mcp-server",
-  "version": "0.0.122",
+  "version": "0.1.0",
   "description": "MCP server for Enfyra - manage Enfyra instances from MCP-compatible coding tools",
   "type": "module",
   "license": "MIT",

package/src/index.mjs

@@ -11,15 +11,17 @@ if (args[0] === '--help' || args[0] === '-h' || args[0] === 'help') {
 
 Usage:
   npx @enfyra/mcp-server                 Start the MCP stdio server
-  npx @enfyra/mcp-server config [flags]  Write local MCP host config
+  npx @enfyra/mcp-server config [flags]  Write project-local MCP host config
 
 Common config flags:
-  --codex             Write ~/.codex/config.toml
+  --codex             Write ./.codex/config.toml
   --claude-code       Write ./.mcp.json
   --cursor            Write ./.cursor/mcp.json
+  --vscode            Write ./.vscode/mcp.json
+  --antigravity       Write ./.agents/mcp_config.json
   --reconfig          Prompt for host and credentials again, replacing the enfyra entry
   --yes               Non-interactive
-  -a, --api-url       ENFYRA_API_URL
+  --app-url           ENFYRA_APP_URL
   -t, --api-token     ENFYRA_API_TOKEN
   -h, --help          Show config help
 

package/src/lib/config-local.mjs

@@ -3,7 +3,6 @@ import { createInterface } from 'node:readline/promises';
 import { emitKeypressEvents } from 'node:readline';
 import { stdin as input, stdout as output, cwd } from 'node:process';
 import { dirname, join } from 'node:path';
-import { homedir } from 'node:os';
 
 const SERVER_KEY = 'enfyra';
 const forceColor = process.env.FORCE_COLOR != null && process.env.FORCE_COLOR !== '0';
@@ -36,6 +35,16 @@ const clients = {
     path: './.cursor/mcp.json',
     color: style.cyan,
   },
+  vscode: {
+    label: 'VS Code / Copilot',
+    path: './.vscode/mcp.json',
+    color: style.blue,
+  },
+  antigravity: {
+    label: 'Antigravity',
+    path: './.agents/mcp_config.json',
+    color: style.yellow,
+  },
 };
 
 function statusIcon(kind) {
@@ -55,7 +64,7 @@ function exitCancelled() {
 
 function printHelp() {
   console.log(`${style.bold('Enfyra MCP config')}
-${style.dim('Write local MCP client config for Enfyra.')}
+${style.dim('Write project-local MCP client config for Enfyra.')}
 
 ${style.bold('Usage')}
   npx @enfyra/mcp-server config [options]
@@ -64,12 +73,12 @@ ${style.bold('Supported clients')}
   Codex        ./.codex/config.toml
   Claude Code  ./.mcp.json
   Cursor       ./.cursor/mcp.json
-  Other MCP hosts can use the shared stdio JSON from the README.
+  VS Code      ./.vscode/mcp.json
+  Antigravity  ./.agents/mcp_config.json
 
 ${style.bold('Options')}
   --app-url <url>          Enfyra app/admin URL, for example https://demo.enfyra.io
   --api-token, -t <secret>  ENFYRA_API_TOKEN
-  --global                Write global/user config for selected clients instead of project config
   --reconfig              Always choose target again in interactive mode and replace the old enfyra config for that target
   --yes                   Non-interactive: no prompts (CI / scripts); use CLI, env, existing file, then defaults
 
@@ -79,20 +88,23 @@ ${style.bold('Client selection')}
   --claude-code, --claude, --claude-only   Only ./.mcp.json (Claude Code project scope)
   --cursor, --cursor-only                  Only ./.cursor/mcp.json (Cursor)
   --codex, --codex-only                    Only ./.codex/config.toml (Codex project scope)
+  --vscode, --copilot, --vscode-only       Only ./.vscode/mcp.json (VS Code / Copilot)
+  --antigravity, --antigravity-only        Only ./.agents/mcp_config.json (Antigravity)
   Passing multiple target flags writes each selected target.
 
   -h, --help              Show this help
 
 ${style.bold('Interactive mode')}
-  Choose Codex, Claude Code, Cursor, or all clients; then enter ENFYRA_APP_URL and ENFYRA_API_TOKEN.
+  Choose Codex, Claude Code, Cursor, VS Code, Antigravity, or all clients; then enter ENFYRA_APP_URL and ENFYRA_API_TOKEN.
   Existing Enfyra config and environment variables are used as defaults. Re-run anytime to update.
 
 ${style.bold('Examples')}
   npx @enfyra/mcp-server config
   npx @enfyra/mcp-server config --yes
   npx @enfyra/mcp-server config --codex --cursor
+  npx @enfyra/mcp-server config --vscode
+  npx @enfyra/mcp-server config --antigravity
   npx @enfyra/mcp-server config --claude-code
-  npx @enfyra/mcp-server config --global --codex
   npx @enfyra/mcp-server config --reconfig
   npx @enfyra/mcp-server config --app-url http://localhost:3000 -t 'efy_pat_...'
   ENFYRA_APP_URL=https://demo.enfyra.io ENFYRA_API_TOKEN=efy_pat_... npx @enfyra/mcp-server config --yes
@@ -109,11 +121,14 @@ function parseArgs(argv) {
     help: false,
     yes: false,
     reconfig: false,
-    global: false,
+    vscode: true,
+    antigravity: true,
   };
   let pickClaude = false;
   let pickCursor = false;
   let pickCodex = false;
+  let pickVscode = false;
+  let pickAntigravity = false;
   for (let i = 0; i < argv.length; i += 1) {
     const a = argv[i];
     const next = () => {
@@ -126,7 +141,6 @@ function parseArgs(argv) {
     else if (a === 'help') out.help = true;
     else if (a === '--yes') out.yes = true;
     else if (a === '--reconfig') out.reconfig = true;
-    else if (a === '--global') out.global = true;
     else if (a === '--app-url') out.appUrl = next();
     else if (a === '--api-url' || a === '-a') {
       throw new Error(`${a} is no longer supported for setup; use --app-url instead`);
@@ -138,13 +152,17 @@ function parseArgs(argv) {
     else if (a === '--claude-only' || a === '--claude-code' || a === '--claude') pickClaude = true;
     else if (a === '--cursor-only' || a === '--cursor') pickCursor = true;
     else if (a === '--codex-only' || a === '--codex') pickCodex = true;
+    else if (a === '--vscode-only' || a === '--vscode' || a === '--copilot') pickVscode = true;
+    else if (a === '--antigravity-only' || a === '--antigravity') pickAntigravity = true;
     else throw new Error(`Unknown argument: ${a}`);
   }
-  out.targetExplicit = pickClaude || pickCursor || pickCodex;
+  out.targetExplicit = pickClaude || pickCursor || pickCodex || pickVscode || pickAntigravity;
   if (out.targetExplicit) {
     out.claude = pickClaude;
     out.cursor = pickCursor;
     out.codex = pickCodex;
+    out.vscode = pickVscode;
+    out.antigravity = pickAntigravity;
   }
   return out;
 }
@@ -193,9 +211,7 @@ async function mergeMcpFile(absPath, serverEntry) {
   try {
     const raw = await readFile(absPath, 'utf8');
     const parsed = JSON.parse(raw);
-    if (parsed && typeof parsed === 'object' && parsed.mcpServers && typeof parsed.mcpServers === 'object') {
-      data.mcpServers = { ...parsed.mcpServers };
-    } else if (parsed && typeof parsed === 'object') {
+    if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
       data = { ...parsed, mcpServers: parsed.mcpServers && typeof parsed.mcpServers === 'object' ? { ...parsed.mcpServers } : {} };
     }
   } catch (e) {
@@ -207,6 +223,31 @@ async function mergeMcpFile(absPath, serverEntry) {
   await writeFile(absPath, `${JSON.stringify(data, null, 2)}\n`, 'utf8');
 }
 
+async function mergeVscodeMcpFile(absPath, serverEntry) {
+  let data = { servers: {} };
+  try {
+    const raw = await readFile(absPath, 'utf8');
+    const parsed = JSON.parse(raw);
+    if (parsed && typeof parsed === 'object') {
+      data = {
+        ...parsed,
+        servers: parsed.servers && typeof parsed.servers === 'object' ? { ...parsed.servers } : {},
+      };
+    }
+  } catch (e) {
+    if (e.code !== 'ENOENT') throw e;
+  }
+  data.servers = {
+    ...data.servers,
+    [SERVER_KEY]: {
+      type: 'stdio',
+      ...serverEntry,
+    },
+  };
+  await mkdir(dirname(absPath), { recursive: true });
+  await writeFile(absPath, `${JSON.stringify(data, null, 2)}\n`, 'utf8');
+}
+
 function tomlString(value) {
   return JSON.stringify(String(value ?? ''));
 }
@@ -285,50 +326,69 @@ async function readCodexEnfyraEnv(absPath) {
   return null;
 }
 
-function getCodexConfigPath(root, globalScope) {
-  return globalScope ? join(homedir(), '.codex', 'config.toml') : join(root, '.codex', 'config.toml');
+function getCodexConfigPath(root) {
+  return join(root, '.codex', 'config.toml');
+}
+
+function getClaudeConfigPath(root) {
+  return join(root, '.mcp.json');
+}
+
+function getCursorConfigPath(root) {
+  return join(root, '.cursor', 'mcp.json');
 }
 
-function getClaudeConfigPath(root, globalScope) {
-  return globalScope ? join(homedir(), '.mcp.json') : join(root, '.mcp.json');
+function getVscodeConfigPath(root) {
+  return join(root, '.vscode', 'mcp.json');
 }
 
-function getCursorConfigPath(root, globalScope) {
-  return globalScope ? join(homedir(), '.cursor', 'mcp.json') : join(root, '.cursor', 'mcp.json');
+function getAntigravityConfigPath(root) {
+  return join(root, '.agents', 'mcp_config.json');
 }
 
-function getClientPath(client, root, globalScope) {
-  if (client === 'claude') return getClaudeConfigPath(root, globalScope);
-  if (client === 'cursor') return getCursorConfigPath(root, globalScope);
-  if (client === 'codex') return getCodexConfigPath(root, globalScope);
+function getClientPath(client, root) {
+  if (client === 'claude') return getClaudeConfigPath(root);
+  if (client === 'cursor') return getCursorConfigPath(root);
+  if (client === 'codex') return getCodexConfigPath(root);
+  if (client === 'vscode') return getVscodeConfigPath(root);
+  if (client === 'antigravity') return getAntigravityConfigPath(root);
   throw new Error(`Unknown MCP client: ${client}`);
 }
 
-async function loadExistingEnfyraEnv(root, readClaude, readCursor, readCodex, globalScope) {
+async function readMcpServerEnv(absPath, serverRootKey) {
+  try {
+    const raw = await readFile(absPath, 'utf8');
+    const j = JSON.parse(raw);
+    const e = j?.[serverRootKey]?.[SERVER_KEY]?.env;
+    if (e && typeof e === 'object' && (e.ENFYRA_API_URL || e.ENFYRA_API_TOKEN)) {
+      return {
+        apiUrl: typeof e.ENFYRA_API_URL === 'string' ? e.ENFYRA_API_URL : '',
+        apiToken: typeof e.ENFYRA_API_TOKEN === 'string' ? e.ENFYRA_API_TOKEN : '',
+      };
+    }
+  } catch {
+    /* */
+  }
+  return null;
+}
+
+async function loadExistingEnfyraEnv(root, readClaude, readCursor, readCodex, readVscode, readAntigravity) {
   const paths = [];
-  if (readClaude) paths.push(getClaudeConfigPath(root, globalScope));
-  if (readCursor) paths.push(getCursorConfigPath(root, globalScope));
-  if (!globalScope && !readClaude && readCursor) paths.push(join(root, '.mcp.json'));
+  if (readClaude) paths.push({ path: getClaudeConfigPath(root), rootKey: 'mcpServers' });
+  if (readCursor) paths.push({ path: getCursorConfigPath(root), rootKey: 'mcpServers' });
+  if (!readClaude && readCursor) paths.push({ path: getClaudeConfigPath(root), rootKey: 'mcpServers' });
+  if (readVscode) paths.push({ path: getVscodeConfigPath(root), rootKey: 'servers' });
+  if (readAntigravity) paths.push({ path: getAntigravityConfigPath(root), rootKey: 'mcpServers' });
   const seen = new Set();
-  for (const p of paths) {
-    if (seen.has(p)) continue;
-    seen.add(p);
-    try {
-      const raw = await readFile(p, 'utf8');
-      const j = JSON.parse(raw);
-      const e = j?.mcpServers?.[SERVER_KEY]?.env;
-      if (e && typeof e === 'object' && (e.ENFYRA_API_URL || e.ENFYRA_API_TOKEN)) {
-        return {
-          apiUrl: typeof e.ENFYRA_API_URL === 'string' ? e.ENFYRA_API_URL : '',
-          apiToken: typeof e.ENFYRA_API_TOKEN === 'string' ? e.ENFYRA_API_TOKEN : '',
-        };
-      }
-    } catch {
-      /* */
-    }
+  for (const entry of paths) {
+    const key = `${entry.rootKey}:${entry.path}`;
+    if (seen.has(key)) continue;
+    seen.add(key);
+    const env = await readMcpServerEnv(entry.path, entry.rootKey);
+    if (env) return env;
   }
   if (readCodex) {
-    const codex = await readCodexEnfyraEnv(getCodexConfigPath(root, globalScope));
+    const codex = await readCodexEnfyraEnv(getCodexConfigPath(root));
     if (codex) return codex;
   }
   return { apiUrl: '', apiToken: '' };
@@ -338,23 +398,31 @@ async function promptTargetChoice() {
   const choices = [
     {
       client: 'codex',
-      value: { claude: false, cursor: false, codex: true },
+      value: { claude: false, cursor: false, codex: true, vscode: false, antigravity: false },
     },
     {
       client: 'claude',
-      value: { claude: true, cursor: false, codex: false },
+      value: { claude: true, cursor: false, codex: false, vscode: false, antigravity: false },
     },
     {
       client: 'cursor',
-      value: { claude: false, cursor: true, codex: false },
+      value: { claude: false, cursor: true, codex: false, vscode: false, antigravity: false },
+    },
+    {
+      client: 'vscode',
+      value: { claude: false, cursor: false, codex: false, vscode: true, antigravity: false },
+    },
+    {
+      client: 'antigravity',
+      value: { claude: false, cursor: false, codex: false, vscode: false, antigravity: true },
     },
     {
       client: 'all',
-      value: { claude: true, cursor: true, codex: true },
+      value: { claude: true, cursor: true, codex: true, vscode: true, antigravity: true },
     },
   ];
   if (input.setRawMode && output.isTTY) {
-    return promptTargetSelect(choices, 3);
+    return promptTargetSelect(choices, 5);
   }
 
   const rl = createInterface({ input, output });
@@ -363,23 +431,31 @@ async function promptTargetChoice() {
       + '  [1] Codex        ./.codex/config.toml\n'
       + '  [2] Claude Code  ./.mcp.json\n'
       + '  [3] Cursor       ./.cursor/mcp.json\n'
-      + '  [4] All [default]\n'
-      + 'Choice [4]: ',
+      + '  [4] VS Code      ./.vscode/mcp.json\n'
+      + '  [5] Antigravity  ./.agents/mcp_config.json\n'
+      + '  [6] All [default]\n'
+      + 'Choice [6]: ',
   )).trim().toLowerCase();
   await rl.close();
-  if (line === '' || line === '4' || line === 'all' || line === 'a') {
-    return { claude: true, cursor: true, codex: true };
+  if (line === '' || line === '6' || line === 'all' || line === 'a') {
+    return { claude: true, cursor: true, codex: true, vscode: true, antigravity: true };
   }
   if (line === '1' || line === 'codex' || line === 'x') {
-    return { claude: false, cursor: false, codex: true };
+    return { claude: false, cursor: false, codex: true, vscode: false, antigravity: false };
   }
   if (line === '2' || line === 'claude' || line === 'claude-code') {
-    return { claude: true, cursor: false, codex: false };
+    return { claude: true, cursor: false, codex: false, vscode: false, antigravity: false };
   }
   if (line === '3' || line === 'cursor' || line === 'u') {
-    return { claude: false, cursor: true, codex: false };
+    return { claude: false, cursor: true, codex: false, vscode: false, antigravity: false };
+  }
+  if (line === '4' || line === 'vscode' || line === 'vs-code' || line === 'copilot') {
+    return { claude: false, cursor: false, codex: false, vscode: true, antigravity: false };
+  }
+  if (line === '5' || line === 'antigravity') {
+    return { claude: false, cursor: false, codex: false, vscode: false, antigravity: true };
   }
-  return { claude: true, cursor: true, codex: true };
+  return { claude: true, cursor: true, codex: true, vscode: true, antigravity: true };
 }
 
 async function promptTargetSelect(choices, initialIndex = 0) {
@@ -392,7 +468,7 @@ async function promptTargetSelect(choices, initialIndex = 0) {
     if (choice.client === 'all') {
       const label = active ? style.bold(style.underline('All supported clients')) : 'All supported clients';
       const paddedLabel = label + ' '.repeat(22 - 'All supported clients'.length);
-      const hint = active ? style.cyan('Codex + Claude Code + Cursor') : style.dim('Codex + Claude Code + Cursor');
+      const hint = active ? style.cyan('Codex + Claude Code + Cursor + VS Code + Antigravity') : style.dim('Codex + Claude Code + Cursor + VS Code + Antigravity');
       return `${accent} ${indicator} ${paddedLabel} ${hint}`;
     }
 
@@ -545,14 +621,18 @@ export async function runLocalConfig(argv) {
   let writeClaude = opts.claude;
   let writeCursor = opts.cursor;
   let writeCodex = opts.codex;
+  let writeVscode = opts.vscode;
+  let writeAntigravity = opts.antigravity;
   if (usePrompt && (!opts.targetExplicit || opts.reconfig)) {
     const t = await promptTargetChoice();
     writeClaude = t.claude;
     writeCursor = t.cursor;
     writeCodex = t.codex;
+    writeVscode = t.vscode;
+    writeAntigravity = t.antigravity;
   }
 
-  const existing = await loadExistingEnfyraEnv(root, writeClaude, writeCursor, writeCodex, opts.global);
+  const existing = await loadExistingEnfyraEnv(root, writeClaude, writeCursor, writeCodex, writeVscode, writeAntigravity);
 
   let apiUrl;
   let apiToken;
@@ -578,23 +658,32 @@ export async function runLocalConfig(argv) {
   const written = [];
 
   if (writeCodex) {
-    const p = getClientPath('codex', root, opts.global);
+    const p = getClientPath('codex', root);
     await mergeCodexConfig(p, apiUrl, apiToken);
     written.push({ client: 'codex', path: p });
   }
   if (writeClaude) {
-    const p = getClientPath('claude', root, opts.global);
+    const p = getClientPath('claude', root);
     await mergeMcpFile(p, serverEntry);
     written.push({ client: 'claude', path: p });
   }
   if (writeCursor) {
-    const p = getClientPath('cursor', root, opts.global);
+    const p = getClientPath('cursor', root);
     await mergeMcpFile(p, serverEntry);
     written.push({ client: 'cursor', path: p });
   }
+  if (writeVscode) {
+    const p = getClientPath('vscode', root);
+    await mergeVscodeMcpFile(p, serverEntry);
+    written.push({ client: 'vscode', path: p });
+  }
+  if (writeAntigravity) {
+    const p = getClientPath('antigravity', root);
+    await mergeMcpFile(p, serverEntry);
+    written.push({ client: 'antigravity', path: p });
+  }
 
-  const scopeLabel = opts.global ? 'global/user' : 'project';
-  console.log(`${statusIcon('success')} ${style.bold(style.green('Enfyra MCP config updated'))} ${style.dim(`(${scopeLabel})`)}\n`);
+  console.log(`${statusIcon('success')} ${style.bold(style.green('Enfyra MCP config updated'))} ${style.dim('(project)')}\n`);
   for (const entry of written) {
     const meta = clients[entry.client];
     console.log(`  ${style.cyan('•')} ${style.bold(meta.color(meta.label))}`);
@@ -612,6 +701,12 @@ export async function runLocalConfig(argv) {
   if (selectedClients.has('cursor')) {
     console.log('  - Cursor: restart Cursor or reload MCP, then confirm the server under Settings -> MCP.');
   }
+  if (selectedClients.has('vscode')) {
+    console.log('  - VS Code / Copilot: run MCP: List Servers or reload the workspace, then start the Enfyra server if prompted.');
+  }
+  if (selectedClients.has('antigravity')) {
+    console.log('  - Antigravity: reopen the workspace or reload MCP servers so ./.agents/mcp_config.json is picked up.');
+  }
   console.log('  - Re-run this command anytime to update the same Enfyra entries.');
   if (!apiToken) {
     console.log(`\n${statusIcon('warn')} ${style.yellow('ENFYRA_API_TOKEN is empty; tools will not authenticate until it is set.')}`);

package/src/lib/mcp-examples.js

@@ -1550,7 +1550,7 @@ ensure_page_extension({
   name: "ReportsPage",
   description: "Reports dashboard",
   menuId: "<created-menu-id>",
-  code: "<template><section class=\\"min-h-full w-full space-y-4\\"><div class=\\"grid gap-4 md:grid-cols-2 xl:grid-cols-3\\"><article class=\\"eapp-surface-card p-4\\"><div class=\\"flex items-start justify-between gap-3\\"><div><p class=\\"text-sm font-medium eapp-text-tertiary\\">Total</p><p class=\\"mt-2 text-2xl font-semibold eapp-text-primary\\">0</p></div><span class=\\"eapp-primary-soft eapp-radius-control p-2\\"><span class=\\"eapp-primary-text\\">◆</span></span></div><div class=\\"mt-3 h-1.5 overflow-hidden eapp-radius-pill eapp-surface-muted\\"><div class=\\"eapp-primary-solid h-full w-1/2\\"></div></div></article><article class=\\"eapp-primary-surface eapp-radius-panel border p-4\\"><p class=\\"text-sm font-semibold eapp-text-primary\\">Selected report</p><p class=\\"mt-1 text-sm eapp-text-tertiary\\">Only selected/current identity blocks use identity surface.</p></article></div></section></template><script setup>const { registerPageHeader } = usePageHeaderRegistry(); const { register: registerHeaderActions } = useHeaderActionRegistry(); registerPageHeader({ title: 'Reports', description: 'Operational report overview.', leadingIcon: 'lucide:bar-chart-3', gradient: 'none', variant: 'minimal' }); registerHeaderActions([{ id: 'refresh-reports', label: 'Refresh', icon: 'lucide:refresh-cw', color: 'neutral', variant: 'outline', onClick: () => {}, order: 80 }])</script>",
+  code: "<template><section class=\\"min-h-full w-full space-y-4\\"><div class=\\"grid gap-4 md:grid-cols-2 xl:grid-cols-3\\"><article class=\\"eapp-surface-card p-4\\"><div class=\\"flex items-start justify-between gap-3\\"><div><p class=\\"text-sm font-medium eapp-text-tertiary\\">Total</p><p class=\\"mt-2 text-2xl font-semibold eapp-text-primary\\">0</p></div><span class=\\"eapp-primary-soft eapp-icon-tile\\"><span class=\\"eapp-primary-text\\">◆</span></span></div><div class=\\"mt-3 h-1.5 overflow-hidden eapp-radius-pill eapp-surface-muted\\"><div class=\\"eapp-primary-solid h-full w-1/2\\"></div></div></article><article class=\\"eapp-primary-surface eapp-radius-panel border p-4\\"><p class=\\"text-sm font-semibold eapp-text-primary\\">Selected report</p><p class=\\"mt-1 text-sm eapp-text-tertiary\\">Only selected/current identity blocks use identity surface.</p></article></div></section></template><script setup>const { registerPageHeader } = usePageHeaderRegistry(); const { register: registerHeaderActions } = useHeaderActionRegistry(); registerPageHeader({ title: 'Reports', description: 'Operational report overview.', leadingIcon: 'lucide:bar-chart-3', gradient: 'none', variant: 'minimal' }); registerHeaderActions([{ id: 'refresh-reports', label: 'Refresh', icon: 'lucide:refresh-cw', color: 'neutral', variant: 'outline', onClick: () => {}, order: 80 }])</script>",
   isEnabled: true
 })`,
         notes: [
@@ -1566,15 +1566,15 @@ ensure_page_extension({
           'Page extensions should be full-bleed by default and responsive from the first version.',
           'The extension root is already inside Enfyra admin page main; do not add root-level page padding.',
           'Use eApp theme class tokens for panels, rows, badges, borders, controls, radius, and text. Generated extension templates should prefer eapp-surface-*, eapp-text-*, eapp-radius-*, eapp-divide-y, and eapp-primary-* over raw CSS variable utilities.',
-          'Treat primary color as runtime-configurable by the app color picker. For Nuxt UI components, choose color="primary" by semantic intent. For custom extension UI, decide whether each element is neutral surface, runtime-primary identity, or status: regular panels/KPI cards/list rows use eapp-surface-card/eapp-surface-muted/eapp-surface-hover/eapp-divide-y and eapp-text-* classes, while selected/current identity blocks, primary tiles, progress fills, primary icons, and primary CTA fills use eapp-primary-surface, eapp-primary-soft, eapp-primary-subtle, eapp-primary-solid, or eapp-primary-text so the color picker controls them.',
+          'Treat primary color as runtime-configurable by the app color picker. For Nuxt UI components, choose color="primary" by semantic intent. For custom extension UI, decide whether each element is neutral surface, runtime-primary identity, or status: regular panels/KPI cards/list rows use eapp-surface-card/eapp-surface-muted/eapp-surface-hover/eapp-divide-y and eapp-text-* classes, while selected/current identity blocks, primary tiles, progress fills, primary icons, and primary CTA fills use eapp-primary-surface, eapp-primary-soft, eapp-primary-subtle, eapp-primary-solid, or eapp-primary-text so the color picker controls them. eapp-primary-surface supplies selected identity color but does not replace card chrome; keep border/radius classes on selected blocks.',
           'Decision cases: normal decorative accents, feature icons, non-state tiles, active tabs, progress fills, selected segments, and primary actions use runtime primary/identity classes; true semantic states use their matching status colors such as error, warning, success, or info; large ordinary surfaces stay neutral and carry only small badges/icons for status; selected/current entity blocks may use eapp-primary-surface.',
-          'Pattern examples: KPI/metric cards should be eapp-surface-card with a small eapp-primary-soft icon tile; selected/current entity cards may use eapp-primary-surface; progress bars use eapp-surface-muted tracks plus eapp-primary-solid fills; list rows use eapp-surface-card/eapp-divide-y/eapp-surface-hover and only small chips inside; primary scope actions use UButton color="primary" variant="solid"; secondary actions use neutral variants.',
+          'Pattern examples: KPI/metric cards should be eapp-surface-card with a small icon tile using eapp-primary-soft eapp-icon-tile; selected/current entity cards may use eapp-primary-surface; progress bars use eapp-surface-muted tracks plus eapp-primary-solid fills; list rows use eapp-surface-card/eapp-divide-y/eapp-surface-hover and only small chips inside; primary scope actions use UButton color="primary" variant="solid"; secondary actions use neutral variants.',
           'Status colors belong only in UBadge/UAlert semantic colors or eapp-status-*-soft/text/border classes for badges, small icons, or short status text. Do not read --badge-* variables directly in extension templates. Do not color large panels, alert-like success blocks, KPI cards, list containers, or attention/reconciliation blocks green/yellow/red because of state; keep the block neutral and place the status badge/icon inside.',
           'Use PageHeader gradient: "none" for generated operational pages unless the user explicitly asks for a decorative page accent; do not hardcode cyan/violet/purple/blue/green gradients.',
           'For general card grids inside the shell, use md:grid-cols-2 xl:grid-cols-3 instead of lg:grid-cols-3 because the desktop sidebar leaves tablet-width content at 1024px.',
           'Do not use Nuxt UI neutral semantic classes such as bg-default, text-muted, text-dimmed, border-default, or divide-default inside extension code; use eApp class tokens instead. Do not write text-[var(...)], bg-[var(...)], or border-[var(...)] in generated extension templates unless no class token exists for that exact primitive.',
           'Do not pass ui.content: "eapp-surface-card" to UModal/CommonModal; modal content uses the app modal surface and caller content classes should only append z-index or width.',
-          'CommonModal and CommonDrawer own action-only footers through cancelAction, primaryAction, dangerAction, leadingActions, and footerHint. Pass action intent through props instead of styling footer buttons manually; cancelAction defaults to error outline, Close/Done should use tone: "neutral", and Keep editing should use tone: "primary" in discard dialogs.',
+          'CommonModal and CommonDrawer own action-only footers through cancelAction, primaryAction, dangerAction, leadingActions, and footerHint. Pass action intent through props instead of styling footer buttons manually; cancelAction defaults to neutral outline, dangerAction is for irreversible destructive work, and Keep editing should use tone: "primary" in discard dialogs.',
           'Use UTabs for page sections instead of custom tab bars so the app-level active/inactive indicators, spacing, focus rings, and theme contrast stay consistent.',
           'Do not inject global CSS, create theme guards, redefine the app palette, or solve one extension by overriding the whole app shell.',
           'Keep list selection local and fetch detail rows only; do not refetch the whole list after a row click unless the list data changed.',
@@ -1932,7 +1932,7 @@ onMounted(() => fetchOrders())
 </template>`,
         notes: [
           'For action-only footers, use CommonModal/CommonDrawer footer props: cancelAction, primaryAction, dangerAction, leadingActions, and footerHint.',
-          'cancelAction defaults to error outline because it usually backs out of a mutation. Use tone: "neutral" for Close/Done and tone: "primary" for Keep editing in discard dialogs.',
+          'cancelAction defaults to neutral outline. Use dangerAction for irreversible destructive work and tone: "primary" for Keep editing in discard dialogs.',
           'Every trigger/body action button inside CommonModal, CommonDrawer, or UModal should use type="button" unless it intentionally submits a form.',
           'Use @click.stop.prevent on body action buttons so clicks do not bubble to row/page triggers.',
           'Open modal/drawer shells immediately, then load content inside them; do not close and reopen after an API call.',

package/src/lib/platform-operation-tools.js

@@ -303,7 +303,7 @@ function getExtensionThemeContract() {
     theme: [
       'Use eApp theme class tokens, not hardcoded light/dark colors and not raw CSS variables inside extension templates. The app owns the CSS variable implementation; generated extensions should choose class tokens by intent.',
       'Primary color is runtime-configurable through the app color picker and must affect extension identity UI. For Nuxt UI components, choose color="primary" by semantic intent and let the app map it through the primary contract; do not choose a concrete palette. For custom extension UI, first choose whether the element is neutral surface, runtime-primary identity, or status. Regular panels, KPI cards, list rows, and large content blocks should use eapp-surface-card, eapp-surface-muted, eapp-surface-flat, eapp-surface-hover, eapp-divide-y, and eapp-text-* classes. Entity identity, selected/current state, active progress, primary tiles, primary icons, and primary CTA fills should use eapp-primary-surface, eapp-primary-soft, eapp-primary-subtle, eapp-primary-solid, eapp-primary-text, eapp-primary-border, or eapp-primary-ring so the color picker controls them.',
-      'Use eapp-primary-surface only for larger entity/feature blocks, selected/current cards, tiles, or cards that should read like normal app cards with a very subtle active-primary tint; it is not a saturated selected-state fill and must not be applied broadly to every KPI/list wrapper. Add eapp-primary-surface-hover when that block is clickable. Use eapp-primary-soft for compact selected entity chips, pills, small icon tiles, and identity callouts; add eapp-primary-soft-hover when compact surfaces are clickable; use eapp-primary-subtle for a slightly stronger selected fill; use eapp-primary-solid only for primary identity fills; use eapp-primary-text for identity icons or inline text. eapp-identity-* remains an alias for the same runtime-primary intent, but eapp-primary-* is preferred in new extension code.',
+      'Use eapp-primary-surface only for larger entity/feature blocks, selected/current cards, tiles, or cards that should read like normal app cards with a very subtle active-primary tint; it supplies selected identity color but does not replace card chrome, so keep normal border/radius classes such as border plus eapp-radius-panel on the element. It is not a saturated selected-state fill and must not be applied broadly to every KPI/list wrapper. Add eapp-primary-surface-hover when that block is clickable. Use eapp-primary-soft for compact selected entity chips, pills, square icon tiles using eapp-icon-tile, and identity callouts; add eapp-primary-soft-hover when compact surfaces are clickable; use eapp-primary-subtle for a slightly stronger selected fill; use eapp-primary-solid only for primary identity fills; use eapp-primary-text for identity icons or inline text. eapp-identity-* remains an alias for the same runtime-primary intent, but eapp-primary-* is preferred in new extension code.',
       'Nuxt UI secondary is still a valid semantic color when the product intentionally wants a secondary action or state. Do not use color="secondary", from-secondary-*, bg-secondary-*, text-secondary-*, or cyan/purple/green palette utilities merely to approximate an entity accent; use eapp-primary-* and let the app decide the color.',
       'The app runs on Tailwind v4. Short Tailwind color utilities are the canonical way to apply contract colors and ARE allowed: bg-primary, text-primary, border-primary, ring-primary, bg-success, text-error, etc., including opacity modifiers (bg-primary/10, ring-success/20) which v4 resolves via color-mix. They are generated from the token-backed config (primary -> --md-primary runtime, success/error/warning/info -> --st-* status, secondary -> --md-tertiary) so they follow the color picker and dark theme. Do NOT use raw CSS-variable utilities (text-[var(--*)], bg-[var(--*)], border-[var(--*)]), hardcoded hex, inline style colors, or concrete palette substitution (color="violet", from-cyan-*, text-violet-*, bg-green-*, bg-emerald-*, text-green-*, dark:bg-zinc-950). For intent surfaces with no Tailwind equivalent (selected identity block, soft/solid/subtle surface, divider, radius, modal chrome) use the eapp-* classes below; the app owns how they map to the active color picker value.',
       'Use UButton color="primary" only for the single main action for the current scope. Refresh, back, navigation, filters, and secondary actions should be neutral variants unless they are the main mutation.',
@@ -347,14 +347,14 @@ function getExtensionThemeContract() {
       'Buttons should have stable geometry: hover may change color, border, or shadow but must not move the button or resize its content. Disabled buttons keep disabled cursor/visual state.',
       'Inputs and textareas should not add hover movement or decorative hover states; focus, invalid, disabled, and loading states must be explicit.',
       'Dynamic extensions resolve UModal to the app CommonModal. Do not pass ui.content: "eapp-surface-card" or "surface-card" to UModal/CommonModal; modal content uses the app modal surface and caller ui.content should only append z-index, width, or max-width classes.',
-      'CommonModal and CommonDrawer own action-only footers through cancelAction, primaryAction, dangerAction, leadingActions, and footerHint. Pass footer button intent through those props instead of custom footer slots. cancelAction defaults to error outline; use tone: "neutral" for Close/Done and tone: "primary" for Keep editing in discard dialogs.',
+      'CommonModal and CommonDrawer own action-only footers through cancelAction, primaryAction, dangerAction, leadingActions, and footerHint. Pass footer button intent through those props instead of custom footer slots. cancelAction defaults to neutral outline; use dangerAction for irreversible destructive work and tone: "primary" for Keep editing in discard dialogs.',
       'Use custom #footer content only when the footer contains real custom layout or non-button content. Every modal/drawer button should use type="button" unless it intentionally submits a form.',
       'Use CommonDrawer for side-panel editing. Open drawers immediately on user action and render loading/error/content inside the drawer instead of waiting for fetch before opening.',
       'Use UTabs for page sections and large grouped forms instead of custom tab bars; the app-level Nuxt UI override owns active and inactive indicators, focus rings, spacing, and theme contrast.',
       'Use UBadge or token-backed badge spans for status. Keep badges legible in both themes with tokenized background, text, and border.',
     ],
     loadingAndLists: [
-      'For first load of card/list pages, render calm skeleton cards with a slow pulse. For subsequent pagination/filter refreshes, keep the card shells mounted and skeletonize card content until the new list is ready.',
+      'For first load of card/list pages, render calm skeleton cards with a slow pulse. Use USkeleton or shared loading components so the app-owned skeleton theme controls contrast and accent matching. For subsequent pagination/filter refreshes, keep the card shells mounted and skeletonize card content until the new list is ready.',
       'Keep pagination inside the same transition/loading branch as the list. Do not show pagination before the list content has left loading.',
       'Use bounded pagination for operational lists. Do not replace pagination with arbitrary fixed caps such as 30 or 50.',
       'Empty states should use an app-matched card surface with compact icon tile, title, and description; do not use huge blank white panels or naked UEmpty chrome on page surfaces.',
@@ -373,12 +373,12 @@ function getExtensionThemeContract() {
       {
         useWhen: 'Ordinary KPI, metric, or summary card where the whole card is not selected/current identity.',
         use: 'Neutral card surface; put runtime-primary only on a small identity icon tile, progress fill, or main CTA inside the card.',
-        snippet: '<article class="eapp-surface-card p-4"><div class="flex items-start justify-between gap-3"><div><p class="text-sm eapp-text-tertiary">Metric</p><p class="mt-2 text-2xl font-semibold eapp-text-primary">{{ value }}</p></div><span class="eapp-primary-soft eapp-radius-control p-2"><UIcon name="lucide:square-stack" class="size-5 eapp-primary-text" /></span></div></article>',
+        snippet: '<article class="eapp-surface-card p-4"><div class="flex items-start justify-between gap-3"><div><p class="text-sm eapp-text-tertiary">Metric</p><p class="mt-2 text-2xl font-semibold eapp-text-primary">{{ value }}</p></div><span class="eapp-primary-soft eapp-icon-tile"><UIcon name="lucide:square-stack" class="size-5 eapp-primary-text" /></span></div></article>',
       },
       {
         useWhen: 'Selected/current entity, active plan, chosen package, or the single block that represents the active identity.',
         use: 'eapp-primary-surface for the selected/current block, with eapp-primary-soft/text for compact icon parts.',
-        snippet: '<article class="eapp-primary-surface eapp-primary-surface-hover eapp-radius-panel border p-4"><div class="flex items-center gap-3"><span class="eapp-primary-soft eapp-radius-control p-2"><UIcon name="lucide:box" class="size-5 eapp-primary-text" /></span><div><p class="font-semibold eapp-text-primary">{{ name }}</p><p class="text-sm eapp-text-tertiary">Currently selected</p></div></div></article>',
+        snippet: '<article class="eapp-primary-surface eapp-primary-surface-hover eapp-radius-panel border p-4"><div class="flex items-center gap-3"><span class="eapp-primary-soft eapp-icon-tile"><UIcon name="lucide:box" class="size-5 eapp-primary-text" /></span><div><p class="font-semibold eapp-text-primary">{{ name }}</p><p class="text-sm eapp-text-tertiary">Currently selected</p></div></div></article>',
       },
       {
         useWhen: 'Progress, active tab indicator, selected segment fill, or primary visual meter.',
@@ -401,7 +401,7 @@ function getExtensionThemeContract() {
         snippet: '<div class="flex justify-end gap-2"><UButton color="neutral" variant="outline">Cancel</UButton><UButton color="primary" variant="solid" icon="lucide:save">Save</UButton></div>',
       },
     ],
-    compactExample: '<template><section class="min-h-full w-full space-y-4"><article class="eapp-surface-card p-4"><div class="flex items-start justify-between gap-3"><div><p class="text-sm eapp-text-tertiary">Neutral KPI</p><p class="mt-2 text-2xl font-semibold eapp-text-primary">24</p></div><span class="eapp-primary-soft eapp-radius-control p-2"><UIcon name="lucide:square-stack" class="size-5 eapp-primary-text" /></span></div><div class="mt-3 h-1.5 overflow-hidden eapp-radius-pill eapp-surface-muted"><div class="eapp-primary-solid h-full w-1/2"></div></div></article><section class="eapp-surface-card p-4"><div class="flex items-center justify-between gap-3"><p class="font-semibold eapp-text-primary">Status block stays neutral</p><UBadge color="success" variant="soft">Healthy</UBadge></div></section></section></template>',
+    compactExample: '<template><section class="min-h-full w-full space-y-4"><article class="eapp-surface-card p-4"><div class="flex items-start justify-between gap-3"><div><p class="text-sm eapp-text-tertiary">Neutral KPI</p><p class="mt-2 text-2xl font-semibold eapp-text-primary">24</p></div><span class="eapp-primary-soft eapp-icon-tile"><UIcon name="lucide:square-stack" class="size-5 eapp-primary-text" /></span></div><div class="mt-3 h-1.5 overflow-hidden eapp-radius-pill eapp-surface-muted"><div class="eapp-primary-solid h-full w-1/2"></div></div></article><section class="eapp-surface-card p-4"><div class="flex items-center justify-between gap-3"><p class="font-semibold eapp-text-primary">Status block stays neutral</p><UBadge color="success" variant="soft">Healthy</UBadge></div></section></section></template>',
     contractAuthority: [
       'This is the authoritative Enfyra theme & color contract. Source of truth: documents/app/theme-color-contract.md. The app owns color through app/utils/primary-colors.ts (Material You seed-to-role generation), app/assets/css/theme.css (semantic variables and Nuxt UI ramps), app/assets/css/main.css (extension-safe semantic utilities), and app/app.config.ts (Nuxt UI component mapping). Pages and extensions only CONSUME classes/Nuxt UI props; they never define colors.',
       'Every color flows from two base layers: --md-* (Material You, runtime primary picker) and --st-* (status). Runtime primary roles are generated with SchemeTonalSpot. Success/warning/info stay fixed status quarts; error follows the generated Material error role through the single --danger-* lane. All Nuxt UI semantic colors (primary/secondary/success/warning/error/info/neutral) are re-pointed to these, so Nuxt UI is used per its docs but colors are decided by Enfyra. This applies to the shell, system pages, and compiled dynamic extensions.',
@@ -443,6 +443,7 @@ function getThemeClassReference() {
       { group: 'Runtime primary identity', classes: 'eapp-primary-solid, eapp-primary-text, eapp-primary-soft(+hover), eapp-primary-subtle, eapp-primary-surface(+hover), eapp-primary-border, eapp-primary-ring' },
       { group: 'Status (badges/small icons/short text only)', classes: 'eapp-status-{success|warning|danger|info|neutral}-{soft|text|border}' },
       { group: 'Radius', classes: 'eapp-radius-card, eapp-radius-panel, eapp-radius-control, eapp-radius-subcontrol, eapp-radius-pill' },
+      { group: 'Icon tile geometry', classes: 'eapp-icon-tile, eapp-icon-tile-sm, eapp-icon-tile-lg' },
       { group: 'Dividers', classes: 'eapp-divider, eapp-divide-y' },
       { group: 'Modal', classes: 'eapp-modal-surface (never surface-card as modal ui.content)' },
     ],