You should just integrate with pi.dev, like I did for https://github.com/rcarmo/piclaw (which has replaced Obsidian for me). I too integrated a terminal and a WYSIWYG Markdown editor (as well as plugins for a mindmap, kanban, etc.)
Fully local, but can't integrate with any local LLM?
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!
Personally I just want to see more support for local LLMs. I haven't been doing much coding lately but am interested in setting up Qwen 3.6 if I can obtain the hardware
Amazing, thanks. I've decided to try daily driving this instead of Obsidian, but I'm a bit curious how the syncing works. I copied an Obsidian vault to a new folder, and when I start the import process in OpenKnowledge it asks me if I want it "shared" or "local only". If I select "Shared", where does the git repo live that other instances of OK sync from?
edit: This seems to be "team-oriented" rather than geared towards individuals who might want to edit their notes from multiple devices?
And only seems to be able to sync with github... In addition to my privacy concerns, I'm curious if there could be issues with lots of images and other attachments since git can choke on repos that contain lots of larger files without github's git-lfs extension.
Last question I have is if any plugin system comparable to Obsidian's is planned (or already supported)? I realize this is probably a massive ask for an open-source project, and something Obsidian gets a lot of flack for as well, so I'm certainly not expecting it, but I am curious if it's on the roadmap already
It would make a repo in your own GitHub account. You can choose whether that repo is in your personal GitHub or your GitHub org. We'll make that clearer in the UX.
Feel free to ping me any additional feedback any time (here or @nickgomez on X).
For ages I've been looking for a way to easily share & sync a simple knowledgebase (HTML/MD and other files in folders) with my team (= including non-technical people), using Git as the sync/versioning layer, without it being too technical, and without getting vendor lock-in with expensive & unnecessarily complex cloud-based platforms.
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...
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).
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)
Gotcha. We're optimizing for the same scenarios, may be worth a look at our implementation in case transferable to yours. See:
#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).
I've been using my opencode go subscription for Obsidian, saving my Claude sub for actual coding. Any reason why it's limited to Codex, Claude, and Cursor?
I don't understand how Obsidian, a collection of markdown files, isn't already AI friendly. It's hard for me to imagine a more AI-friendly but still usable way to organize your notes.
What we did to go "beyond" is build in skills and an MCP server into the app, and auto-install those into e.g. Claude, Codex, and Cursor formats. Also added a web viewer so that e.g. Claude Desktop can open up the editor directly within it's embedded web viewer.
There is at least one MCP server in Obsidian's community plugins, plus the REST API access capability which is already addressed in several open source MCP plugins.
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.
Why not build skills and an MCP for markdown or obsidian? I'm using both at present and it's fine, bit would like to understand the differentiating factor here.
Example of the functionality that's OK specific: we made it so that e.g. Claude Desktop (or Codex, Cursor) can open the OpenKnowledge web viewer within their own embedded web viewers, to make for better side-by-side editing. Since Obsidian is closed source, we wouldn't be able to make that work.
Making the skills/MCP specific to OpenKnowledge allows us to optimize experiences like that.
This. I just open the Obsidian folder (aka "vault") in VS Code and BOOM, it is AI friendly. I just hack on the .md files like I would code with Copilot.
Same flow I had. We did a few things to make the flow easier, like making it easy for Claude Desktop to open the OpenKnowledge web viewer within its own web view. Also exposing things like vector search, etc.
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.
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.
Sweet, let me know the experience, we're actively thinking about how to make OKF KBs editing a good experience. E.g. a linter or other conformant mode.
Nothing personal, but there genuinely ought to be consequences for using "open source" in the context of something like this tied to proprietary AI services.
Local models should be the first choice in that framing.
Neat, trying it out now. Are the Open Knowledge skills actually needed, if this is just markdown and folders? The skills are large, I'd prefer not filling up context.
Skills / MCPs are not hard requirement, they're tailored for the desktop agents to be able to leverage built in tools we make available for e.g. agentic search over the content and manipulating the open knowledge web viewer and editor.
Sounds cool. How do agents know what else is going on in the doc? They have an embedded browser and they do like mutation observer type stuff? Or does the integration do polling?
Looking into Slite now to check. With OpenKnowledge, the content is just markdown files on-disk, so there shouldn't be anything exclusionary about it. Not sure how/if Slite handles markdown files. Will take a look.
I recommend taking a look at appimages or flatpak within Linux if you wish to do so and if you do appimage, try to take an older system within a VM from my understanding as then you wouldn't have issues of glibc which I have sometimes heard. I'd be interested to help if that is of your interest.
Since Obsidian is just markdown, you can just open an Obsidian vault with OpenKnowledge. We made it so that most Obsidian syntax is supported, like wikilinks.
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.
Obsidian is a lot more than "just markdown" though.
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.
Yes makes sense, the database site of it is the primary point we don't support yet. We want to do it in the way we think is best and will keep in mind how to make the experience good for existing Obsidian users.
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.
edit: This seems to be "team-oriented" rather than geared towards individuals who might want to edit their notes from multiple devices?
And only seems to be able to sync with github... In addition to my privacy concerns, I'm curious if there could be issues with lots of images and other attachments since git can choke on repos that contain lots of larger files without github's git-lfs extension.
Last question I have is if any plugin system comparable to Obsidian's is planned (or already supported)? I realize this is probably a massive ask for an open-source project, and something Obsidian gets a lot of flack for as well, so I'm certainly not expecting it, but I am curious if it's on the roadmap already
Feel free to ping me any additional feedback any time (here or @nickgomez on X).
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...
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.
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).
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.
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
Local models should be the first choice in that framing.
> 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.
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.
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.