@wonderwhy-er/desktop-commander/dist/utils/open-browser.js

MCP server for terminal operations and file editing

import { execFile, spawn } from 'child_process';
import os from 'os';
import { logToStderr } from './logger.js';
/**
 * Open a URL in the default browser (cross-platform)
 * Uses execFile/spawn with args array to avoid shell injection
 */
export async function openBrowser(url) {
    const platform = os.platform();
    return new Promise((resolve, reject) => {
        const callback = (error) => {
            if (error) {
                logToStderr('error', `Failed to open browser: ${error.message}`);
                reject(error);
            }
            else {
                logToStderr('info', `Opened browser to: ${url}`);
                resolve();
            }
        };
        switch (platform) {
            case 'darwin':
                execFile('open', [url], callback);
                break;
            case 'win32':
                // Windows 'start' is a shell builtin, use spawn with shell but pass URL as separate arg
                spawn('cmd', ['/c', 'start', '', url], { shell: false, windowsHide: true }).on('close', (code) => {
                    code === 0 ? resolve() : reject(new Error(`Exit code ${code}`));
                });
                break;
            default:
                execFile('xdg-open', [url], callback);
                break;
        }
    });
}
/**
 * Open the Desktop Commander welcome page
 */
export async function openWelcomePage(clientName) {
    // utm_source is auto-captured by the welcome page's PostHog (and GA4), so
    // web analytics can segment by MCP client without any web-side changes.
    const url = 'https://desktopcommander.app/welcome/'
        + (clientName ? `?utm_source=${encodeURIComponent(clientName)}` : '');
    await openBrowser(url);
}