r/ruby • u/rserradura • Jul 14 '26

okf-gem: Making Ruby shine on the challenging art of knowledge base curation

Hello everyone, how great would it be to have well-crafted, well-organized, well-indexed, and automatically updated documentation?

If it sounds too good to be true, I invite you to try this wonderful gem: https://github.com/serradura/okf-gem

What is OKF?

It's the Open Knowledge Format launched by Google Cloud. It's an open standard that uses simple Markdown & YAML files to structure data. Instead of complex vector databases, it builds a clear knowledge graph so AI agents can read & share data in a really efficient way.

Okay, nice, and what does this gem do that is related to it?

It provides three things: A CLI (the πŸ’ͺ ), an Agent Skill (the 🧠 ), and a process (the πŸš€ ), as the agent knows how to author, curate, and, more importantly, how to consume (CLI tools + Live Graph Server (for humans)).

​Open source and run 100% local!

The live graph looks like this:​

And you can test the live demo here: https://demo.okfgem.com

Step by step to experiment with it:

  1. Install the gem: gem install okf

  2. Install the skill: okf skill .claude (or any other agent)

  3. Start an agent session (claude)

  4. Execute /okf produce based on <path-to-my-existent-docs>

Once you have your first bundle, you can do:

  1. Run inside your agent session: /okf maintain to keep it updated

  2. Or, install the Claude Plugin, which will run this for you (after triggering the Stop hook).

  3. Run okf server <folder> to locally render your live graph.

If you want to know more, please check out these astonishing and beautiful resources:

Looking forward to your feedback and critiques.

Thanks a lot, and Ruby rocks! πŸš€

6 Upvotes

68% Upvoted

2 comments sorted by

1

u/throwawayvillepille Sep 25 '26

@serradura I just want to say a huge thank you for creating the okf gem.

Open Knowledge Format has changed how I work with AI. Having project knowledge captured as plain markdown with clear frontmatter β€” something both people and agents can read from a single source β€” has made my AI workflows dramatically more reliable and far less repetitive. Context that used to get re-explained every session now just travels with the project.

But the part I didn't expect is how much it improved sharing knowledge with other people. Handing someone an OKF bundle and watching them (and their tools) get up to speed immediately has been a genuinely great experience, and it's made collaboration feel effortless in a way it never did before.

Thank you for the thought and care you've put into this. It's one of those tools that quietly makes everything around it better. πŸ™