MCPcopy
hub / github.com/inkeep/open-knowledge

github.com/inkeep/open-knowledge @v0.24.0 sqlite

repository ↗ · DeepWiki ↗ · release v0.24.0 ↗
15,569 symbols 56,620 edges 2,999 files 137 documented · 1%
README

<img src="https://github.com/inkeep/open-knowledge/raw/v0.24.0/assets/ok-wordmark.svg" alt="OpenKnowledge" width="260">

OpenKnowledge is a beautiful markdown editor with integrations with Claude, Codex, and other harnesses. For knowledge bases, LLM wikis, specs, and notes. Private, local, and free.

website   •   macOS app   •   web view + cli   •   𝕏   •   Discord

OpenKnowledge editor with an AI agent drafting a launch recap

Features

Highlights: - Full true WYSIWYG so that editing markdown files feels like editing a Google Doc or Notion page. - macOS app and web UI with file navigator, search, tabs, graph wiki link viewer, and more. - Collaborative AI-editing with Claude, Codex, and Cursor desktop apps. Can be used with any harness/agent via MCP/CLI, like OpenCode. - Out-of-the-box MCP, skills, and agentic search for LLM Wikis, agent second brains, and knowledge graphs. - No-code Team sharing and Auto-sync powered by git/GitHub under the hood. - Embeddable HTML and rich components for writing engineering specs and visualized reports. - A built-in TUI in the Desktop app and a Web UI for users who prefer terminals.

Install

macOS: download the desktop app — open the DMG, drag OpenKnowledge to Applications, and launch it. Latest release.

Linux, Windows, Intel Mac: run the same editor as a local web app via the CLI (Node.js 24+ required):

npm install -g @inkeep/open-knowledge
cd your-project
ok init          # scaffold the project + wire up Claude Code, Cursor, and Codex
ok start --open  # serve the web editor and open it in your browser

Usage

Use OpenKnowledge by opening any existing folder on your computer that contains markdown or mdx files. The app can be used with existing codebases, wikis, Obsidian vaults, etc.

Think of it as Notion meets VSCode.

You can also start from scratch with one of the starter packs, which include e.g. a template for an LLM Wiki.

The app will automatically initialize your project with MCP and skill configs for agent harnesses detected on your computer. Git sync and sharing can optionally be enabled.

Docs for general usage: https://openknowledge.ai/docs.

Contributions

Public pull requests or issues are welcome!

See CONTRIBUTING.md for details.

License

OpenKnowledge is licensed under the GNU General Public License v3.0 or later (GPL-3.0-or-later).

Support

Feel free to file an issue or ask questions on the Discord community.

⭐️ If you'd like to support this project, consider starring the repo ⭐️

🔔 Follow us on 𝕏 for product updates. 🔔

Extension points exported contracts — how you extend this code

DriverUtilityLike (Interface)
(no doc) [8 implementers]
packages/desktop/src/main/driver-boot-smoke.ts
TokenStore (Interface)
(no doc) [8 implementers]
packages/cli/src/auth/token-store.ts
ProbeTokenStore (Interface)
(no doc) [6 implementers]
packages/server/src/github-permissions.ts
KeepaliveLogger (Interface)
(no doc) [3 implementers]
packages/core/src/keepalive/keepalive.ts
ToastImpl (Interface)
(no doc) [3 implementers]
packages/app/src/components/ConsentDialogBody.tsx
ThemeBridge (Interface)
(no doc)
biome-plugins/__fixtures__/no-resolved-value-theme-source.fixture.tsx
MarketingButtonProps (Interface)
(no doc)
docs/src/components/marketing-button.tsx
StdioStream (Interface)
(no doc) [8 implementers]
packages/desktop/src/main/process-safety-net.ts

Core symbols most depended-on inside this repo

push
called by 2150
packages/server/src/embed-probe.ts
map
called by 1781
packages/app/src/editor/extensions/mark-identity.ts
has
called by 1229
packages/core/src/registry/index.ts
t
called by 1157
packages/app/tests/lingui-macro-shim.tsx
push
called by 1140
packages/app/src/lib/perf/hdr-histogram.ts
parse
called by 1116
packages/core/src/markdown/index.ts
get
called by 984
packages/cli/src/auth/token-store.ts
warn
called by 960
packages/desktop/src/main/auto-updater.ts

Shape

Function 11,320
Interface 2,433
Method 1,452
Class 364

Languages

TypeScript100%

Modules by API surface

packages/server/src/api-extension.ts219 symbols
packages/app/src/components/FileTree.tsx120 symbols
packages/app/src/editor/provider-pool.ts92 symbols
packages/server/src/backlink-index.ts79 symbols
packages/desktop/src/main/window-manager.ts77 symbols
packages/app/tests/integration/test-harness.ts74 symbols
packages/app/tests/perf/scenarios/sweep-convention-cap-graduation.ts68 symbols
packages/desktop/src/main/index.ts63 symbols
packages/desktop/src/main/auto-updater.ts61 symbols
packages/core/src/desktop-bridge.ts61 symbols
packages/app/src/lib/desktop-bridge-types.ts59 symbols
packages/app/src/editor/interaction-layer.tsx58 symbols

Dependencies from manifests, versioned

@biomejs/biome2.4.15 · 1×
@changesets/cli2.29.7 · 1×
@codemirror/autocomplete6.20.1 · 1×
@codemirror/commands6.10.3 · 1×
@codemirror/lang-css6.3.1 · 1×
@codemirror/lang-html6.4.9 · 1×
@codemirror/lang-javascript6.2.3 · 1×
@codemirror/lang-json6.0.1 · 1×
@codemirror/lang-markdown6.5.0 · 1×
@codemirror/lang-python6.1.7 · 1×
@codemirror/lang-rust6.0.1 · 1×

For agents

$ claude mcp add open-knowledge \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact