Beautiful, AI-native markdown IDE and LLM wiki
TypeScript 2nd-brainagent-skillsclaudecodexcompany-braindocsknowledge-knowledge-baseknowledge-managementllmllm-wikillm-wiki-karpathymarkdownmarkdown-editormdmdxnotespkmsecond-brainskills
import type { ReactNode } from 'react';
import type { SerializerApi } from '@/lib/mdx-serializer';
const WEB_APP_GUIDE_HREF = '/docs/get-started/quickstart#ok-install-web-app';
interface McpInstallMarkdownApi extends Pick<SerializerApi, 'url'> {
link(label: string, url: string): string;
}
export function mcpInstallMarkdown(editor: string, api: McpInstallMarkdownApi): string {
return [
`There are two ways to connect ${editor}, depending on how you run OpenKnowledge:`,
'',
`- **Desktop app** (macOS, Windows, Linux). The first time you open a project, a consent dialog detects ${editor} and configures it for you. To re-trigger the dialog, choose **File → Set up OpenKnowledge integrations…**.`,
`- **Web app / terminal** (any platform, including Intel Macs — see the ${api.link('web app guide', api.url(WEB_APP_GUIDE_HREF))}). Run \`ok init\` in your project: it registers the OpenKnowledge MCP server with ${editor} and the other editors it detects. Every \`ok start\` repairs the entry if it has drifted (it never adds one you removed).`,
].join('\n');
}
export function McpInstall({ editor, children }: { editor: string; children?: ReactNode }) {
return (
<>
<p>There are two ways to connect {editor}, depending on how you run OpenKnowledge:</p>
<ul>
<li>
<strong>Desktop app</strong> (macOS, Windows, Linux). The first time you open a project, a
consent dialog detects {editor} and configures it for you. To re-trigger the dialog,
choose{' '}
{/* oxlint-disable-next-line ok/microcopy-ellipsis -- quoting the literal menu label (menu.ts) */}
<strong>File → Set up OpenKnowledge integrations…</strong>.
</li>
<li>
<strong>Web app / terminal</strong> (any platform, including Intel Macs — see the{' '}
<a href={WEB_APP_GUIDE_HREF}>web app guide</a>
). Run <code>ok init</code> in your project: it registers the OpenKnowledge MCP server
with {editor} and the other editors it detects. Every <code>ok start</code> repairs the
entry if it has drifted (it never adds one you removed).
</li>
</ul>
{children}
</>
);
}