Claude

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

There are two ways to connect Claude Code, depending on how you run Open Knowledge:

• macOS desktop app. The first time you open a project, a consent dialog detects Claude Code and configures it for you. To re-trigger the dialog, delete ~/.ok/mcp-status.json and relaunch.
• Web app / terminal (Linux, Intel Mac — see the web app guide). Run ok init in your project: it registers the Open Knowledge MCP server with Claude Code and the other editors it detects. Every ok start refreshes the entry.

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 for the full UX.

Verify

Open the project in Claude Code and ask:

“List the first 5 documents you come across in this project.”Copy

Claude Code should call the Open Knowledge exec tool and respond with some of your documents.

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'll see the change land live in Open Knowledge. Just ask Claude Code to open it for you.