open-knowledge README

The project's README from github.com/inkeep/open-knowledge. As one markdown file: README.md.

OpenKnowledge

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   •   desktop app   •   web UI + cli   •   𝕏   •   discord

OpenKnowledge editor with an AI agent drafting a launch recap

Features

Highlights:

Install

Desktop app — download it from openknowledge.ai/download (or grab an installer from the latest release):

Web app — on any platform (including Intel Macs and servers), run the same editor as a local web app via the CLI (Node.js 24+ and git required):

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 for details.

License

OpenKnowledge is licensed under GNU General Public License v3.0 or later, an OSI-Approved open source license.

Community & Support

Feel free to file an issue or ask questions on the Discord community. We're always looking for ideas and requests.

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

🔔 Follow us on 𝕏 for product updates. 🔔

open-knowledge (inkeep/open-knowledge)

Searching Database…

What is this?OpenKnowledge is an AI-native markdown editor and LLM wiki app. It gives you a true WYSIWYG editor for markdown/mdx files plus built-in AI editing integrations with coding agents like Claude, Codex, OpenCode and Pi.
Is this a desktop app or does it run in the browser too?Both: there's a native desktop app for macOS, Windows and Linux, and a web UI you can run locally via the CLI on any platform, including Intel Macs and servers.
What do I need installed to run the web/CLI version?The CLI-based web app requires Node.js 24 and up plus git; the native desktop builds don't need either.
Does the macOS desktop app work on Intel Macs?No, the macOS build is Apple Silicon only; on Intel Macs (or any other OS) you'd use the local web app via the CLI instead.
Does my data stay on my machine?Yes, OpenKnowledge works directly with the markdown files already on your computer and is described as private, local, and free rather than sending content to a hosted service.
How does it work with coding agents like Claude or Codex?The app walks you through installing MCP servers and skills for any agent harness it detects on your computer, so those agents can search and author your markdown docs alongside you.
Can teams share and sync their notes?Yes, it offers no-code team sharing with auto-sync powered by git/GitHub under the hood.
How is this different from just using Notion or Obsidian?It combines a true WYSIWYG markdown editor with side-by-side AI editing, agent search, and embeddable HTML/rich components for specs — the README frames it as 'Notion meets VS Code'.
Can I use it with my existing Obsidian vault?Yes, since it just opens any folder of markdown/mdx files, it works fine with existing codebases, wikis, or Obsidian vaults.
Creator
inkeep
Size
200.6 MB
Stars
4.6K
Age
4mo
Commits · 90 Days