Beautiful, AI-native markdown IDE and LLM wiki
TypeScript 2nd-brainagent-skillsclaudecodexcompany-braindocsknowledge-knowledge-baseknowledge-managementllmllm-wikillm-wiki-karpathymarkdownmarkdown-editormdmdxnotespkmsecond-brainskills
Rework first-launch MCP consent dialog copy and tool links (#2481)
sarah3f98bf4e9188
diff --git a/.changeset/connect-ai-tools-consent-dialog.md b/.changeset/connect-ai-tools-consent-dialog.mdnew file mode 100644index 000000000..f01d9549b--- /dev/null+++ b/.changeset/connect-ai-tools-consent-dialog.md@@ -0,0 +1,5 @@+---+"@inkeep/open-knowledge": patch+---++Reworked the first-launch "Connect your AI tools to OpenKnowledge" consent dialog. The description copy is now plain-language instead of listing internal implementation details, undetected editors show a "How to set up" link to their integration docs, and the shell-PATH rc-file detail moved into an info tooltip.diff --git a/packages/app/src/components/McpConsentDialog.dom.test.tsx b/packages/app/src/components/McpConsentDialog.dom.test.tsxindex d1436ede6..d9d1a5e2a 100644--- a/packages/app/src/components/McpConsentDialog.dom.test.tsx+++ b/packages/app/src/components/McpConsentDialog.dom.test.tsx@@ -115,14 +115,21 @@ describe('McpConsentDialog runtime behavior', () => {test('renders willReplace disclosure and preselects detected editors only', async () => {await renderDialog();- expect(screen.getByRole('dialog', { name: 'Add OpenKnowledge to your AI tools' })).toBeTruthy();+ expect(+ screen.getByRole('dialog', { name: 'Connect your AI tools to OpenKnowledge' }),+ ).toBeTruthy();expect(screen.getByTestId('mcp-consent-status-claude').textContent).toBe('Will replace existing OpenKnowledge entry',);- expect(screen.getByTestId('mcp-consent-status-cursor').textContent).toBe(- 'Detected on this machine',+ // Detected tools carry no status line — the checked box conveys it.+ expect(screen.queryByTestId('mcp-consent-status-cursor')).toBeNull();+ // Undetected tools link to their OpenKnowledge setup guide instead.+ const codexStatus = screen.getByTestId('mcp-consent-status-codex');+ expect(codexStatus.tagName).toBe('A');+ expect(codexStatus.textContent).toContain('How to set up');+ expect(codexStatus.getAttribute('href')).toBe(+ 'https://openknowledge.ai/docs/integrations/codex',);- expect(screen.getByTestId('mcp-consent-status-codex').textContent).toBe('Not detected');expect(screen.getByTestId('mcp-consent-checkbox-claude').getAttribute('aria-checked')).toBe('true',);@@ -134,6 +141,28 @@ describe('McpConsentDialog runtime behavior', () => {);});+ test('undetected claude-desktop links to the shared claude-code guide (aliased slug)', async () => {+ // claude-desktop → claude-code is the only non-1:1 entry in+ // EDITOR_SETUP_DOC_SLUG; a regression to `editor.id` in the URL would 404.+ await renderDialog(+ makeHarness({+ snapshot: {+ detectedEditors: [+ { id: 'claude-desktop', label: 'Claude Desktop', detected: false, willReplace: false },+ ],+ pathInstall: { shellDetected: false, rcFilesToTouch: [], alreadyInstalled: false },+ globalSkills: [],+ },+ }),+ );++ const status = screen.getByTestId('mcp-consent-status-claude-desktop');+ expect(status.tagName).toBe('A');+ expect(status.getAttribute('href')).toBe(+ 'https://openknowledge.ai/docs/integrations/claude-code',+ );+ });+test('failed Add resets busy state, reports the error, and allows retry', async () => {const first = deferredResult();const second = deferredResult();@@ -157,7 +186,7 @@ describe('McpConsentDialog runtime behavior', () => {});expect(skip.disabled).toBe(false);- expect(add.textContent).toBe('Add');+ expect(add.textContent).toBe('Connect');expect(harness.confirmCalls).toEqual([{ editorIds: ['claude', 'cursor'], pathInstall: true }]);expect(harness.toastErrors).toEqual(['Could not write Claude config']);@@ -207,27 +236,25 @@ describe('McpConsentDialog runtime behavior', () => {describe('McpConsentDialog PATH consent row', () => {afterEach(() => cleanup());- test('PATH section is pinned outside the scrollable editor list', async () => {- // The editor list can outgrow the dialog (DialogBody is the overflow- // container); the PATH toggle must stay visible without scrolling, so- // it lives in its own section ABOVE that container.- await renderDialog();-- const pathCheckbox = screen.getByTestId('mcp-consent-path-checkbox');- expect(pathCheckbox.closest('[class*="overflow-y-auto"]')).toBeNull();- const editorCheckbox = screen.getByTestId('mcp-consent-checkbox-claude');- expect(editorCheckbox.closest('[class*="overflow-y-auto"]')).not.toBeNull();- });-test('renders pre-checked with the rc-file disclosure; warning appears only when unchecked', async () => {await renderDialog();const checkbox = screen.getByTestId('mcp-consent-path-checkbox');expect(checkbox.getAttribute('aria-checked')).toBe('true');expect(checkbox.hasAttribute('disabled')).toBe(false);- expect(screen.getByTestId('mcp-consent-path-status').textContent).toBe(- 'Adds a managed block to ~/.zshrc, ~/.config/fish/conf.d/open-knowledge.fish',- );+ // The rc-file disclosure is behind an info tooltip; it mounts (portaled)+ // only once the trigger is focused/hovered.+ expect(screen.queryAllByTestId('mcp-consent-path-status')).toHaveLength(0);+ screen.getByTestId('mcp-consent-path-info').focus();+ // Radix renders TooltipContent twice when open — the visible portal copy+ // plus a visually-hidden mirror for the aria-describedby association — so+ // both carry the testid. Assert against the first match, not getByTestId.+ await waitFor(() => {+ const [status] = screen.getAllByTestId('mcp-consent-path-status');+ expect(status?.textContent).toBe(+ 'Adds a managed block to ~/.zshrc, ~/.config/fish/conf.d/open-knowledge.fish',+ );+ });// Warning is uncheck-scoped: it names the real degradation (external// terminals only) at the moment the user is making that choice.expect(screen.queryByTestId('mcp-consent-path-warning')).toBeNull();diff --git a/packages/app/src/components/McpConsentDialogBody.tsx b/packages/app/src/components/McpConsentDialogBody.tsxindex 63e3a4087..7899ff2f8 100644--- a/packages/app/src/components/McpConsentDialogBody.tsx+++ b/packages/app/src/components/McpConsentDialogBody.tsx@@ -9,8 +9,8 @@* behavior (routed through `onOpenChange(false)` → skip()).** The dialog also gates the shell-PATH install: a distinct pre-checked- * toggle in its own "Terminal" section pinned above the scrollable editor- * list, driven by `payload.pathInstall`. Hidden when no rc file is+ * toggle in its own "Terminal" section, rendered first in the scrollable+ * body above the editor list, driven by `payload.pathInstall`. Hidden when no rc file is* touchable; informational when the managed block is already on disk /* consent already granted. Unchecking degrades only `ok` in EXTERNAL* terminals — OpenKnowledge's built-in terminal injects `~/.ok/bin` itself@@ -18,7 +18,9 @@* that.*/+import { EDITOR_SETUP_DOC_SLUG } from '@inkeep/open-knowledge-core';import { Trans, useLingui } from '@lingui/react/macro';+import { ArrowUpRight, Info } from 'lucide-react';import { useId, useState } from 'react';import { toast as sonnerToast } from 'sonner';import { Button } from '@/components/ui/button';@@ -33,8 +35,11 @@ import {DialogTitle,} from '@/components/ui/dialog';import { Label } from '@/components/ui/label';+import { Tooltip, TooltipContent, TooltipProvider, TooltipTrigger } from '@/components/ui/tooltip';import type { OkMcpWiringEditorId, OkMcpWiringShowPayload } from '@/lib/desktop-bridge-types';+import { dispatchExternalLinkClick } from '@/lib/external-link';import { type McpConsentStore, mcpConsentStore } from '@/lib/mcp-consent-store';+import { cn } from '@/lib/utils';type EditorDetection = OkMcpWiringShowPayload['detectedEditors'][number];type PathInstallDescriptor = OkMcpWiringShowPayload['pathInstall'];@@ -247,207 +252,265 @@ function McpConsentDialogForm({ payload, store, toast }: McpConsentDialogFormPro<DialogContent className="sm:max-w-md"><DialogHeader><DialogTitle>- <Trans>Add OpenKnowledge to your AI tools</Trans>+ <Trans>Connect your AI tools to OpenKnowledge</Trans></DialogTitle><DialogDescription><Trans>- OpenKnowledge manages the <code>open-knowledge</code> MCP server name, the{' '}- <code>open-knowledge-ui</code> launch config, and <code>ok</code> /{' '}- <code>open-knowledge</code> on PATH (including OK-owned symlinks). Using a custom- wrapper? Register it under a different name.+ Give the AI tools you use access to read and update your projects. Pick what to set up+ below, and change it anytime.</Trans></DialogDescription></DialogHeader>- {/*- * Shell-PATH consent section — its own pinned block ABOVE the- * scrollable editor list (DialogBody is the overflow container; a- * row inside it sits below the fold on machines with many editors).- * Distinct from the per-editor MCP checkboxes because the two- * decisions are independent (MCP runs over npx / the bundle- * wrapper, never bare `ok`). Hidden when no rc file is touchable;- * informational when a managed block is already on disk or consent- * was already granted.- */}- {pathInstall.shellDetected && (- <div className="flex flex-col gap-1.5">- <span className="text-xs font-medium text-muted-foreground">- <Trans comment="Section label above the shell-PATH toggle in the first-launch dialog">- Terminal- </Trans>- </span>- <div className="overflow-hidden rounded-md border border-border bg-card/50">- <Label- htmlFor={`${idPrefix}-path`}- className={- pathActionable- ? 'flex cursor-pointer items-start gap-2.5 px-3 py-2.5 font-normal hover:bg-accent'- : 'flex items-start gap-2.5 px-3 py-2.5 font-normal'- }- >- <Checkbox- id={`${idPrefix}-path`}- checked={pathActionable ? pathChecked : true}- disabled={busy || !pathActionable}- onCheckedChange={() => setPathChecked((prev) => !prev)}- className="mt-0.5"- data-testid="mcp-consent-path-checkbox"- />- <span className="flex min-w-0 flex-1 flex-col gap-0.5">- <span className="text-sm font-medium text-foreground">- <Trans comment="Toggle in the first-launch dialog that adds the ok CLI to the user's shell PATH">- Add the <code>ok</code> command to your terminal- </Trans>- </span>- <span- className="text-xs text-muted-foreground"- data-testid="mcp-consent-path-status"- >- {pathActionable- ? t`Adds a managed block to ${pathInstall.rcFilesToTouch.join(', ')}`- : t`Already set up — ok is available in your terminal`}+ <DialogBody className="flex flex-col gap-6 min-h-0">+ {/*+ * Shell-PATH consent section — rendered first inside the scrollable+ * DialogBody, above the editor list. Distinct from the per-editor+ * MCP checkboxes because the two decisions are independent (MCP runs+ * over npx / the bundle wrapper, never bare `ok`). Hidden when no rc+ * file is touchable; informational when a managed block is already+ * on disk or consent was already granted.+ */}+ {pathInstall.shellDetected && (+ <div className="flex flex-col gap-1.5">+ <span className="text-xs font-medium text-muted-foreground">+ <Trans comment="Section label above the shell-PATH toggle in the first-launch dialog">+ Terminal+ </Trans>+ </span>+ <div className="overflow-hidden rounded-md border border-border bg-card/50">+ <Label+ htmlFor={`${idPrefix}-path`}+ // items-start overrides the shadcn Label base `items-center`,+ // which on a flex column would center every child horizontally.+ className={+ pathActionable+ ? 'flex cursor-pointer flex-col items-start gap-1 px-3 py-2.5 font-normal hover:bg-accent'+ : 'flex flex-col items-start gap-1 px-3 py-2.5 font-normal'+ }+ >+ {/* Checkbox centered against the title line only (not the whole+ column) so the `ok` code chip — taller than plain text — can't+ push it out of alignment. Subtexts sit below, indented to align+ under the title (checkbox size-4 = 1rem + gap-2.5 = 0.625rem). */}+ <span className="flex items-center gap-2.5">+ <Checkbox+ id={`${idPrefix}-path`}+ checked={pathActionable ? pathChecked : true}+ disabled={busy || !pathActionable}+ onCheckedChange={() => setPathChecked((prev) => !prev)}+ data-testid="mcp-consent-path-checkbox"+ />+ <span className="flex min-w-0 flex-1 items-center gap-1.5 text-sm font-medium text-foreground">+ <Trans comment="Toggle in the first-launch dialog that adds the ok CLI to the user's shell PATH">+ Add the <code className="inline-code">ok</code> command to your terminal+ </Trans>+ {pathActionable && (+ <TooltipProvider>+ <Tooltip>+ {/* Nested inside the row <Label>, so stop the click from+ bubbling to toggle the checkbox. Radix opens the+ tooltip on hover/focus, not click, so preventing the+ click default costs nothing. */}+ <TooltipTrigger+ onClick={(e) => {+ e.preventDefault();+ e.stopPropagation();+ }}+ className="text-muted-foreground hover:text-foreground"+ aria-label={t`What this changes`}+ data-testid="mcp-consent-path-info"+ >+ <Info className="size-3.5" aria-hidden />+ </TooltipTrigger>+ <TooltipContent className="max-w-xs">+ <p+ className="leading-relaxed wrap-break-word"+ data-testid="mcp-consent-path-status"+ >+ {t`Adds a managed block to ${pathInstall.rcFilesToTouch.join(', ')}`}+ </p>+ </TooltipContent>+ </Tooltip>+ </TooltipProvider>+ )}+ </span></span>+ {!pathActionable && (+ <span+ className="ps-6.5 text-xs text-muted-foreground"+ data-testid="mcp-consent-path-status"+ >+ {t`Already set up — ok is available in your terminal`}+ </span>+ )}{pathActionable && !pathChecked && (<span- className="text-xs text-amber-600 dark:text-amber-400"+ className="ps-6.5 text-xs text-amber-600 dark:text-amber-400"data-testid="mcp-consent-path-warning"><Trans comment="Warning shown when the user unchecks the PATH toggle — only external terminals degrade">- <code>ok</code> won't run in external terminals until you add it later from- the File menu. OpenKnowledge's built-in terminal and AI tools keep working.+ <code className="inline-code">ok</code> won't run in external terminals+ until you add it later from the File menu. OpenKnowledge's built-in terminal+ and AI tools keep working.</Trans></span>)}- </span>- </Label>- </div>- </div>- )}-- <DialogBody>- {/* Group label only when the Terminal section renders above —- with a single group there is nothing to distinguish. */}- {pathInstall.shellDetected && (- <div className="mb-1.5 text-xs font-medium text-muted-foreground">- <Trans comment="Section label above the editor checkbox list in the first-launch dialog">- AI tools- </Trans>+ </Label>+ </div></div>)}- <ul className="rounded-md border border-border bg-card/50 divide-y divide-border overflow-hidden">- {detectedEditors.map((editor) => {- const checked = selection.has(editor.id);- const checkboxId = `${idPrefix}-${editor.id}`;- // Per-editor disclosure when Add will overwrite the desktop-owned- // open-knowledge namespace. Any existing entry under that name is- // reclaimed; custom wrappers should use a different MCP server name.- const statusLabel = editor.willReplace- ? t`Will replace existing OpenKnowledge entry`- : editor.detected- ? t`Detected on this machine`- : t`Not detected`;- const statusClass = editor.willReplace- ? 'text-xs text-amber-600 dark:text-amber-400'- : 'text-xs text-muted-foreground';- return (- <li key={editor.id}>- <Label- htmlFor={checkboxId}- className="flex cursor-pointer items-start gap-2.5 px-3 py-2.5 font-normal hover:bg-accent"- >- <Checkbox- id={checkboxId}- checked={checked}- disabled={busy}- onCheckedChange={() => onToggle(editor.id)}- className="mt-0.5"- data-testid={`mcp-consent-checkbox-${editor.id}`}- />- <span className="flex min-w-0 flex-1 flex-col gap-0.5">- <span className="text-sm font-medium text-foreground">{editor.label}</span>- <span className={statusClass} data-testid={`mcp-consent-status-${editor.id}`}>- {statusLabel}- </span>- </span>- </Label>- </li>- );- })}- </ul>- </DialogBody>-- {/*- * User-global Agent Skills consent section — one pre-checked row per- * bundle. Distinct from the editor list because skills install to every- * detected host by design (not per-editor). Unchecking an already-- * installed bundle removes it; the decision is honored by every install- * actor (desktop reclaim, ok init, ok start).- */}- {skillsOffered && (<div className="flex flex-col gap-1.5">- <span className="text-xs font-medium text-muted-foreground">- <Trans comment="Section label above the skill checkboxes in the first-launch dialog">- Agent Skills- </Trans>- </span>+ {/* Group label only when the Terminal section renders above —+ with a single group there is nothing to distinguish. */}+ {pathInstall.shellDetected && (+ <div className="text-xs font-medium text-muted-foreground">+ <Trans comment="Section label above the editor checkbox list in the first-launch dialog — each row wires OpenKnowledge's MCP server into that tool">+ MCP connections+ </Trans>+ </div>+ )}<ul className="rounded-md border border-border bg-card/50 divide-y divide-border overflow-hidden">- {globalSkills.map((skill) => {- const checked = skillSelection.has(skill.id);- const checkboxId = `${idPrefix}-skill-${skill.id}`;+ {detectedEditors.map((editor) => {+ const checked = selection.has(editor.id);+ const checkboxId = `${idPrefix}-${editor.id}`;+ const setupUrl = `https://openknowledge.ai/docs/integrations/${EDITOR_SETUP_DOC_SLUG[editor.id]}`;return (- <li key={skill.id}>+ // Padding lives on the interactive children, not the <li>, so the+ // <Label> owns the full row width (flex-1) and height (py-2.5) —+ // the whole name area toggles, and only the link is excluded. The+ // link/status are siblings OUTSIDE the label (an anchor must never+ // be a label descendant). flex-wrap: the link drops to its own line+ // on narrow widths; willReplace uses basis-full to always sit below.+ <li key={editor.id} className="flex flex-wrap items-stretch hover:bg-accent"><LabelhtmlFor={checkboxId}- className="flex cursor-pointer items-start gap-2.5 px-3 py-2.5 font-normal hover:bg-accent"+ className={cn(+ 'flex flex-1 cursor-pointer items-center gap-2.5 px-3 py-2.5 font-normal',+ editor.willReplace ? 'pb-0.5' : '',+ )}><Checkboxid={checkboxId}checked={checked}disabled={busy}- onCheckedChange={() =>- setSkillSelection((prev) => toggleSkillId(prev, skill.id))- }- className="mt-0.5"- data-testid={`mcp-consent-skill-checkbox-${skill.id}`}+ onCheckedChange={() => onToggle(editor.id)}+ data-testid={`mcp-consent-checkbox-${editor.id}`}/>- <span className="flex min-w-0 flex-1 flex-col gap-0.5">- <span className="text-sm font-medium text-foreground">- <code>{skill.name}</code>- </span>- <span- className="text-xs text-muted-foreground"- data-testid={`mcp-consent-skill-status-${skill.id}`}- >- {skill.id === 'discovery' ? (- <Trans comment="Subtext for the open-knowledge-discovery skill row">- Helps your coding agent recognize OpenKnowledge projects and route- reads and writes through it.- </Trans>- ) : (- <Trans comment="Subtext for the open-knowledge-write-skill skill row">- Adds a guided workflow for authoring new Agent Skills.- </Trans>- )}- </span>- {skill.alreadyInstalled && !checked && (- <span- className="text-xs text-amber-600 dark:text-amber-400"- data-testid={`mcp-consent-skill-warning-${skill.id}`}- >- <Trans comment="Warning shown when the user unchecks an already-installed skill">- Removes this skill from your editors.- </Trans>- </span>- )}- </span>+ <span className="text-sm font-medium text-foreground">{editor.label}</span></Label>+ {/* Detected tools need no trailing line — the checked box says it.+ willReplace warns Add will overwrite an existing OK-managed entry+ (reclaimed by name); basis-full drops it to its own line below the+ name (ms-6.5 + px-3 = the row inset + checkbox 1rem + gap 0.625rem+ aligns it under the label). Undetected tools link to their setup+ guide, right-aligned, instead of a dead-end "Not detected". */}+ {editor.willReplace ? (+ <span+ className="ms-6.5 basis-full px-3 pb-2.5 text-xs text-amber-600 dark:text-amber-400"+ data-testid={`mcp-consent-status-${editor.id}`}+ >+ <Trans comment="Disclosure that Add will overwrite the tool's existing OpenKnowledge MCP entry">+ Will replace existing OpenKnowledge entry+ </Trans>+ </span>+ ) : editor.detected ? null : (+ <a+ href={setupUrl}+ target="_blank"+ rel="noopener noreferrer"+ onClick={(e) => dispatchExternalLinkClick(e, setupUrl)}+ onAuxClick={(e) => dispatchExternalLinkClick(e, setupUrl)}+ // Per-tool name so a screen-reader link list distinguishes rows+ // (2.4.4); contains the visible text (2.5.3) and flags the+ // new-tab behavior the arrow icon shows sighted users.+ aria-label={t`How to set up ${editor.label} (opens in browser)`}+ className="flex items-center gap-0.5 px-3 py-2.5 text-xs text-muted-foreground underline-offset-2 hover:text-foreground hover:underline"+ data-testid={`mcp-consent-status-${editor.id}`}+ >+ <Trans comment="Link on an undetected tool row to its OpenKnowledge setup guide">+ How to set up+ </Trans>+ <ArrowUpRight className="size-3" aria-hidden />+ </a>+ )}</li>);})}</ul></div>- )}-+ {/*+ * User-global Agent Skills consent section — one pre-checked row per+ * bundle. Distinct from the editor list because skills install to every+ * detected host by design (not per-editor). Unchecking an already-+ * installed bundle removes it; the decision is honored by every install+ * actor (desktop reclaim, ok init, ok start).+ */}+ {skillsOffered && (+ <div className="flex flex-col gap-1.5">+ <span className="text-xs font-medium text-muted-foreground">+ <Trans comment="Section label above the skill checkboxes in the first-launch dialog">+ Agent Skills+ </Trans>+ </span>+ <ul className="rounded-md border border-border bg-card/50 divide-y divide-border overflow-hidden">+ {globalSkills.map((skill) => {+ const checked = skillSelection.has(skill.id);+ const checkboxId = `${idPrefix}-skill-${skill.id}`;+ return (+ <li key={skill.id}>+ <Label+ htmlFor={checkboxId}+ className="flex cursor-pointer items-start gap-2.5 px-3 py-2.5 font-normal hover:bg-accent"+ >+ <Checkbox+ id={checkboxId}+ checked={checked}+ disabled={busy}+ onCheckedChange={() =>+ setSkillSelection((prev) => toggleSkillId(prev, skill.id))+ }+ className="mt-0.5"+ data-testid={`mcp-consent-skill-checkbox-${skill.id}`}+ />+ <span className="flex min-w-0 flex-1 flex-col gap-0.5">+ <span className="text-sm font-medium text-foreground">+ <code>{skill.name}</code>+ </span>+ <span+ className="text-xs text-muted-foreground"+ data-testid={`mcp-consent-skill-status-${skill.id}`}+ >+ {skill.id === 'discovery' ? (+ <Trans comment="Subtext for the open-knowledge-discovery skill row">+ Helps your coding agent recognize OpenKnowledge projects and route+ reads and writes through it.+ </Trans>+ ) : (+ <Trans comment="Subtext for the open-knowledge-write-skill skill row">+ Adds a guided workflow for authoring new Agent Skills.+ </Trans>+ )}+ </span>+ {skill.alreadyInstalled && !checked && (+ <span+ className="text-xs text-amber-600 dark:text-amber-400"+ data-testid={`mcp-consent-skill-warning-${skill.id}`}+ >+ <Trans comment="Warning shown when the user unchecks an already-installed skill">+ Removes this skill from your editors.+ </Trans>+ </span>+ )}+ </span>+ </Label>+ </li>+ );+ })}+ </ul>+ </div>+ )}+ </DialogBody><DialogFooter><Buttonvariant="outline"@@ -471,7 +534,7 @@ function McpConsentDialogForm({ payload, store, toast }: McpConsentDialogFormPro<Trans>Working</Trans>) : (<Trans comment="Primary button that writes MCP config for the selected AI tools">- Add+ Connect</Trans>)}</Button>diff --git a/packages/app/src/globals.css b/packages/app/src/globals.cssindex 8e4e74244..8a0a42db8 100644--- a/packages/app/src/globals.css+++ b/packages/app/src/globals.css@@ -5147,3 +5147,7 @@ body:has([data-slot="dialog-overlay"], [data-slot="sheet-overlay"]) [data-sonner/* biome-ignore lint/complexity/noImportantStyles: sonner sets z-index inline on the toaster; only !important can beat an inline style. */z-index: 40 !important;}++.inline-code {+ @apply font-mono bg-muted text-inherit border border-border rounded-md px-1 py-0.5 text-sm;+}diff --git a/packages/app/src/locales/en/messages.json b/packages/app/src/locales/en/messages.jsonindex f6832a7fd..d168127cf 100644--- a/packages/app/src/locales/en/messages.json+++ b/packages/app/src/locales/en/messages.json@@ -530,6 +530,7 @@"Ck9XRt": ["Couldn't save the key — please try again."],"CmeH9S": ["Add property to ", ["keyName"]],"CvsD6Y": ["via ", ["viaTags"]],+ "D-Oh1s": ["How to set up ", ["0"], " (opens in browser)"],"D12vtS": ["(detached)"],"D2CwBE": ["Create a new OpenKnowledge project from the <0>",@@ -691,6 +692,9 @@"G8t9NN": ["Add a property"],"GA-UkN": [["keyName"], " type: ", ["typeLabel"], ". Click to change."],"GDvlUT": ["Role"],+ "GF51cw": [+ "Give the AI tools you use access to read and update your projects. Pick what to set up below, and change it anytime."+ ],"GGsM4y": ["Selected in graph"],"GJH-AT": [["docName"],@@ -876,6 +880,7 @@")."],"LhWYpm": ["Other OK paths are tracked upstream:"],+ "LiAw2k": ["What this changes"],"LlHqdU": ["Initializing project"],"Llyqvo": ["This usually means one of:"],"LpB85N": ["Plain"],@@ -1038,6 +1043,7 @@"PRnH8G": ["of ", ["0"]],"PVUn_c": ["Open folder"],"PZt1uN": ["Search files, commands, projects, and AI handoff actions."],+ "P_bX4O": ["How to set up"],"PdA9NZ": [["ahead"], " ahead"],"PdJZ5p": ["No skills yet."],"Pgu10b": ["Saved as <0>", ["slug"], ".md</0>"],@@ -1344,9 +1350,6 @@"YC6_wP": ["Edit ", ["keyName"]],"YEP3X2": ["Delete a table when the active table cell selection covers the full table."],"YGIi_c": ["Reinstall"],- "YGQm6y": [- "OpenKnowledge manages the <0>open-knowledge</0> MCP server name, the <1>open-knowledge-ui</1> launch config, and <2>ok</2> / <3>open-knowledge</3> on PATH (including OK-owned symlinks). Using a custom wrapper? Register it under a different name."- ],"YJ1BTp": ["A skill with that name already exists."],"YKLP_-": ["Template renamed"],"YPFBfr": [["detail"], " - ", ["kind"], " \"", ["createdPath"], "\" still exists on disk"],@@ -1482,7 +1485,6 @@],"b4itZn": ["Working"],"b5aNbi": ["The ", ["targetNoun"], " could not be opened — try navigating to it manually."],- "bBE5tC": ["Detected on this machine"],"bBcFK_": ["Open emoji picker for ", ["keyName"]],"bD8I7O": ["Complete"],"bGa3Fk": ["Uploading file"],@@ -1532,7 +1534,6 @@"cn1sLi": ["Couldn't connect OpenKnowledge tools to Claude Code. Please try again."],"cnGeoo": ["Delete"],"cqQyPB": ["Folder name"],- "crqzW5": ["AI tools"],"cs4mps": ["Config sharing"],"csDS2L": ["Available"],"ct2kv5": ["No headings in ", ["pageTarget"]],@@ -1757,6 +1758,7 @@"iNFKkm": ["No diff."],"iO8V-7": ["Create worktree"],"iOHg1t": ["Open embedded URL in new tab"],+ "iSLIjg": ["Connect"],"iSQTsg": ["Ordered list"],"iSnkwB": ["Failed to open cloned project."],"iTlqm3": [@@ -2049,6 +2051,7 @@"pmKdif": ["Failed: ", ["loadError"]],"pmUArF": ["Workspace"],"ppDgFi": ["Restart with this app's version"],+ "psfGPX": ["MCP connections"],"pzutoc": ["Italic"],"q2kXMG": ["Inline Math"],"q4YJl_": ["The terminal session ended (exit code ", ["0"], ")."],@@ -2190,6 +2193,7 @@"tjXez2": ["blog-post"],"toyw51": ["Mermaid diagram controls"],"tsiTqO": ["Paste your API key"],+ "tsyExA": ["Connect your AI tools to OpenKnowledge"],"u-9fWA": ["See <0>Architecture</0> for the system overview."],"u3BOHd": [["fileCount", "plural", { "one": ["#", " file"], "other": ["#", " files"] }]],"u3YnKw": ["Could not construct share URL."],@@ -2254,7 +2258,6 @@"vGeNNQ": ["Copy a prompt and paste it into your agent to set up your project."],"vIxrEk": ["Fit width"],"vLyv1R": ["Hide"],- "vM7XUh": ["Add OpenKnowledge to your AI tools"],"vQIVHc": ["Folder properties"],"vWc9a0": ["Type to edit; <0>⌘ Enter</0> saves, <1>Esc</1> cancels."],"vZVeFG": ["Upload failed — please try again"],@@ -2386,7 +2389,6 @@"ynIa4S": ["Visual editor list item"],"ypw6My": ["Showing top ", ["0"], " headings — keep typing to narrow"],"ysxgu8": ["project"],- "yu8Pzy": ["Not detected"],"yutJKi": ["Checklist with checkboxes."],"yvG-l1": ["Open source lint panel"],"yvHDYG": ["Claude Desktop"],diff --git a/packages/app/src/locales/en/messages.po b/packages/app/src/locales/en/messages.poindex 9db0768f9..d6983267c 100644--- a/packages/app/src/locales/en/messages.po+++ b/packages/app/src/locales/en/messages.po@@ -622,9 +622,7 @@ msgstr "Active panel content for the selected tab shows here."msgid "Activity"msgstr "Activity"-#. Primary button that writes MCP config for the selected AI tools#: src/components/FrontmatterRow.tsx-#: src/components/McpConsentDialogBody.tsx#: src/components/ObjectWidget.tsx#: src/components/PropertyPanel.tsxmsgid "Add"@@ -670,10 +668,6 @@ msgstr "Add item to {keyName}"msgid "Add meaning-based ranking to search so conceptually-related pages surface even when they share no keywords. This setting applies only to this computer."msgstr "Add meaning-based ranking to search so conceptually-related pages surface even when they share no keywords. This setting applies only to this computer."-#: src/components/McpConsentDialogBody.tsx-msgid "Add OpenKnowledge to your AI tools"-msgstr "Add OpenKnowledge to your AI tools"-#: src/components/settings/OkignoreSection.tsxmsgid "Add pattern"msgstr "Add pattern"@@ -748,11 +742,6 @@ msgstr "Agent configuration file"msgid "Agent Skills"msgstr "Agent Skills"-#. Section label above the editor checkbox list in the first-launch dialog-#: src/components/McpConsentDialogBody.tsx-msgid "AI tools"-msgstr "AI tools"-#: src/components/FolderOverview.tsxmsgid "All files"msgstr "All files"@@ -1502,6 +1491,11 @@ msgstr "Configure user, project, and integration settings."msgid "Conflict"msgstr "Conflict"+#. Primary button that writes MCP config for the selected AI tools+#: src/components/McpConsentDialogBody.tsx+msgid "Connect"+msgstr "Connect"+#: src/components/settings/AccountSection.tsxmsgid "Connect a GitHub account to browse and sync your repositories."msgstr "Connect a GitHub account to browse and sync your repositories."@@ -1544,6 +1538,10 @@ msgstr "Connect to GitHub"msgid "Connect tools"msgstr "Connect tools"+#: src/components/McpConsentDialogBody.tsx+msgid "Connect your AI tools to OpenKnowledge"+msgstr "Connect your AI tools to OpenKnowledge"+#: src/components/AuthModal.tsx#: src/components/settings/AccountSection.tsxmsgid "Connected as @{login}"@@ -2288,10 +2286,6 @@ msgstr "Details"msgid "Detected from the editors this project is set up for. Adjust to control where every skill installs."msgstr "Detected from the editors this project is set up for. Adjust to control where every skill installs."-#: src/components/McpConsentDialogBody.tsx-msgid "Detected on this machine"-msgstr "Detected on this machine"-#: src/components/CommandPalette.tsx#: src/components/handoff/OpenInAgentMenuItem.tsxmsgid "Detecting"@@ -3212,6 +3206,10 @@ msgstr "GitHub authentication failed. Try signing in again."msgid "GitHub sign-in is missing or expired. Reconnect to resume syncing."msgstr "GitHub sign-in is missing or expired. Reconnect to resume syncing."+#: src/components/McpConsentDialogBody.tsx+msgid "Give the AI tools you use access to read and update your projects. Pick what to set up below, and change it anytime."+msgstr "Give the AI tools you use access to read and update your projects. Pick what to set up below, and change it anytime."+#: src/lib/keyboard-shortcuts.ts#: src/lib/skill-scope.tsmsgid "Global"@@ -3418,6 +3416,16 @@ msgstr "How does sharing work?"msgid "How to push manually"msgstr "How to push manually"+#. Link on an undetected tool row to its OpenKnowledge setup guide+#: src/components/McpConsentDialogBody.tsx+msgid "How to set up"+msgstr "How to set up"++#. placeholder {0}: editor.label+#: src/components/McpConsentDialogBody.tsx+msgid "How to set up {0} (opens in browser)"+msgstr "How to set up {0} (opens in browser)"+#: src/editor/slash-command/embed-starter-items.tsxmsgid "HTML"msgstr "HTML"@@ -3967,6 +3975,11 @@ msgstr "Markdown source"msgid "Match case"msgstr "Match case"+#. Section label above the editor checkbox list in the first-launch dialog — each row wires OpenKnowledge's MCP server into that tool+#: src/components/McpConsentDialogBody.tsx+msgid "MCP connections"+msgstr "MCP connections"+#: src/editor/slash-command/items.tsxmsgid "Medium section heading."msgstr "Medium section heading."@@ -4536,10 +4549,6 @@ msgstr "Not connected"msgid "Not connected to GitHub."msgstr "Not connected to GitHub."-#: src/components/McpConsentDialogBody.tsx-msgid "Not detected"-msgstr "Not detected"-#: src/components/CommandPalette.tsx#: src/components/handoff/OpenInAgentMenuItem.tsxmsgid "Not installed"@@ -4884,10 +4893,6 @@ msgstr "OpenKnowledge is using a GitHub account provided by the gh CLI. There'smsgid "OpenKnowledge is using this GitHub account."msgstr "OpenKnowledge is using this GitHub account."-#: src/components/McpConsentDialogBody.tsx-msgid "OpenKnowledge manages the <0>open-knowledge</0> MCP server name, the <1>open-knowledge-ui</1> launch config, and <2>ok</2> / <3>open-knowledge</3> on PATH (including OK-owned symlinks). Using a custom wrapper? Register it under a different name."-msgstr "OpenKnowledge manages the <0>open-knowledge</0> MCP server name, the <1>open-knowledge-ui</1> launch config, and <2>ok</2> / <3>open-knowledge</3> on PATH (including OK-owned symlinks). Using a custom wrapper? Register it under a different name."-#: src/components/ConsentDialogBody.tsxmsgid "OpenKnowledge stores its configuration and internal files inside a newly created <0>.ok</0> directory in your project root folder."msgstr "OpenKnowledge stores its configuration and internal files inside a newly created <0>.ok</0> directory in your project root folder."@@ -7524,6 +7529,10 @@ msgstr "What should the AI do? (optional)"msgid "What the agent may read, write, and surface."msgstr "What the agent may read, write, and surface."+#: src/components/McpConsentDialogBody.tsx+msgid "What this changes"+msgstr "What this changes"+#: src/components/empty-state/empty-state-copy.tsmsgid "What would you like to create?"msgstr "What would you like to create?"@@ -7576,6 +7585,7 @@ msgstr "Will be created at: <0>{targetPreview}</0>"msgid "Will be saved as <0>{sanitized}</0>."msgstr "Will be saved as <0>{sanitized}</0>."+#. Disclosure that Add will overwrite the tool's existing OpenKnowledge MCP entry#: src/components/McpConsentDialogBody.tsxmsgid "Will replace existing OpenKnowledge entry"msgstr "Will replace existing OpenKnowledge entry"diff --git a/packages/app/src/locales/pseudo/messages.json b/packages/app/src/locales/pseudo/messages.jsonindex 5530992b1..61022f93e 100644--- a/packages/app/src/locales/pseudo/messages.json+++ b/packages/app/src/locales/pseudo/messages.json@@ -530,6 +530,7 @@"Ck9XRt": ["Ćōũĺďń'ţ śàvē ţĥē ķēŷ — ƥĺēàśē ţŕŷ àĝàĩń."],"CmeH9S": ["Àďď ƥŕōƥēŕţŷ ţō ", ["keyName"]],"CvsD6Y": ["vĩà ", ["viaTags"]],+ "D-Oh1s": ["Ĥōŵ ţō śēţ ũƥ ", ["0"], " (ōƥēńś ĩń ƀŕōŵśēŕ)"],"D12vtS": ["(ďēţàćĥēď)"],"D2CwBE": ["Ćŕēàţē à ńēŵ ŌƥēńĶńōŵĺēďĝē ƥŕōĴēćţ ƒŕōḿ ţĥē <0>",@@ -691,6 +692,9 @@"G8t9NN": ["Àďď à ƥŕōƥēŕţŷ"],"GA-UkN": [["keyName"], " ţŷƥē: ", ["typeLabel"], ". Ćĺĩćķ ţō ćĥàńĝē."],"GDvlUT": ["Ŕōĺē"],+ "GF51cw": [+ "Ĝĩvē ţĥē ÀĨ ţōōĺś ŷōũ ũśē àććēśś ţō ŕēàď àńď ũƥďàţē ŷōũŕ ƥŕōĴēćţś. Ƥĩćķ ŵĥàţ ţō śēţ ũƥ ƀēĺōŵ, àńď ćĥàńĝē ĩţ àńŷţĩḿē."+ ],"GGsM4y": ["Śēĺēćţēď ĩń ĝŕàƥĥ"],"GJH-AT": [["docName"],@@ -876,6 +880,7 @@")."],"LhWYpm": ["Ōţĥēŕ ŌĶ ƥàţĥś àŕē ţŕàćķēď ũƥśţŕēàḿ:"],+ "LiAw2k": ["Ŵĥàţ ţĥĩś ćĥàńĝēś"],"LlHqdU": ["Ĩńĩţĩàĺĩźĩńĝ ƥŕōĴēćţ"],"Llyqvo": ["Ţĥĩś ũśũàĺĺŷ ḿēàńś ōńē ōƒ:"],"LpB85N": ["Ƥĺàĩń"],@@ -1038,6 +1043,7 @@"PRnH8G": ["ōƒ ", ["0"]],"PVUn_c": ["Ōƥēń ƒōĺďēŕ"],"PZt1uN": ["Śēàŕćĥ ƒĩĺēś, ćōḿḿàńďś, ƥŕōĴēćţś, àńď ÀĨ ĥàńďōƒƒ àćţĩōńś."],+ "P_bX4O": ["Ĥōŵ ţō śēţ ũƥ"],"PdA9NZ": [["ahead"], " àĥēàď"],"PdJZ5p": ["Ńō śķĩĺĺś ŷēţ."],"Pgu10b": ["Śàvēď àś <0>", ["slug"], ".ḿď</0>"],@@ -1344,9 +1350,6 @@"YC6_wP": ["Ēďĩţ ", ["keyName"]],"YEP3X2": ["Ďēĺēţē à ţàƀĺē ŵĥēń ţĥē àćţĩvē ţàƀĺē ćēĺĺ śēĺēćţĩōń ćōvēŕś ţĥē ƒũĺĺ ţàƀĺē."],"YGIi_c": ["Ŕēĩńśţàĺĺ"],- "YGQm6y": [- "ŌƥēńĶńōŵĺēďĝē ḿàńàĝēś ţĥē <0>ōƥēń-ķńōŵĺēďĝē</0> ḾĆƤ śēŕvēŕ ńàḿē, ţĥē <1>ōƥēń-ķńōŵĺēďĝē-ũĩ</1> ĺàũńćĥ ćōńƒĩĝ, àńď <2>ōķ</2> / <3>ōƥēń-ķńōŵĺēďĝē</3> ōń ƤÀŢĤ (ĩńćĺũďĩńĝ ŌĶ-ōŵńēď śŷḿĺĩńķś). Ũśĩńĝ à ćũśţōḿ ŵŕàƥƥēŕ? Ŕēĝĩśţēŕ ĩţ ũńďēŕ à ďĩƒƒēŕēńţ ńàḿē."- ],"YJ1BTp": ["À śķĩĺĺ ŵĩţĥ ţĥàţ ńàḿē àĺŕēàďŷ ēxĩśţś."],"YKLP_-": ["Ţēḿƥĺàţē ŕēńàḿēď"],"YPFBfr": [["detail"], " - ", ["kind"], " \"", ["createdPath"], "\" śţĩĺĺ ēxĩśţś ōń ďĩśķ"],@@ -1482,7 +1485,6 @@],"b4itZn": ["Ŵōŕķĩńĝ"],"b5aNbi": ["Ţĥē ", ["targetNoun"], " ćōũĺď ńōţ ƀē ōƥēńēď — ţŕŷ ńàvĩĝàţĩńĝ ţō ĩţ ḿàńũàĺĺŷ."],- "bBE5tC": ["Ďēţēćţēď ōń ţĥĩś ḿàćĥĩńē"],"bBcFK_": ["Ōƥēń ēḿōĴĩ ƥĩćķēŕ ƒōŕ ", ["keyName"]],"bD8I7O": ["Ćōḿƥĺēţē"],"bGa3Fk": ["Ũƥĺōàďĩńĝ ƒĩĺē"],@@ -1532,7 +1534,6 @@"cn1sLi": ["Ćōũĺďń'ţ ćōńńēćţ ŌƥēńĶńōŵĺēďĝē ţōōĺś ţō Ćĺàũďē Ćōďē. Ƥĺēàśē ţŕŷ àĝàĩń."],"cnGeoo": ["Ďēĺēţē"],"cqQyPB": ["Ƒōĺďēŕ ńàḿē"],- "crqzW5": ["ÀĨ ţōōĺś"],"cs4mps": ["Ćōńƒĩĝ śĥàŕĩńĝ"],"csDS2L": ["Àvàĩĺàƀĺē"],"ct2kv5": ["Ńō ĥēàďĩńĝś ĩń ", ["pageTarget"]],@@ -1757,6 +1758,7 @@"iNFKkm": ["Ńō ďĩƒƒ."],"iO8V-7": ["Ćŕēàţē ŵōŕķţŕēē"],"iOHg1t": ["Ōƥēń ēḿƀēďďēď ŨŔĹ ĩń ńēŵ ţàƀ"],+ "iSLIjg": ["Ćōńńēćţ"],"iSQTsg": ["Ōŕďēŕēď ĺĩśţ"],"iSnkwB": ["Ƒàĩĺēď ţō ōƥēń ćĺōńēď ƥŕōĴēćţ."],"iTlqm3": [@@ -2049,6 +2051,7 @@"pmKdif": ["Ƒàĩĺēď: ", ["loadError"]],"pmUArF": ["Ŵōŕķśƥàćē"],"ppDgFi": ["Ŕēśţàŕţ ŵĩţĥ ţĥĩś àƥƥ'ś vēŕśĩōń"],+ "psfGPX": ["ḾĆƤ ćōńńēćţĩōńś"],"pzutoc": ["Ĩţàĺĩć"],"q2kXMG": ["Ĩńĺĩńē Ḿàţĥ"],"q4YJl_": ["Ţĥē ţēŕḿĩńàĺ śēśśĩōń ēńďēď (ēxĩţ ćōďē ", ["0"], ")."],@@ -2190,6 +2193,7 @@"tjXez2": ["ƀĺōĝ-ƥōśţ"],"toyw51": ["Ḿēŕḿàĩď ďĩàĝŕàḿ ćōńţŕōĺś"],"tsiTqO": ["Ƥàśţē ŷōũŕ ÀƤĨ ķēŷ"],+ "tsyExA": ["Ćōńńēćţ ŷōũŕ ÀĨ ţōōĺś ţō ŌƥēńĶńōŵĺēďĝē"],"u-9fWA": ["Śēē <0>Àŕćĥĩţēćţũŕē</0> ƒōŕ ţĥē śŷśţēḿ ōvēŕvĩēŵ."],"u3BOHd": [["fileCount", "plural", { "one": ["#", " ƒĩĺē"], "other": ["#", " ƒĩĺēś"] }]],"u3YnKw": ["Ćōũĺď ńōţ ćōńśţŕũćţ śĥàŕē ŨŔĹ."],@@ -2254,7 +2258,6 @@"vGeNNQ": ["Ćōƥŷ à ƥŕōḿƥţ àńď ƥàśţē ĩţ ĩńţō ŷōũŕ àĝēńţ ţō śēţ ũƥ ŷōũŕ ƥŕōĴēćţ."],"vIxrEk": ["Ƒĩţ ŵĩďţĥ"],"vLyv1R": ["Ĥĩďē"],- "vM7XUh": ["Àďď ŌƥēńĶńōŵĺēďĝē ţō ŷōũŕ ÀĨ ţōōĺś"],"vQIVHc": ["Ƒōĺďēŕ ƥŕōƥēŕţĩēś"],"vWc9a0": ["Ţŷƥē ţō ēďĩţ; <0>⌘ Ēńţēŕ</0> śàvēś, <1>Ēść</1> ćàńćēĺś."],"vZVeFG": ["Ũƥĺōàď ƒàĩĺēď — ƥĺēàśē ţŕŷ àĝàĩń"],@@ -2386,7 +2389,6 @@"ynIa4S": ["Vĩśũàĺ ēďĩţōŕ ĺĩśţ ĩţēḿ"],"ypw6My": ["Śĥōŵĩńĝ ţōƥ ", ["0"], " ĥēàďĩńĝś — ķēēƥ ţŷƥĩńĝ ţō ńàŕŕōŵ"],"ysxgu8": ["ƥŕōĴēćţ"],- "yu8Pzy": ["Ńōţ ďēţēćţēď"],"yutJKi": ["Ćĥēćķĺĩśţ ŵĩţĥ ćĥēćķƀōxēś."],"yvG-l1": ["Ōƥēń śōũŕćē ĺĩńţ ƥàńēĺ"],"yvHDYG": ["Ćĺàũďē Ďēśķţōƥ"],diff --git a/packages/app/src/locales/pseudo/messages.po b/packages/app/src/locales/pseudo/messages.poindex 40c0d2196..a035282ae 100644--- a/packages/app/src/locales/pseudo/messages.po+++ b/packages/app/src/locales/pseudo/messages.po@@ -617,9 +617,7 @@ msgstr ""msgid "Activity"msgstr ""-#. Primary button that writes MCP config for the selected AI tools#: src/components/FrontmatterRow.tsx-#: src/components/McpConsentDialogBody.tsx#: src/components/ObjectWidget.tsx#: src/components/PropertyPanel.tsxmsgid "Add"@@ -665,10 +663,6 @@ msgstr ""msgid "Add meaning-based ranking to search so conceptually-related pages surface even when they share no keywords. This setting applies only to this computer."msgstr ""-#: src/components/McpConsentDialogBody.tsx-msgid "Add OpenKnowledge to your AI tools"-msgstr ""-#: src/components/settings/OkignoreSection.tsxmsgid "Add pattern"msgstr ""@@ -743,11 +737,6 @@ msgstr ""msgid "Agent Skills"msgstr ""-#. Section label above the editor checkbox list in the first-launch dialog-#: src/components/McpConsentDialogBody.tsx-msgid "AI tools"-msgstr ""-#: src/components/FolderOverview.tsxmsgid "All files"msgstr ""@@ -1497,6 +1486,11 @@ msgstr ""msgid "Conflict"msgstr ""+#. Primary button that writes MCP config for the selected AI tools+#: src/components/McpConsentDialogBody.tsx+msgid "Connect"+msgstr ""+#: src/components/settings/AccountSection.tsxmsgid "Connect a GitHub account to browse and sync your repositories."msgstr ""@@ -1539,6 +1533,10 @@ msgstr ""msgid "Connect tools"msgstr ""+#: src/components/McpConsentDialogBody.tsx+msgid "Connect your AI tools to OpenKnowledge"+msgstr ""+#: src/components/AuthModal.tsx#: src/components/settings/AccountSection.tsxmsgid "Connected as @{login}"@@ -2283,10 +2281,6 @@ msgstr ""msgid "Detected from the editors this project is set up for. Adjust to control where every skill installs."msgstr ""-#: src/components/McpConsentDialogBody.tsx-msgid "Detected on this machine"-msgstr ""-#: src/components/CommandPalette.tsx#: src/components/handoff/OpenInAgentMenuItem.tsxmsgid "Detecting"@@ -3207,6 +3201,10 @@ msgstr ""msgid "GitHub sign-in is missing or expired. Reconnect to resume syncing."msgstr ""+#: src/components/McpConsentDialogBody.tsx+msgid "Give the AI tools you use access to read and update your projects. Pick what to set up below, and change it anytime."+msgstr ""+#: src/lib/keyboard-shortcuts.ts#: src/lib/skill-scope.tsmsgid "Global"@@ -3413,6 +3411,16 @@ msgstr ""msgid "How to push manually"msgstr ""+#. Link on an undetected tool row to its OpenKnowledge setup guide+#: src/components/McpConsentDialogBody.tsx+msgid "How to set up"+msgstr ""++#. placeholder {0}: editor.label+#: src/components/McpConsentDialogBody.tsx+msgid "How to set up {0} (opens in browser)"+msgstr ""+#: src/editor/slash-command/embed-starter-items.tsxmsgid "HTML"msgstr ""@@ -3962,6 +3970,11 @@ msgstr ""msgid "Match case"msgstr ""+#. Section label above the editor checkbox list in the first-launch dialog — each row wires OpenKnowledge's MCP server into that tool+#: src/components/McpConsentDialogBody.tsx+msgid "MCP connections"+msgstr ""+#: src/editor/slash-command/items.tsxmsgid "Medium section heading."msgstr ""@@ -4531,10 +4544,6 @@ msgstr ""msgid "Not connected to GitHub."msgstr ""-#: src/components/McpConsentDialogBody.tsx-msgid "Not detected"-msgstr ""-#: src/components/CommandPalette.tsx#: src/components/handoff/OpenInAgentMenuItem.tsxmsgid "Not installed"@@ -4879,10 +4888,6 @@ msgstr ""msgid "OpenKnowledge is using this GitHub account."msgstr ""-#: src/components/McpConsentDialogBody.tsx-msgid "OpenKnowledge manages the <0>open-knowledge</0> MCP server name, the <1>open-knowledge-ui</1> launch config, and <2>ok</2> / <3>open-knowledge</3> on PATH (including OK-owned symlinks). Using a custom wrapper? Register it under a different name."-msgstr ""-#: src/components/ConsentDialogBody.tsxmsgid "OpenKnowledge stores its configuration and internal files inside a newly created <0>.ok</0> directory in your project root folder."msgstr ""@@ -7519,6 +7524,10 @@ msgstr ""msgid "What the agent may read, write, and surface."msgstr ""+#: src/components/McpConsentDialogBody.tsx+msgid "What this changes"+msgstr ""+#: src/components/empty-state/empty-state-copy.tsmsgid "What would you like to create?"msgstr ""@@ -7571,6 +7580,7 @@ msgstr ""msgid "Will be saved as <0>{sanitized}</0>."msgstr ""+#. Disclosure that Add will overwrite the tool's existing OpenKnowledge MCP entry#: src/components/McpConsentDialogBody.tsxmsgid "Will replace existing OpenKnowledge entry"msgstr ""diff --git a/packages/core/src/constants/editors.ts b/packages/core/src/constants/editors.tsindex 987bdda5a..72ba11d85 100644--- a/packages/core/src/constants/editors.ts+++ b/packages/core/src/constants/editors.ts@@ -106,6 +106,21 @@ export const HOSTS_WITH_USER_SKILL_DIR: ReadonlyArray<{editorId,}));+/**+ * OpenKnowledge integration-doc slug per editor — the setup guide at+ * `https://openknowledge.ai/docs/integrations/<slug>`. Consumed by the+ * first-launch consent dialog to link an undetected tool to its setup guide.+ * Claude Code and Claude Desktop share one page (`claude-code` covers both).+ */+export const EDITOR_SETUP_DOC_SLUG = {+ claude: 'claude-code',+ 'claude-desktop': 'claude-code',+ cursor: 'cursor',+ codex: 'codex',+ opencode: 'opencode',+ openclaw: 'openclaw',+} as const satisfies Record<EditorId, string>;+/*** Project-relative MCP-config path per editor (POSIX, `cwd`-relative), or* `null` for an editor with no project-scope config (Claude Desktop isdiff --git a/packages/core/src/index.ts b/packages/core/src/index.tsindex ece18a3b4..7b4b57baf 100644--- a/packages/core/src/index.ts+++ b/packages/core/src/index.ts@@ -192,6 +192,7 @@ export {EDITOR_LABELS,EDITOR_PROJECT_CONFIG_PATH,EDITOR_PROJECT_SKILL_ROOT,+ EDITOR_SETUP_DOC_SLUG,type EditorId,HOSTS_WITH_USER_SKILL_DIR,PROJECT_SKILL_EDITOR_IDS,