Writing about the Open Knowledge Format and okf-gem: project knowledge as plain files in git, curated by agents, checked by tooling, 100% local.https://okfgem.com/enhttps://okfgem.com/blog/okf-mcp-1-0-0/https://okfgem.com/blog/okf-mcp-1-0-0/okf-mcp 1.0.0 serves your OKF bundles over the Model Context Protocol: ten read-only tools, answers bounded for a context window, and bodies that always read live from disk. It rides okf 1.13.0, which hardens every read surface against symlinks that point outside the bundle.Tue, 11 Aug 2026 14:00:00 GMThttps://okfgem.com/blog/should-your-team-adopt-okf/https://okfgem.com/blog/should-your-team-adopt-okf/The honest evaluation of the Open Knowledge Format for an engineering lead deciding adoption for other people: what it costs in hours, what happens when the author leaves, why it beats the wiki you already ignore, whether it survives a tool change, and the one thing it does not do. Framed on token cost, the number the budget and the engineers both read.Sat, 25 Jul 2026 12:00:00 GMThttps://okfgem.com/blog/okf-1-12-0/https://okfgem.com/blog/okf-1-12-0/okf 1.12.0 lets a registry live in your repo and travel with it, gives a named group of bundles a single slug you can search and serve, and teaches the graph page to open on a readable spine instead of a wall of arrows. It also adds okf graph --traffic, which reads cohesion against coupling one directory at a time.Fri, 24 Jul 2026 14:00:00 GMThttps://okfgem.com/blog/retrieve-dont-dump/https://okfgem.com/blog/retrieve-dont-dump/Most agent setups hand the whole project over on every question. okf answers by retrieving instead: a map, a search, and one file. A test in its suite fails the build if that path ever costs more than a quarter of handing the bundle over whole, and on a real project a question lands at a fortieth. The token-cost case for retrieval over dumping, and the one limit it does not cross.Fri, 24 Jul 2026 11:00:00 GMThttps://okfgem.com/blog/okf-1-11-0/https://okfgem.com/blog/okf-1-11-0/A bundle's map grows with its directory tree, and past a point nobody reads it whole. okf 1.11.0 adds okf dirs, a --depth cut on index and dirs, and a --dir filter shared across the read verbs, so orientation costs what you choose to spend. It also builds a served bundle's search index once at boot instead of rebuilding it on every request.Wed, 22 Jul 2026 12:00:00 GMThttps://okfgem.com/blog/okf-search-every-bundle/https://okfgem.com/blog/okf-search-every-bundle/The okf CLI has been able to search across bundles since 1.8.0. The page you actually read them in could not. okf 1.10.0 gives the hub a full-text search over every bundle it hosts, ranked by one shared index rather than by stapling per-bundle lists together, and moves the registry into the page it manages. It also adds a refine verb to the skill, the inbound ranking that backs it, and an extension point that lets any gem add a verb.Tue, 21 Jul 2026 12:00:00 GMThttps://okfgem.com/blog/okf-pluggable-search/https://okfgem.com/blog/okf-pluggable-search/okf 1.9.0 lets you choose how search runs. A new BM25+ full-text engine answers queries 44 to 56 times faster than the default and still ships switched off, because a CLI that exits pays the index build for a single question. The graph page also draws the authored index map as a layer, and the agent skill takes registry refs as first-class targets.Sun, 19 Jul 2026 12:00:00 GMThttps://okfgem.com/blog/okf-faster-search-off-by-default/https://okfgem.com/blog/okf-faster-search-off-by-default/minifts is a pure-Ruby port of MiniSearch, and okf 1.9.0 makes it an opt-in search engine. It sustains 44 to 56 times the linear scan's query throughput and still loses end to end, because a one-shot CLI pays the index build for a single question. This is the measurement, what the index costs when you do want it, and the sidecar that would change the arithmetic.Sun, 19 Jul 2026 11:00:00 GMThttps://okfgem.com/blog/okf-graph-index-layer/https://okfgem.com/blog/okf-graph-index-layer/Every OKF bundle carries an authored index.md per directory, and the graph page could only show them inside file-tree mode. okf 1.9.0 makes the index map a layer you can draw over any layout, with authorship shown as form. The file tree nests, the Indexes tab dissolved into a toggle, and a first-time reader is finally told where to start.Sun, 19 Jul 2026 10:00:00 GMThttps://okfgem.com/blog/okf-registry-many-bundles/https://okfgem.com/blog/okf-registry-many-bundles/okf 1.8.0 adds a persistent registry: register a bundle once and every verb reaches it as @slug from anywhere, a bare okf server hosts them all behind one hub, and search spans them in one query. The graph page grew up too, with a command palette in every mode, a shortcut sheet, and one layout from phone to desktop. And a machine-level list of named bundles is exactly the groundwork an MCP future stands on.Fri, 17 Jul 2026 00:00:00 GMThttps://okfgem.com/blog/okf-migrate-existing-docs/https://okfgem.com/blog/okf-migrate-existing-docs/Adopting a knowledge format usually means rewriting what you already wrote, which is why adoption stalls. /okf migrate, new in 1.7.0, adopts your existing Markdown in place: frontmatter and reserved files added, every body kept verbatim. The links you wrote years ago become the graph on day 0, and produce, search, and maintain compound from there.Thu, 16 Jul 2026 00:00:00 GMThttps://okfgem.com/blog/okf-render-static-graph/https://okfgem.com/blog/okf-render-static-graph/okf server draws your bundle as a live graph, but a server is a process that needs somewhere to run. okf render, new in 1.6.0, writes that same page as one static HTML file with the whole bundle baked in, so the graph hosts on GitHub Pages or anywhere static files go. The same release ships the official Docker image.Wed, 15 Jul 2026 00:00:00 GMThttps://okfgem.com/blog/run-okf-with-docker/https://okfgem.com/blog/run-okf-with-docker/okf is pure Ruby, but the Ruby on the box is not always yours to choose. The official Docker image carries the whole CLI, so validate, lint, search, and the live graph run with nothing to install. Multi-arch, built from source, on ghcr.io.Tue, 14 Jul 2026 00:00:00 GMThttps://okfgem.com/blog/what-is-okf/https://okfgem.com/blog/what-is-okf/OKF is an open, vendor-neutral format for keeping project knowledge as Markdown + YAML, versioned with the code and readable by people and agents from the same file. How a bundle works, and how to start one.Mon, 13 Jul 2026 00:00:00 GMThttps://okfgem.com/blog/why-okf-gem/https://okfgem.com/blog/why-okf-gem/Standards are what make scale possible. How my agent workflow evolved from spec frameworks to a well-documented harness, and why that led to a complete OKF toolkit: skill, CLI, Ruby objects, and a mountable graph. 100% local.Mon, 13 Jul 2026 00:00:00 GMT