feat: add Mistral Vibe CLI platform support (#1)

* Initial plan

* feat: add Mistral Vibe CLI platform support

Co-authored-by: welcoMattic <773875+welcoMattic@users.noreply.github.com>

* docs: add Mistral Vibe to installation documentation

Co-authored-by: welcoMattic <773875+welcoMattic@users.noreply.github.com>

* Fix directory name for Mistral Vibe skills in docs

* Update Mistral Vibe target directory in tests

* Change target directory for Mistral's CLI installer

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: welcoMattic <773875+welcoMattic@users.noreply.github.com>
Co-authored-by: Mathieu Santostefano <msantostefano@proton.me>

Author: Copilot

docs/how-to/install-bmad.md

@@ -89,7 +89,10 @@ your-project/
 │       ├── bmad-help/
 │       ├── bmad-persona/
 │       └── ...
-└── .cursor/            # Cursor skills (if using Cursor)
+├── .cursor/            # Cursor skills (if using Cursor)
+│   └── skills/
+│       └── ...
+└── .vibe/              # Mistral Vibe skills (if using Mistral Vibe)
     └── skills/
         └── ...
 ```

docs/how-to/non-interactive-installation.md

@@ -61,6 +61,8 @@ Available tool IDs for the `--tools` flag:
 
 **Preferred:** `claude-code`, `cursor`
 
+**Other CLIs:** `mistral`, `gemini`, `codex`, `auggie`, `pi`
+
 Run `npx bmad-method install` interactively once to see the full current list of supported tools, or check the [platform codes configuration](https://github.com/bmad-code-org/BMAD-METHOD/blob/main/tools/cli/installers/lib/ide/platform-codes.yaml).
 
 ## Installation Modes

test/test-installation-components.js

@@ -1587,7 +1587,7 @@ async function runTests() {
   // ============================================================
   // Suite 29: Unified Skill Scanner — collectSkills
   // ============================================================
-  console.log(`${colors.yellow}Test Suite 29: Unified Skill Scanner${colors.reset}\n`);
+  console.log(`${colors.yellow}Test Suite 30: Unified Skill Scanner${colors.reset}\n`);
 
   let tempFixture29;
   try {
@@ -1700,7 +1700,7 @@ async function runTests() {
   // ============================================================
   // Suite 30: parseSkillMd validation (negative cases)
   // ============================================================
-  console.log(`${colors.yellow}Test Suite 30: parseSkillMd Validation${colors.reset}\n`);
+  console.log(`${colors.yellow}Test Suite 31: parseSkillMd Validation${colors.reset}\n`);
 
   let tempFixture30;
   try {
@@ -1808,6 +1808,96 @@ async function runTests() {
 
   console.log('');
 
+  // ============================================================
+  // Suite 31: Mistral Vibe CLI Native Skills
+  // ============================================================
+  console.log(`${colors.yellow}Test Suite 31: Mistral Vibe CLI Native Skills${colors.reset}\n`);
+
+  let tempProjectDir31;
+  let installedBmadDir31;
+  try {
+    clearCache();
+    const platformCodes31 = await loadPlatformCodes();
+    const mistralInstaller = platformCodes31.platforms.mistral?.installer;
+
+    assert(mistralInstaller?.target_dir === '.vibe/skills', 'Mistral Vibe target_dir uses native skills path');
+    assert(mistralInstaller?.skill_format === true, 'Mistral Vibe installer enables native skill output');
+    assert(mistralInstaller?.template_type === 'default', 'Mistral Vibe installer uses default skill template');
+    assert(mistralInstaller?.legacy_targets === undefined, 'Mistral Vibe installer has no legacy_targets');
+
+    tempProjectDir31 = await fs.mkdtemp(path.join(os.tmpdir(), 'bmad-mistral-test-'));
+    installedBmadDir31 = await createTestBmadFixture();
+
+    const ideManager31 = new IdeManager();
+    await ideManager31.ensureInitialized();
+
+    // Verify Mistral Vibe is selectable in an available IDEs list
+    const availableIdes31 = ideManager31.getAvailableIdes();
+    assert(
+      availableIdes31.some((ide) => ide.value === 'mistral'),
+      'Mistral Vibe appears in available IDEs list',
+    );
+
+    // Verify Mistral Vibe is NOT detected before install
+    const detectedBefore31 = await ideManager31.detectInstalledIdes(tempProjectDir31);
+    assert(!detectedBefore31.includes('mistral'), 'Mistral Vibe is not detected before install');
+
+    const result31 = await ideManager31.setup('mistral', tempProjectDir31, installedBmadDir31, {
+      silent: true,
+      selectedModules: ['bmm'],
+    });
+
+    assert(result31.success === true, 'Mistral Vibe setup succeeds against temp project');
+
+    // Verify Mistral Vibe IS detected after install
+    const detectedAfter31 = await ideManager31.detectInstalledIdes(tempProjectDir31);
+    assert(detectedAfter31.includes('mistral'), 'Mistral Vibe is detected after install');
+
+    const skillFile31 = path.join(tempProjectDir31, '.vibe', 'skills', 'bmad-master', 'SKILL.md');
+    assert(await fs.pathExists(skillFile31), 'Mistral Vibe install writes SKILL.md directory output');
+
+    // Parse YAML frontmatter between --- markers
+    const skillContent31 = await fs.readFile(skillFile31, 'utf8');
+    const fmMatch31 = skillContent31.match(/^---\n([\s\S]*?)\n---\n?([\s\S]*)$/);
+    assert(fmMatch31, 'Mistral Vibe SKILL.md contains valid frontmatter delimiters');
+
+    const frontmatter31 = fmMatch31[1];
+    const body31 = fmMatch31[2];
+
+    // Verify the name in the frontmatter matches the directory name
+    const fmName31 = frontmatter31.match(/^name:\s*(.+)$/m);
+    assert(fmName31 && fmName31[1].trim() === 'bmad-master', 'Mistral Vibe skill name frontmatter matches directory name exactly');
+
+    // Verify description exists and is non-empty
+    const fmDesc31 = frontmatter31.match(/^description:\s*(.+)$/m);
+    assert(fmDesc31 && fmDesc31[1].trim().length > 0, 'Mistral Vibe skill description frontmatter is present and non-empty');
+
+    // Verify frontmatter contains only name and description keys
+    const fmKeys31 = [...frontmatter31.matchAll(/^([a-zA-Z0-9_-]+):/gm)].map((m) => m[1]);
+    assert(
+      fmKeys31.length === 2 && fmKeys31.includes('name') && fmKeys31.includes('description'),
+      'Mistral Vibe skill frontmatter contains only name and description keys',
+    );
+
+    // Verify body content is non-empty
+    assert(body31.trim().length > 0, 'Mistral Vibe skill body content is non-empty');
+
+    // Reinstall/upgrade: run setup again over existing output
+    const result31b = await ideManager31.setup('mistral', tempProjectDir31, installedBmadDir31, {
+      silent: true,
+      selectedModules: ['bmm'],
+    });
+    assert(result31b.success === true, 'Mistral Vibe reinstall/upgrade succeeds over existing skills');
+    assert(await fs.pathExists(skillFile31), 'Mistral Vibe reinstall preserves SKILL.md output');
+  } catch (error) {
+    assert(false, 'Mistral Vibe native skills test succeeds', error.message);
+  } finally {
+    if (tempProjectDir31) await fs.remove(tempProjectDir31).catch(() => {});
+    if (installedBmadDir31) await fs.remove(installedBmadDir31).catch(() => {});
+  }
+
+  console.log('');
+
   // ============================================================
   // Summary
   // ============================================================

tools/cli/installers/lib/ide/platform-codes.yaml

@@ -176,6 +176,16 @@ platforms:
       template_type: kiro
       skill_format: true
 
+  mistral:
+    name: "Mistral Vibe"
+    preferred: false
+    category: cli
+    description: "Mistral's AI coding CLI"
+    installer:
+      target_dir: .vibe/skills
+      template_type: default
+      skill_format: true
+
   opencode:
     name: "OpenCode"
     preferred: false