@luquimbo/bi-superpowers 2.0.1 → 3.0.0

package/bin/lib/mcp-config.js

@@ -0,0 +1,242 @@
+/**
+ * Multi-Agent MCP Configuration Writer
+ * =====================================
+ *
+ * Writes the bi-superpowers MCP config (2 servers: powerbi-modeling-mcp
+ * + microsoft-learn) into each supported agent's expected config location
+ * at the user level (home directory).
+ *
+ * Each agent has its own config format and path. This module normalizes
+ * the write operation across all 5 supported agents:
+ *
+ *   | Agent           | Path                                  | Format            |
+ *   |-----------------|---------------------------------------|-------------------|
+ *   | Claude Code     | ~/.claude.json                        | JSON mcpServers   |
+ *   | GitHub Copilot  | ~/.copilot/mcp-config.json            | JSON servers      |
+ *   | Codex           | ~/.codex/config.toml                  | TOML mcp_servers  |
+ *   | Gemini CLI      | ~/.gemini/settings.json               | JSON mcpServers   |
+ *   | Kilo Code       | ~/.kilocode/mcp_settings.json         | JSON mcpServers   |
+ *
+ * The launcher path for the Power BI Modeling MCP is resolved to an
+ * absolute path at install time so it works in agents that don't
+ * support Claude Code's `${CLAUDE_PLUGIN_ROOT}` variable.
+ *
+ * @module lib/mcp-config
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const MICROSOFT_LEARN_URL = 'https://learn.microsoft.com/api/mcp';
+const MODELING_SERVER_NAME = 'powerbi-modeling';
+const LEARN_SERVER_NAME = 'microsoft-learn';
+
+/**
+ * Resolves the absolute path to the Power BI Modeling MCP launcher
+ * inside the installed npm package.
+ */
+function getLauncherAbsolutePath(packageDir) {
+  return path.join(packageDir, 'bin', 'mcp', 'powerbi-modeling-launcher.js');
+}
+
+/**
+ * Safely read a JSON file. Returns null if missing or unparseable.
+ */
+function readJsonSafe(filePath) {
+  if (!fs.existsSync(filePath)) return null;
+  try {
+    return JSON.parse(fs.readFileSync(filePath, 'utf8'));
+  } catch (_) {
+    return null;
+  }
+}
+
+/**
+ * Write a JSON file, creating parent dirs if needed.
+ */
+function writeJson(filePath, data) {
+  const dir = path.dirname(filePath);
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true });
+  }
+  fs.writeFileSync(filePath, JSON.stringify(data, null, 2) + '\n');
+}
+
+/**
+ * Escape a string for use inside TOML double-quoted strings.
+ */
+function tomlEscape(str) {
+  return String(str).replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+}
+
+// ============================================
+// CLAUDE CODE
+// ============================================
+// Writes ~/.claude.json, adding to `mcpServers`. Preserves other user-level
+// config in that file (projects, settings, etc.).
+function writeClaudeCodeConfig(packageDir) {
+  const configPath = path.join(os.homedir(), '.claude.json');
+  const existing = readJsonSafe(configPath) || {};
+  const mcpServers = { ...(existing.mcpServers || {}) };
+
+  mcpServers[MODELING_SERVER_NAME] = {
+    command: 'node',
+    args: [getLauncherAbsolutePath(packageDir)],
+  };
+  mcpServers[LEARN_SERVER_NAME] = {
+    type: 'http',
+    url: MICROSOFT_LEARN_URL,
+  };
+
+  writeJson(configPath, { ...existing, mcpServers });
+  return configPath;
+}
+
+// ============================================
+// GITHUB COPILOT CLI
+// ============================================
+// Writes ~/.copilot/mcp-config.json. Copilot uses `servers` (NOT mcpServers)
+// and each server has an explicit `type` field.
+function writeCopilotConfig(packageDir) {
+  const configPath = path.join(os.homedir(), '.copilot', 'mcp-config.json');
+  const existing = readJsonSafe(configPath) || {};
+  const servers = { ...(existing.servers || {}) };
+
+  servers[MODELING_SERVER_NAME] = {
+    type: 'stdio',
+    command: 'node',
+    args: [getLauncherAbsolutePath(packageDir)],
+  };
+  servers[LEARN_SERVER_NAME] = {
+    type: 'http',
+    url: MICROSOFT_LEARN_URL,
+  };
+
+  writeJson(configPath, { ...existing, servers });
+  return configPath;
+}
+
+// ============================================
+// CODEX (OpenAI) — TOML format
+// ============================================
+// Writes ~/.codex/config.toml, appending [mcp_servers.*] sections.
+// Preserves existing content by removing only our own sections before
+// appending the fresh ones.
+function writeCodexConfig(packageDir) {
+  const configPath = path.join(os.homedir(), '.codex', 'config.toml');
+  const launcher = getLauncherAbsolutePath(packageDir);
+
+  let existing = '';
+  if (fs.existsSync(configPath)) {
+    existing = fs.readFileSync(configPath, 'utf8');
+  }
+
+  // Remove any previous bi-superpowers MCP sections so re-running install
+  // doesn't duplicate them. Strips each section from its header to the
+  // next [ header or EOF.
+  const stripPattern = new RegExp(
+    `\\n?\\[mcp_servers\\.(${MODELING_SERVER_NAME}|${LEARN_SERVER_NAME})\\][\\s\\S]*?(?=\\n\\[|$)`,
+    'g'
+  );
+  existing = existing.replace(stripPattern, '');
+
+  const newSections =
+    `\n\n[mcp_servers.${MODELING_SERVER_NAME}]\n` +
+    'command = "node"\n' +
+    `args = ["${tomlEscape(launcher)}"]\n` +
+    `\n[mcp_servers.${LEARN_SERVER_NAME}]\n` +
+    `url = "${MICROSOFT_LEARN_URL}"\n`;
+
+  const content = existing.trimEnd() + newSections;
+
+  const dir = path.dirname(configPath);
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true });
+  }
+  fs.writeFileSync(configPath, content);
+  return configPath;
+}
+
+// ============================================
+// GEMINI CLI
+// ============================================
+// Writes ~/.gemini/settings.json. Gemini uses `mcpServers` and `httpUrl`
+// (not `url`) for HTTP transports.
+function writeGeminiConfig(packageDir) {
+  const configPath = path.join(os.homedir(), '.gemini', 'settings.json');
+  const existing = readJsonSafe(configPath) || {};
+  const mcpServers = { ...(existing.mcpServers || {}) };
+
+  mcpServers[MODELING_SERVER_NAME] = {
+    command: 'node',
+    args: [getLauncherAbsolutePath(packageDir)],
+  };
+  mcpServers[LEARN_SERVER_NAME] = {
+    httpUrl: MICROSOFT_LEARN_URL,
+  };
+
+  writeJson(configPath, { ...existing, mcpServers });
+  return configPath;
+}
+
+// ============================================
+// KILO CODE
+// ============================================
+// Writes ~/.kilocode/mcp_settings.json. Kilo uses `mcpServers` and `url`
+// for HTTP transports.
+function writeKiloConfig(packageDir) {
+  const configPath = path.join(os.homedir(), '.kilocode', 'mcp_settings.json');
+  const existing = readJsonSafe(configPath) || {};
+  const mcpServers = { ...(existing.mcpServers || {}) };
+
+  mcpServers[MODELING_SERVER_NAME] = {
+    command: 'node',
+    args: [getLauncherAbsolutePath(packageDir)],
+  };
+  mcpServers[LEARN_SERVER_NAME] = {
+    url: MICROSOFT_LEARN_URL,
+  };
+
+  writeJson(configPath, { ...existing, mcpServers });
+  return configPath;
+}
+
+/**
+ * Registry mapping agent IDs to their MCP config writers.
+ */
+const MCP_WRITERS = {
+  'claude-code': writeClaudeCodeConfig,
+  'github-copilot': writeCopilotConfig,
+  codex: writeCodexConfig,
+  'gemini-cli': writeGeminiConfig,
+  kilo: writeKiloConfig,
+};
+
+/**
+ * Write MCP config for a specific agent.
+ * @param {string} agentId - One of the supported agent IDs
+ * @param {string} packageDir - Absolute path to the installed package
+ * @returns {string|null} The config path written, or null if unknown agent
+ * @throws {Error} If the write fails
+ */
+function writeMcpConfigForAgent(agentId, packageDir) {
+  const writer = MCP_WRITERS[agentId];
+  if (!writer) {
+    return null;
+  }
+  return writer(packageDir);
+}
+
+module.exports = {
+  writeMcpConfigForAgent,
+  MCP_WRITERS,
+  MODELING_SERVER_NAME,
+  LEARN_SERVER_NAME,
+  MICROSOFT_LEARN_URL,
+  // Exported for testing
+  readJsonSafe,
+  writeJson,
+  tomlEscape,
+  getLauncherAbsolutePath,
+};

