@mintlify/cli 4.0.1762 → 4.0.1763

package/bin/agent-setup.js

@@ -0,0 +1,146 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { checkbox } from '@inquirer/prompts';
+import { spawn } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { stripVTControlCharacters } from 'node:util';
+import { ADMIN_MCP_NAME, ADMIN_MCP_URL, prepareMcpConfig, writeMcpConfig, } from './agent-setup-config.js';
+import { detectAgent } from './agent.js';
+export const SETUP_AGENTS = ['claude-code', 'codex', 'cursor'];
+const AGENT_LABELS = {
+    'claude-code': 'Claude Code',
+    codex: 'Codex',
+    cursor: 'Cursor',
+};
+function isSetupAgent(value) {
+    return SETUP_AGENTS.some((agent) => agent === value);
+}
+function detectedAgents() {
+    const homeDir = os.homedir();
+    const current = detectAgent();
+    return SETUP_AGENTS.filter((agent) => {
+        if (agent === 'codex') {
+            return (current === 'codex_cli' ||
+                existsSync(process.env.CODEX_HOME || path.join(homeDir, '.codex')));
+        }
+        if (agent === 'claude-code') {
+            return (current === 'claude_code' ||
+                existsSync(process.env.CLAUDE_CONFIG_DIR || path.join(homeDir, '.claude')));
+        }
+        return (current === 'cursor' || current === 'cursor-cli' || existsSync(path.join(homeDir, '.cursor')));
+    });
+}
+export function installSkills(agents, global) {
+    const args = [
+        '--yes',
+        'skills@1.7.4',
+        'add',
+        'https://mintlify.com/docs',
+        '--agent',
+        ...agents,
+        '--yes',
+    ];
+    if (global)
+        args.push('--global');
+    return new Promise((resolve, reject) => {
+        const child = spawn('npx', args, {
+            stdio: ['ignore', 'pipe', 'pipe'],
+            shell: process.platform === 'win32',
+        });
+        let output = '';
+        const recordOutput = (chunk) => {
+            output = (output + chunk.toString()).slice(-65536);
+        };
+        child.stdout.on('data', (chunk) => {
+            recordOutput(chunk);
+            process.stdout.write(chunk.toString());
+        });
+        child.stderr.on('data', (chunk) => {
+            recordOutput(chunk);
+            process.stderr.write(chunk.toString());
+        });
+        child.on('error', () => reject(new Error('Could not run npx. Install npm and run setup again.')));
+        child.on('close', (code, signal) => {
+            if (code !== 0 || /Failed to install\s+\d+/.test(stripVTControlCharacters(output))) {
+                reject(new Error(`Skills installation failed (${signal !== null && signal !== void 0 ? signal : code}). Review the installer output and run setup again.`));
+            }
+            else {
+                resolve();
+            }
+        });
+    });
+}
+export function setupAgent(options) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        const [major = 0, minor = 0] = process.versions.node.split('.').map(Number);
+        if (major < 22 || (major === 22 && minor < 20)) {
+            throw new Error('mint agent setup requires Node.js 22.20 or later to install skills. Upgrade Node.js and try again.');
+        }
+        const interactive = Boolean(process.stdin.isTTY && process.stdout.isTTY);
+        let agents = [];
+        for (const agent of (_a = options.agents) !== null && _a !== void 0 ? _a : []) {
+            if (!isSetupAgent(agent))
+                throw new Error(`Unsupported agent: ${agent}`);
+            if (!agents.includes(agent))
+                agents.push(agent);
+        }
+        if (agents.length === 0) {
+            const detected = detectedAgents();
+            if (!interactive) {
+                agents = detected;
+            }
+            else {
+                agents = yield checkbox({
+                    message: 'Which agents should use Mintlify?',
+                    choices: SETUP_AGENTS.map((agent) => ({
+                        name: AGENT_LABELS[agent],
+                        value: agent,
+                        checked: detected.includes(agent),
+                    })),
+                    required: true,
+                });
+            }
+        }
+        if (agents.length === 0) {
+            throw new Error('No supported agents detected. Pass --agent claude-code, codex, or cursor.');
+        }
+        const location = { cwd: process.cwd(), homeDir: os.homedir(), global: options.global };
+        const plans = yield Promise.all(agents.map((agent) => prepareMcpConfig(agent, location)));
+        const scope = options.global ? 'your user account' : 'this project';
+        process.stdout.write(`Setting up Mintlify skills and Admin MCP for ${scope}.\n`);
+        yield installSkills(agents, options.global);
+        for (const plan of plans) {
+            yield writeMcpConfig(plan);
+            const action = plan.contents === undefined ? 'Already configured' : 'Configured';
+            process.stdout.write(`${action}: ${plan.path}\n`);
+        }
+        process.stdout.write('\nAdmin MCP is configured. Complete OAuth sign-in to grant account and project access:\n');
+        for (const agent of agents) {
+            if (agent === 'codex') {
+                let command = `codex mcp login ${ADMIN_MCP_NAME}`;
+                if (!options.global) {
+                    const config = `mcp_servers.${ADMIN_MCP_NAME}.url='${ADMIN_MCP_URL}'`;
+                    command = `codex -c "${config}" mcp login ${ADMIN_MCP_NAME}`;
+                }
+                process.stdout.write(`  Codex: run ${command}. Trust the project before using its MCP configuration.\n`);
+            }
+            else if (agent === 'claude-code') {
+                process.stdout.write(`  Claude Code: open /mcp and authenticate ${ADMIN_MCP_NAME}. Approve the project server if prompted.\n`);
+            }
+            else {
+                process.stdout.write(`  Cursor: open MCP settings and connect ${ADMIN_MCP_NAME}.\n`);
+            }
+        }
+        process.stdout.write('Setup: https://mintlify.com/docs/ai/mintlify-mcp\n');
+    });
+}

