We built this because we wanted a Notion-like experience for writing and sharing markdown files across our team. Obsidian is the best alternative we tried, but found it doesn’t have a true WYSWIG UI and it didn’t integrate well with Claude/Codex outside of community plugins.
So we built OpenKnowledge. It takes shape as:
1. A MacOS app with a file navigator, the WYSIWYG editor, and link explorer.
2. Integrations with the Claude, Codex, and Cursor desktop apps. The agents can open an OpenKnowledge editor within their embedded web browsers for a side-by-side experience.
3. Built-in mcps, skills, and RAG for LLM-wiki and “AI Second Brain” scenarios + spec writing
4. An embedded terminal and CLI for TUI-first users
OSS stack includes: Tiptap/prosemirror, CodeMirror, yjs (CRDT), Electron (MacOS app), Orama, remark/rehype/micromark/mdast, @pierre/trees
On the architecture side, the interesting eng. challenges included:
1. A pipeline to convert ProseMirror to markdown in a bidirectional lossless way. ProseMirror uses ASTs, which are not designed to have byte-fidelity.
2. A dual-observer CRDT to keep the ProseMirror and markdown state in-sync.
The CRDT + git also power a collaborative experience that shows what Agents are doing in the markdown, have undo/redo, and version history. The “Share” and cloud-sync functionality are geared for team collaboration. They feel “no-code” but leverage git/GitHub under the hood, which also means data stays fully private.
In that spirit, we made OpenKnowledge open source for anybody who’s curious or who’d like to contribute.
We’re actively thinking about plugins/extensibility and what’s next. If you have suggestions or feedback, would love to hear it.
Discussion (77 Comments)Read Original on HackerNews
I do think a fully OSS Obsidian-like that syncs natively is an impressive accomplishment, though the usefulness of this is limited with OSX being the only supported platform. If an Android app is in the works I'll definitely follow the project!
What IDE or harness do you use? We'll take a look.
On a side note, I find it interesting that a few recent projects are going for the Open Knowledge name. The Open Knowledge Foundation (https://okfn.org) is one of the first/largest proponents of the open data movement (think of it as a Free Software Foundation but for data, not software). They started in 2004 and developed many of the open data licenses and widely used infrastructure tools like CKAN (an open data portal platform).
Nothing to add, just found it interesting.
Disclaimer: I worked there for a few years.
OKF timing was coincidence, we'd started I take it around the same time they'd started internally.
What's good is that everything is pretty open formats/source and complimentary.
https://cloud.google.com/blog/products/data-analytics/how-th...
1. Name collison happenstance. We'd locked in the npm package and domains prior to their announcement.
2. Our templates are Open Knowledge Format compliant and we have an explicit quickstart around making an OKF knowledge base. You can think of OKF as a format/standard for the content, and OpenKnowledge (our app) as an IDE/editor for any type of markdown based content.
https://github.com/jacquescorbytuech/crm-open-knowledge-wiki
https://github.com/jacquescorbytuech/running-knowledge-base
Having built-in AI integration without relying on sketchy plugins would be the cherry on top (although, seriously missing the option to connect with any openai-compatible LLM provider like someone else mentioned here).
Seems like this might almost offer exactly that? I'll have to try it out...
I use Obsidian as a persistent context store and knowledge graph (..loosely defined, i.e. link/back-link) for both Claude Code and Hermes, while also using it to generate live Wiki pages for working documentation. The native replication and the Git integrations work well keeping it all synchronized across multiple harnesses, as well. I use the native MCP server mentioned above, plus just letting the agent work with the markdown files directly.
That said, having built out all of this manually I'm excited to try out something that addresses much of this out of the box. I'd also be curious about the integration with Hermes/OpenClaw/etc.
Large inspiration for OpenKnowledge was providing these flows out of the box.
We'll prioritize Hermes/OpenClaw guides next.
Feel free to drop me any feedback as you try it out - @nickgomez on X.
Making the skills/MCP specific to OpenKnowledge allows us to optimize experiences like that.
Our goal was you wouldn't need a separate IDE and to work well with the coding agent desktop apps.
But alas -- markdown files on your local machine is indeed the way for being AI friendly.
Personally I’ve been trying very hard to migrate away from git+Obsidian project setup according to the OpenAI Harness Engineering. It works wonderfully in Codex Desktop.
The only gotcha - I want to share knowledge bases with the team in a way that is:
(1) versioned (a la git, not Notion) (2) usable from any chat (a la MCP) (3) basic access controls for team setup. (4) works through the interface that optimizes accuracy and token use across agentic architectures and LLMs.
Funnily enough, 4 is the easiest one (I have a platform for agent training and verification where I publish fun challenges for agents in simulated worlds around agentic commerce and personal OSes. With 98M agentic interactions recorded, that is already enough information for tuning)
Still figuring 1 and 3, though.
#1 - the "autosync" and GitHub integrations do exactly this.
#2 - The app auto-instals skills/MCP server configs for a few harnesses
#4 - We embedded agentic-search capabilities via the MCP server (e.g. we virtualize 'ls' and 'cat' so we can enrich it for the agent for better hierchical navigation).
So changesets have to be atomic across multiple documents and semantic (so that agents can resolve the changes). Weak per-document versioning isn’t enough here.
#4. Nice! Same story, but also virtualizing ripgrep, find and tree (plus MD-aware outline mode). With that setup even agents with weaker local models (eg runnable on DGX Spark) can solve complex tasks in the Agentic Commerce domain.
> Added ok to your PATH — managed block in ~/.zshrc, ~/.config/fish/conf.d/open-knowledge.fish.
Took a while to see that 'ok' is the name of your product.
What functionality is most important to you re:Notion?
Links: https://slite.slite.page/p/5XOO7_tII0D87T/Importing-Files, https://slite.slite.page/p/PxKfPvLrLHj07O/Exporting-Your-Doc...
Recommend trying it for some personal notes/specs/etc. -- can be used independently.
High level general purpose "IDE" for document editing (think Google Docs, Notion), that also exposes MCP/Skills for LLM wiki/second-brain scenarios.
Seems Rowboat is more focused on the personal assistant angle, we defer to your own agent (Claude, Codex, etc.) to do the LLM work.
re: Web app do you mean local web UI, or web hosted?
For Notion, we don't have a migration tool, but you can try the export to markdown approach.
Recommend trying it to get a feel, and if are looking to migrate and facing friction let me know details.
For example, with the appropriate plugins like dataview and charts, it's possible to create dashboards, lists, and tables that update automatically based on data elements present in documents or documents themselves. I use it to have views over my to-do lists (daily routine items, tasks that are overdue, upcoming tasks, etc), make dashboards, and show lists of documents edited on a particular date.
I'd love to migrate away from Obsidian towards something that's not proprietary, but I haven't seen anything that allows querying other documents.
That doesn't mean it's a design direction that open knowledge should go in, but just a data point that reducing Obsidian vaults to "just markdown" misses what some users use it for.
Local models should be the first choice in that framing.
We're looking at OpenCode/Zed next but open to input.