package/bin/lib/mcp-config.test.js

@@ -0,0 +1,184 @@
+/**
+ * Tests for the multi-agent MCP config writer.
+ */
+
+const { test, describe, beforeEach, afterEach } = require('node:test');
+const assert = require('node:assert');
+const fs = require('node:fs');
+const os = require('node:os');
+const path = require('node:path');
+
+const {
+  MCP_WRITERS,
+  MODELING_SERVER_NAME,
+  LEARN_SERVER_NAME,
+  MICROSOFT_LEARN_URL,
+  tomlEscape,
+  getLauncherAbsolutePath,
+} = require('./mcp-config');
+
+describe('mcp-config helpers', () => {
+  test('getLauncherAbsolutePath returns absolute launcher path', () => {
+    const pkgDir = '/tmp/fake-pkg';
+    const launcher = getLauncherAbsolutePath(pkgDir);
+    assert.strictEqual(launcher, path.join(pkgDir, 'bin', 'mcp', 'powerbi-modeling-launcher.js'));
+  });
+
+  test('tomlEscape escapes backslashes and quotes', () => {
+    assert.strictEqual(tomlEscape('plain'), 'plain');
+    assert.strictEqual(tomlEscape('C:\\path\\to\\file'), 'C:\\\\path\\\\to\\\\file');
+    assert.strictEqual(tomlEscape('say "hello"'), 'say \\"hello\\"');
+  });
+});
+
+describe('MCP_WRITERS registry', () => {
+  test('covers all 5 supported agents', () => {
+    const ids = Object.keys(MCP_WRITERS).sort();
+    assert.deepStrictEqual(ids, ['claude-code', 'codex', 'gemini-cli', 'github-copilot', 'kilo']);
+  });
+
+  test('each writer is a function', () => {
+    for (const [id, writer] of Object.entries(MCP_WRITERS)) {
+      assert.strictEqual(typeof writer, 'function', `${id} writer should be a function`);
+    }
+  });
+});
+
+describe('MCP writers — JSON agents', () => {
+  let tempHome;
+  let origHome;
+  const fakePkgDir = '/tmp/fake-bi-superpowers';
+
+  beforeEach(() => {
+    tempHome = fs.mkdtempSync(path.join(os.tmpdir(), 'bi-mcp-home-'));
+    origHome = os.homedir;
+    os.homedir = () => tempHome;
+  });
+
+  afterEach(() => {
+    os.homedir = origHome;
+    fs.rmSync(tempHome, { recursive: true, force: true });
+  });
+
+  test('claude-code writer produces mcpServers JSON at ~/.claude.json', () => {
+    const configPath = MCP_WRITERS['claude-code'](fakePkgDir);
+
+    assert.strictEqual(configPath, path.join(tempHome, '.claude.json'));
+    assert.ok(fs.existsSync(configPath));
+
+    const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+    assert.ok(config.mcpServers);
+    assert.ok(config.mcpServers[MODELING_SERVER_NAME]);
+    assert.strictEqual(config.mcpServers[MODELING_SERVER_NAME].command, 'node');
+    assert.ok(
+      config.mcpServers[MODELING_SERVER_NAME].args[0].includes('powerbi-modeling-launcher.js')
+    );
+    assert.deepStrictEqual(config.mcpServers[LEARN_SERVER_NAME], {
+      type: 'http',
+      url: MICROSOFT_LEARN_URL,
+    });
+  });
+
+  test('github-copilot writer uses "servers" key (not mcpServers)', () => {
+    const configPath = MCP_WRITERS['github-copilot'](fakePkgDir);
+
+    assert.strictEqual(configPath, path.join(tempHome, '.copilot', 'mcp-config.json'));
+    const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+    assert.ok(config.servers);
+    assert.strictEqual(config.mcpServers, undefined);
+    assert.strictEqual(config.servers[MODELING_SERVER_NAME].type, 'stdio');
+    assert.strictEqual(config.servers[LEARN_SERVER_NAME].type, 'http');
+  });
+
+  test('gemini-cli writer uses httpUrl (not url)', () => {
+    const configPath = MCP_WRITERS['gemini-cli'](fakePkgDir);
+
+    assert.strictEqual(configPath, path.join(tempHome, '.gemini', 'settings.json'));
+    const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+    assert.ok(config.mcpServers);
+    assert.strictEqual(config.mcpServers[LEARN_SERVER_NAME].httpUrl, MICROSOFT_LEARN_URL);
+    assert.strictEqual(config.mcpServers[LEARN_SERVER_NAME].url, undefined);
+  });
+
+  test('kilo writer uses url (standard)', () => {
+    const configPath = MCP_WRITERS.kilo(fakePkgDir);
+
+    assert.strictEqual(configPath, path.join(tempHome, '.kilocode', 'mcp_settings.json'));
+    const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+    assert.ok(config.mcpServers);
+    assert.strictEqual(config.mcpServers[LEARN_SERVER_NAME].url, MICROSOFT_LEARN_URL);
+  });
+
+  test('claude-code writer preserves existing config', () => {
+    const configPath = path.join(tempHome, '.claude.json');
+    fs.writeFileSync(
+      configPath,
+      JSON.stringify({
+        otherSetting: 'value',
+        mcpServers: { 'existing-mcp': { command: 'echo' } },
+      })
+    );
+
+    MCP_WRITERS['claude-code'](fakePkgDir);
+
+    const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+    assert.strictEqual(config.otherSetting, 'value');
+    assert.ok(config.mcpServers['existing-mcp']);
+    assert.ok(config.mcpServers[MODELING_SERVER_NAME]);
+    assert.ok(config.mcpServers[LEARN_SERVER_NAME]);
+  });
+});
+
+describe('codex writer — TOML', () => {
+  let tempHome;
+  let origHome;
+
+  beforeEach(() => {
+    tempHome = fs.mkdtempSync(path.join(os.tmpdir(), 'bi-mcp-codex-'));
+    origHome = os.homedir;
+    os.homedir = () => tempHome;
+  });
+
+  afterEach(() => {
+    os.homedir = origHome;
+    fs.rmSync(tempHome, { recursive: true, force: true });
+  });
+
+  test('writes TOML with [mcp_servers.*] sections', () => {
+    const configPath = MCP_WRITERS.codex('/tmp/fake-pkg');
+
+    assert.strictEqual(configPath, path.join(tempHome, '.codex', 'config.toml'));
+    const content = fs.readFileSync(configPath, 'utf8');
+
+    assert.ok(content.includes('[mcp_servers.powerbi-modeling]'));
+    assert.ok(content.includes('command = "node"'));
+    assert.ok(content.includes('[mcp_servers.microsoft-learn]'));
+    assert.ok(content.includes(`url = "${MICROSOFT_LEARN_URL}"`));
+  });
+
+  test('preserves existing non-MCP TOML content', () => {
+    const configPath = path.join(tempHome, '.codex', 'config.toml');
+    fs.mkdirSync(path.dirname(configPath), { recursive: true });
+    fs.writeFileSync(configPath, '[profile]\nname = "default"\n');
+
+    MCP_WRITERS.codex('/tmp/fake-pkg');
+
+    const content = fs.readFileSync(configPath, 'utf8');
+    assert.ok(content.includes('[profile]'));
+    assert.ok(content.includes('name = "default"'));
+    assert.ok(content.includes('[mcp_servers.powerbi-modeling]'));
+  });
+
+  test('re-running install replaces MCP sections, does not duplicate', () => {
+    MCP_WRITERS.codex('/tmp/fake-pkg');
+    MCP_WRITERS.codex('/tmp/fake-pkg');
+
+    const content = fs.readFileSync(path.join(tempHome, '.codex', 'config.toml'), 'utf8');
+
+    // Each section name should appear exactly once
+    const modelingCount = (content.match(/\[mcp_servers\.powerbi-modeling\]/g) || []).length;
+    const learnCount = (content.match(/\[mcp_servers\.microsoft-learn\]/g) || []).length;
+    assert.strictEqual(modelingCount, 1);
+    assert.strictEqual(learnCount, 1);
+  });
+});

