Beautiful, AI-native markdown IDE and LLM wiki
TypeScript 2nd-brainagent-skillsclaudecodexcompany-braindocsknowledge-knowledge-baseknowledge-managementllmllm-wikillm-wiki-karpathymarkdownmarkdown-editormdmdxnotespkmsecond-brainskills
import type { spawn as NativeSpawn } from 'node:child_process';
import { DESKTOP_PRODUCTS } from '@inkeep/open-knowledge-core';
import {
type SpawnDetachedScrubbedOutcome,
spawnDetachedScrubbedAndWait,
} from './detached-spawn.ts';
export interface OpenTargetOptions {
platform?: NodeJS.Platform;
spawn?: typeof NativeSpawn;
env?: NodeJS.ProcessEnv;
timeoutMs?: number;
desktopBundlePath?: string;
}
interface OpenInvocation {
command: string;
args: readonly string[];
}
function isDesktopDeepLink(target: string): boolean {
return Object.values(DESKTOP_PRODUCTS).some(({ protocolScheme }) =>
target.startsWith(`${protocolScheme}://`),
);
}
function resolveOpenInvocation(
target: string,
platform: NodeJS.Platform,
desktopBundlePath?: string,
): OpenInvocation {
if (platform === 'darwin') {
if (desktopBundlePath && isDesktopDeepLink(target)) {
return { command: '/usr/bin/open', args: ['-a', desktopBundlePath, target] };
}
return { command: '/usr/bin/open', args: [target] };
}
if (platform === 'win32') {
if (target.startsWith('http://') || target.startsWith('https://')) {
return { command: 'explorer.exe', args: [target] };
}
return {
command: 'rundll32.exe',
args: ['url.dll,FileProtocolHandler', target],
};
}
return { command: 'xdg-open', args: [target] };
}
export function openTarget(
target: string,
options: OpenTargetOptions = {},
): Promise<SpawnDetachedScrubbedOutcome> {
const invocation = resolveOpenInvocation(
target,
options.platform ?? process.platform,
options.desktopBundlePath,
);
return spawnDetachedScrubbedAndWait(invocation.command, invocation.args, {
spawn: options.spawn,
env: options.env,
timeoutMs: options.timeoutMs,
});
}
export function openTargetFailureMessage(
reason: Exclude<SpawnDetachedScrubbedOutcome, { ok: true }>['reason'],
target: string,
platform: NodeJS.Platform = process.platform,
): string {
const launcher = resolveOpenInvocation(target, platform).command;
switch (reason) {
case 'not-installed':
return `${launcher} is not installed or cannot be executed`;
case 'timeout':
return `${launcher} did not start in time`;
case 'spawn-error':
return `${launcher} could not be started`;
}
}