---
slug: "open-knowledge"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/inkeep/open-knowledge@main/README.md"
repo: "https://github.com/inkeep/open-knowledge"
source_file: "README.md"
branch: "main"
---
<p>
  <a  href="https://openknowledge.ai"><picture>
    <source media="(prefers-color-scheme: dark)" srcset="assets/ok-wordmark-dark.svg">
    <img src="assets/ok-wordmark.svg" alt="OpenKnowledge" width="260">
  </picture></a>
</p>

<p>
<b>OpenKnowledge</b> 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.

</p>

<div >
  <a href="https://openknowledge.ai">website</a>
  <span>&nbsp;&nbsp;•&nbsp;&nbsp;</span>
  <a href="https://openknowledge.ai/download/stable">macOS app</a>
  <span>&nbsp;&nbsp;•&nbsp;&nbsp;</span>
  <a href="https://openknowledge.ai/docs/get-started/quickstart#ok-install-web-app-linux-windows-intel-mac">web UI + cli</a>
  <span>&nbsp;&nbsp;•&nbsp;&nbsp;</span>
  <a href="https://x.com/OpenKnowledge">𝕏</a>
  <span>&nbsp;&nbsp;•&nbsp;&nbsp;</span>
  <a href="https://discord.gg/VRKk2EaGHN">discord</a>
</div>

<br/>

<img
  src="assets/hero.webp"
  alt="OpenKnowledge editor with an AI agent drafting a launch recap"
  width="100%"
  style="border-radius: 10px"
/>

# 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. 
- Integrated **side-by-side AI-editing** with **Claude, Codex, OpenCode, Pi and others**. Can be used with any harness/agent via MCP/CLI.
- Out-of-the-box **MCP**, **skills**, and **agentic search** for LLM Wikis, 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.

## Install

**macOS:** download the desktop app — open the DMG, drag **OpenKnowledge** to **Applications**, and launch it. [Latest release](https://github.com/inkeep/open-knowledge/releases/latest).

**Linux, Windows, Intel Mac:** run the same editor as a local web app via the CLI ([Node.js 24+](https://nodejs.org) and git required):

```bash
npm install -g @inkeep/open-knowledge
cd your-project
ok init          # scaffold the project + wire up your AI editors (Claude Code, Claude Desktop, Cursor, Codex, OpenCode, OpenClaw)
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 VS Code. 

You can use it simply as a rich, WYSIWYG markdown editor to start. For existing files or plain notes/docs.

To get more complex, you can use the starter packs to create LLM Wikis, second brains, or more structured knowledge bases.

Either way, the app will walk you through installing the MCP and skills for agent harnesses detected on your computer. These are designed to help agents with enriched search + authoring of documents.

Git/GitHub based 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](https://github.com/inkeep/open-knowledge/blob/HEAD/CONTRIBUTING.md) for details.

## License

OpenKnowledge is licensed under [GNU General Public License v3.0 or later](https://github.com/inkeep/open-knowledge/tree/HEAD/LICENSE), an OSI-Approved open source license.

## Community & Support

Feel free to <a href="https://github.com/inkeep/open-knowledge/issues/new/choose">file an issue</a> or ask questions on the <a href="https://discord.gg/VRKk2EaGHN">Discord</a> community. We're always looking for ideas and requests.

<p>
  ⭐️ If you'd like to support this project, consider <a href="https://github.com/inkeep/open-knowledge">starring the repo</a> ⭐️
</p>

<p>
  🔔 Follow us on <a href="https://x.com/OpenKnowledge">𝕏</a> for product updates. 🔔
</p>