package/bin/lib/microsoft-mcp.js

@@ -2,21 +2,20 @@
  * Official Microsoft MCP Configuration Helpers
  * ============================================
  *
- * Single source of truth for the Claude Code plugin and legacy adapter
- * configurations that point at the official Microsoft Power BI / Fabric
- * MCP servers.
+ * Single source of truth for the MCP servers that bi-superpowers ships.
+ * Currently ships 2 servers, both from Microsoft:
+ *
+ * - powerbi-modeling-mcp: local stdio launcher that talks to Power BI Desktop
+ *   via XMLA on localhost. Requires Power BI Desktop running with a model open.
+ * - microsoft-learn: HTTP MCP that pipes Microsoft Learn docs into the agent.
  *
  * @module lib/microsoft-mcp
  */
 
 const path = require('path');
 
-const REMOTE_POWERBI_URL = 'https://api.fabric.microsoft.com/v1/mcp/powerbi';
-const FABRIC_MCP_PACKAGE = '@microsoft/fabric-mcp@latest';
 const MICROSOFT_LEARN_URL = 'https://learn.microsoft.com/api/mcp';
 const MODELING_SERVER_NAME = 'powerbi-modeling-mcp';
-const REMOTE_SERVER_NAME = 'powerbi-remote';
-const FABRIC_SERVER_NAME = 'fabric-mcp-server';
 const LEARN_SERVER_NAME = 'microsoft-learn';
 const ABSOLUTE_LAUNCHER_MODE = 'absolute';
 const PLUGIN_ROOT_LAUNCHER_MODE = 'plugin-root';