package/bin/cli.js

@@ -16,6 +16,7 @@ import { hideBin } from 'yargs/helpers';
 import { accessibilityCheck } from './accessibilityCheck.js';
 import { addDomain } from './addDomain.js';
 import { claimDeployment, createAgentClaimLink } from './agent-claim.js';
+import { SETUP_AGENTS, setupAgent } from './agent-setup.js';
 import { analyticsBuilder } from './analytics/index.js';
 import { brokenLinksHandler } from './brokenLinks.js';
 import { comingSoon } from './comingSoon.js';
@@ -100,6 +101,35 @@ export const cli = ({ packageName = 'mint' }) => {
         .middleware(checkNodeVersion)
         .middleware(suppressConsoleWarnings)
         .middleware(telemetryMiddleware)
+        .command('agent', 'Set up AI coding agents for Mintlify', (yargs) => yargs
+        .command('setup', 'Install Mintlify skills and configure Admin MCP', (yargs) => yargs
+        .exitProcess(false)
+        .option('agent', {
+        alias: 'a',
+        type: 'string',
+        array: true,
+        choices: SETUP_AGENTS,
+        description: 'Agents to configure (defaults to interactive selection)',
+    })
+        .option('global', {
+        alias: 'g',
+        type: 'boolean',
+        default: false,
+        description: 'Set up agents for your user account instead of this project',
+    })
+        .example('$0 agent setup', 'Choose agents and set up the current project')
+        .example('$0 agent setup --agent codex --global', 'Set up Codex for your user account')
+        .epilog('Requires Node.js 22.20 or later and npm. Admin MCP requires a separate OAuth sign-in in each agent.'), (argv) => __awaiter(void 0, void 0, void 0, function* () {
+        try {
+            yield setupAgent({ agents: argv.agent, global: argv.global });
+            yield terminate(0);
+        }
+        catch (error) {
+            process.stderr.write(`${error instanceof Error ? error.message : 'Agent setup failed.'}\n`);
+            yield terminate(1);
+        }
+    }))
+        .demandCommand(1, 'Run mint agent setup to configure your coding agents.'))
         .command('claim', 'Claim a site created with mint deploy', (yargs) => yargs
         .option('email', { type: 'string', description: 'User email for a claim link' })
         .option('code', {