Beautiful, AI-native markdown IDE and LLM wiki
TypeScript 2nd-brainagent-skillsclaudecodexcompany-braindocsknowledge-knowledge-baseknowledge-managementllmllm-wikillm-wiki-karpathymarkdownmarkdown-editormdmdxnotespkmsecond-brainskills
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.mdxindex 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.mdxindex 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.+## VerifyOpen 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.mdxdeleted file mode 100644index 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.jsonindex 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.tsxindex 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.tsxindex 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;