@@ -51,15 +50,6 @@ function createPluginMcpConfig(options = {}) {
   const launcherPath = resolveModelingLauncherPath(options);
 
   return {
-    [REMOTE_SERVER_NAME]: {
-      type: 'http',
-      url: REMOTE_POWERBI_URL,
-    },
-    [FABRIC_SERVER_NAME]: {
-      type: 'stdio',
-      command: 'npx',
-      args: ['-y', FABRIC_MCP_PACKAGE, 'server', 'start', '--mode', 'all'],
-    },
     [MODELING_SERVER_NAME]: {
       type: 'stdio',
       command: 'node',
@@ -170,12 +160,8 @@ function mergeMcpConfig(existingConfig, newConfig, format) {
 module.exports = {
   ABSOLUTE_LAUNCHER_MODE,
   PLUGIN_ROOT_LAUNCHER_MODE,
-  REMOTE_POWERBI_URL,
-  FABRIC_MCP_PACKAGE,
   MICROSOFT_LEARN_URL,
   MODELING_SERVER_NAME,
-  REMOTE_SERVER_NAME,
-  FABRIC_SERVER_NAME,
   LEARN_SERVER_NAME,
   resolveModelingLauncherPath,
   createPluginMcpConfig,

package/bin/lib/microsoft-mcp.test.js

@@ -9,8 +9,6 @@ const path = require('node:path');
 const {
   ABSOLUTE_LAUNCHER_MODE,
   PLUGIN_ROOT_LAUNCHER_MODE,
-  REMOTE_POWERBI_URL,
-  FABRIC_MCP_PACKAGE,
   MICROSOFT_LEARN_URL,
   createPluginMcpConfig,
   createMcpConfigForFormat,
@@ -41,29 +39,36 @@ describe('resolveModelingLauncherPath', () => {
 });
 
 describe('createPluginMcpConfig', () => {
-  test('returns the official Microsoft MCP defaults', () => {
+  test('returns the 2 official Microsoft MCP defaults', () => {
     const config = createPluginMcpConfig({
       packageDir: '/tmp/bi-superpowers',
       launcherMode: ABSOLUTE_LAUNCHER_MODE,
     });
 
-    assert.deepStrictEqual(config['powerbi-remote'], {
-      type: 'http',
-      url: REMOTE_POWERBI_URL,
-    });
-    assert.deepStrictEqual(config['fabric-mcp-server'], {
-      type: 'stdio',
-      command: 'npx',
-      args: ['-y', FABRIC_MCP_PACKAGE, 'server', 'start', '--mode', 'all'],
-    });
+    // Should have exactly 2 servers
+    assert.strictEqual(Object.keys(config).length, 2);
+
+    // powerbi-modeling-mcp: local stdio launcher
     assert.strictEqual(config['powerbi-modeling-mcp'].type, 'stdio');
     assert.strictEqual(config['powerbi-modeling-mcp'].command, 'node');
     assert.ok(config['powerbi-modeling-mcp'].args[0].endsWith('powerbi-modeling-launcher.js'));
+
+    // microsoft-learn: HTTP MCP
     assert.deepStrictEqual(config['microsoft-learn'], {
       type: 'http',
       url: MICROSOFT_LEARN_URL,
     });
   });
+
+  test('does not include the old removed servers', () => {
+    const config = createPluginMcpConfig({
+      packageDir: '/tmp/bi-superpowers',
+      launcherMode: ABSOLUTE_LAUNCHER_MODE,
+    });
+
+    assert.strictEqual(config['powerbi-remote'], undefined);
+    assert.strictEqual(config['fabric-mcp-server'], undefined);
+  });
 });
 
 describe('createMcpConfigForFormat', () => {
@@ -71,10 +76,9 @@ describe('createMcpConfigForFormat', () => {
     const pluginConfig = createMcpConfigForFormat('plugin');
     const cursorConfig = createMcpConfigForFormat('cursor');
 
-    assert.ok(pluginConfig['powerbi-remote']);
-    assert.ok(cursorConfig['powerbi-remote']);
-    assert.strictEqual(pluginConfig['powerbi-remote'].type, 'http');
-    assert.strictEqual(cursorConfig['powerbi-remote'].type, 'http');
+    assert.ok(pluginConfig['powerbi-modeling-mcp']);
+    assert.ok(cursorConfig['microsoft-learn']);
+    assert.strictEqual(pluginConfig['microsoft-learn'].type, 'http');
   });
 
   test('returns nested mcpServers config for claude-like outputs', () => {
@@ -82,7 +86,7 @@ describe('createMcpConfigForFormat', () => {
 
     assert.ok(config.mcpServers);
     assert.ok(config.mcpServers['powerbi-modeling-mcp']);
-    assert.ok(config.mcpServers['fabric-mcp-server']);
+    assert.ok(config.mcpServers['microsoft-learn']);
   });
 });
 
@@ -90,22 +94,22 @@ describe('mergeMcpConfig', () => {
   test('merges plugin configs without dropping existing entries', () => {
     const merged = mergeMcpConfig(
       { existing: { type: 'http', url: 'https://example.com' } },
-      { 'powerbi-remote': { type: 'http', url: REMOTE_POWERBI_URL } },
+      { 'microsoft-learn': { type: 'http', url: MICROSOFT_LEARN_URL } },
       'plugin'
     );
 
     assert.ok(merged.existing);
-    assert.ok(merged['powerbi-remote']);
+    assert.ok(merged['microsoft-learn']);
   });
 
   test('merges claude configs inside mcpServers', () => {
     const merged = mergeMcpConfig(
       { mcpServers: { existing: { type: 'http', url: 'https://example.com' } } },
-      { mcpServers: { 'powerbi-remote': { type: 'http', url: REMOTE_POWERBI_URL } } },
+      { mcpServers: { 'microsoft-learn': { type: 'http', url: MICROSOFT_LEARN_URL } } },
       'claude'
     );
 
     assert.ok(merged.mcpServers.existing);
-    assert.ok(merged.mcpServers['powerbi-remote']);
+    assert.ok(merged.mcpServers['microsoft-learn']);
   });
 });

package/bin/postinstall.js

@@ -12,35 +12,30 @@ console.log(`
 ╔═══════════════════════════════════════════════════════════╗
 ║                                                           ║
 ║   BI Agent Superpowers v${VERSION.padEnd(34)}║
-║   AI-powered toolkit for Power BI, Fabric & Excel        ║
+║   Plugin para Power BI Desktop — open source (MIT)        ║
 ║   Developed by Lucas Sanchez (@luquimbo)                 ║
-║   Open source — MIT licensed                              ║
 ║                                                           ║
 ╚═══════════════════════════════════════════════════════════╝
 
-Instalado correctamente!
+Instalado correctamente.
 
 Quick Start:
-  1. super install         Instalá los 24 skills en tus agentes AI
-  2. super kickoff         Inicializá el plugin en un proyecto
-  3. super powers          Ver todos los skills disponibles
-
-Works with:
-  • Claude Code        Plugin nativo (skills + commands + MCP)
-  • GitHub Copilot     Agent skills
-  • Codex (OpenAI)     Agent skills
-  • Gemini CLI         Agent skills
-  • Kilo Code          Agent skills
-  • Claude Desktop     MCPB extension (super build-desktop)
-
-24 skills incluidos:
-  /project-kickoff       Analizá y planificá proyectos BI
-  /data-model-design     Diseñá modelos estrella
-  /dax-doctor            Debuggeá y optimizá medidas DAX
-  /dax                   Mejores prácticas de DAX
-  /power-query           Patrones de Power Query
-  /report-design         Diseño y visualización de reportes
-  ... y 18 más
+  super install              # Instalá skills + MCPs en tus agentes AI
+
+Funciona con los 5 agentes:
+  • Claude Code
+  • GitHub Copilot
+  • Codex (OpenAI)
+  • Gemini CLI
+  • Kilo Code
+
+2 skills iniciales:
+  /project-kickoff   — Analizá tu proyecto BI
+  /pbi-connect       — Conectá tu agente a Power BI Desktop
+
+2 MCP servers:
+  powerbi-modeling   — Conexión local a Power BI Desktop (XMLA)
+  microsoft-learn    — Docs de Microsoft Learn en contexto
 
 Documentation: https://github.com/luquimbo/bi-superpowers
 `);