Skip to content

Beautiful, AI-native markdown IDE and LLM wiki

docs(open-knowledge): one Claude integration page (Claude Code only) (#1867)

tim-inkeepcc2da1186d9e
diff --git a/docs/content/get-started/quickstart.mdx b/docs/content/get-started/quickstart.mdx
index 2725d43d6..ff2aae84b 100644
--- a/docs/content/get-started/quickstart.mdx
+++ b/docs/content/get-started/quickstart.mdx
@@ -60,7 +60,7 @@ Starting from scratch? Build a brand-new, empty knowledge base.
</Tabs>
<Callout type="info">
- Whichever route you pick, the first-launch consent dialog detects every MCP-capable editor on your machine (Claude Code, Cursor, Codex, Claude Desktop) and offers to wire them up to Open Knowledge.
+ Whichever route you pick, the first-launch consent dialog detects every MCP-capable editor on your machine (Claude, Claude Desktop, Cursor, Codex) and offers to wire them up to Open Knowledge.
</Callout>
</Step>
diff --git a/docs/content/integrations/claude-code.mdx b/docs/content/integrations/claude-code.mdx
index 21750e75d..f38da97a8 100644
--- a/docs/content/integrations/claude-code.mdx
+++ b/docs/content/integrations/claude-code.mdx
@@ -1,23 +1,33 @@
---
-title: Claude Code CLI
-description: Use Open Knowledge with the Claude Code CLI.
+title: Claude
+description: Use Open Knowledge with Claude Code, in the CLI or the Claude Desktop app.
---
-Open Knowledge works with Claude Code Agent via MCP and Skills.
+Open Knowledge works with Claude Code through MCP plus an installed skill that teaches the agent how to use the tools. Both surfaces are supported:
+
+- **Claude Code CLI** — the `claude` command in your terminal.
+- **Claude Desktop app** — Claude Code in the **Code** tab.
## Install
<McpInstall editor="Claude Code" />
+If you installed the Open Knowledge desktop app from the macOS DMG, a consent dialog runs on first launch and offers to wire up the MCP-capable agents it detects, Claude Code included — click **Add**. To re-trigger it, delete `~/.ok/mcp-status.json` and relaunch.
+
+## Open with AI
+
+From the editor, **Open with AI ▸ Claude** dispatches the current file, folder, or project to Claude Code in one click. Three entry points: the editor header's sparkle icon, the sidebar's right-click menu (file / folder / empty space), and the macOS **File → Open with AI** menu.
+
+Claude Code receives a short prompt asking it to open the target in Open Knowledge's web preview, then grounds the rest of the conversation through MCP. See [Editor → Open with AI](/docs/features/editor#open-with-ai) for the full UX.
+
## Verify
Open the project in Claude Code and ask:
<VerifyExec subject="Claude Code" />
-If Claude Code doesn't use the Open Knowledge `exec` tool, restart Claude Code so it picks up the new MCP entry.
+If Claude Code doesn't use the Open Knowledge `exec` tool, restart it so it picks up the new MCP entry.
## Live editing
-When Claude Code writes to a doc, You will be able to see that change in the Open Knowledge app. Just ask Claude to open it for you.
-
+When Claude Code writes to a doc, you'll see the change land live in the Open Knowledge app — just ask Claude to open it for you.
diff --git a/docs/content/integrations/claude-desktop.mdx b/docs/content/integrations/claude-desktop.mdx
deleted file mode 100644
index 0ef4a97c8..000000000
--- a/docs/content/integrations/claude-desktop.mdx
+++ /dev/null
@@ -1,50 +0,0 @@
----
-title: Claude Desktop
-description: Use Open Knowledge with the Claude Desktop app (Chat, Cowork, and Code).
----
-
-The Claude Desktop app has three modes that touch Open Knowledge differently.
-
-- **Code tab** is Claude Code. Set it up via the [Claude Code CLI](/docs/integrations/claude-code) page.
-- **Chat** and **Cowork** read skills from a separate, isolated list. Use the steps below for those.
-
-## Installed from the macOS DMG
-
-A consent dialog runs the first time the app launches. It detects your MCP-capable editors and wires them up when you click **Add**. To re-trigger it, delete `~/.ok/mcp-status.json` and relaunch.
-
-This covers MCP wiring but not the skill that Chat and Cowork need — follow the steps below for that.
-
-## Install the skill (Chat + Cowork)
-
-In the Open Knowledge desktop app, open **Help → Install for Claude Chat & Cowork (Desktop App)…**. The dialog builds `openknowledge.skill`, saves it to `~/Downloads/`, and opens the Claude Desktop app. Upload it manually with five clicks: **Customize → Skills → + → Create skill → Upload skill**, then pick the file from Downloads.
-
-The skill turns on automatically. Use it in any Chat or Cowork session.
-
-If `Customize → Skills` isn't visible, enable it in **Settings → Capabilities → Code execution and file creation**.
-
-## Open with AI
-
-Once the skill is installed, Chat and Cowork sessions can ask Open Knowledge for anything in the workspace through MCP. That's the user-facing surface. The editor's **Open with AI ▸** menu does not list Cowork as a target today (Cowork has no `claude-cowork://` deep-link scheme to dispatch to), so the menu surfaces Claude, Codex, and Cursor only. A claude.ai web fallback opens file-scope dispatches in the Claude web UI for users without a local Claude install; see [Editor → Open with AI](/docs/features/editor#open-with-ai) for the full menu UX.
-
-## Verify
-
-In a fresh Chat or Cowork session:
-
-<CopyPrompt>List the first 5 documents you come across in this project.</CopyPrompt>
-
-Claude should recognize the skill and use Open Knowledge's tools.
-
-## Cowork: skill won't fire after install
-
-Claude Cowork has [an open bug](https://github.com/anthropics/claude-code/issues/26254) where custom skills register in the UI but don't mount in the session VM. Symptom: the skill shows enabled but Cowork tells you it isn't available.
-
-Workaround:
-
-1. **Customize → Skills**, find `open-knowledge`, delete it.
-2. Open **Help → Install for Claude Chat & Cowork (Desktop App)…** in the Open Knowledge desktop app to rebuild the bundle.
-3. Re-upload (the same 5-click sequence).
-4. Start a fresh Cowork session.
-
-## Team and Enterprise
-
-Org owners can publish the skill once instead of asking every user to install it. Build the bundle from **Help → Install for Claude Chat & Cowork (Desktop App)…** in the Open Knowledge desktop app, then upload it via **Organization settings → Skills → + Add** in Claude Desktop. Every member sees it in Chat and Cowork.
diff --git a/docs/content/integrations/meta.json b/docs/content/integrations/meta.json
index c06fcedb8..84d789235 100644
--- a/docs/content/integrations/meta.json
+++ b/docs/content/integrations/meta.json
@@ -1,5 +1,5 @@
{
"title": "Integrations",
"icon": "LuPlug",
- "pages": ["claude-desktop", "claude-code", "cursor", "codex"]
+ "pages": ["claude-code", "cursor", "codex"]
}
diff --git a/docs/src/components/overview-blocks.tsx b/docs/src/components/overview-blocks.tsx
index d6bdda370..462fd664f 100644
--- a/docs/src/components/overview-blocks.tsx
+++ b/docs/src/components/overview-blocks.tsx
@@ -88,7 +88,7 @@ const PATHS: Path[] = [
{
href: '/docs/integrations/claude-code',
title: 'Setting up an editor?',
- desc: 'Pick yours from Integrations: Claude Code, Cursor, Codex, or Claude Desktop.',
+ desc: 'Pick yours from Integrations: Claude, Cursor, or Codex.',
},
{
href: '/docs/reference/mcp',
diff --git a/packages/app/src/components/InstallInClaudeDesktopDialog.tsx b/packages/app/src/components/InstallInClaudeDesktopDialog.tsx
index 6d8eb38a6..f62ed1641 100644
--- a/packages/app/src/components/InstallInClaudeDesktopDialog.tsx
+++ b/packages/app/src/components/InstallInClaudeDesktopDialog.tsx
@@ -16,7 +16,7 @@ import { dispatchExternalLinkClick } from '@/lib/external-link';
import { cn } from '@/lib/utils';
const INSTALL_COMMAND = 'npx @inkeep/open-knowledge install-skill';
-const DOCS_URL = 'https://openknowledge.ai/docs/integrations/claude-desktop';
+const DOCS_URL = 'https://openknowledge.ai/docs/integrations/claude-code';
interface InstallInClaudeDesktopDialogProps {
open: boolean;