okf in brief: CLI and MCP server for OKF catalogues

okf is one binary that searches, checks and edits a catalogue of OKF v0.2 bundles, so you can pick the chapter that matches your task: install it, try it, or connect an agent.

Specification first

okf follows the Open Knowledge Format specification and is adapted when the specification changes. It is bound to OKF v0.2: the v0.2 rules run only in bundles whose root index declares okf_version: "0.2". No release date is promised for a new specification version.

What okf is

• A single static Go binary named okf. It needs no Python and no uv at run time. uv is needed only by the MCP server that okf install registers.
• It works on a catalogue: a directory whose subdirectories are OKF bundles of Markdown files with YAML frontmatter.
• Four groups of commands, as in okf --help: navigation, search, tags and maintenance.

What you can do

SearchRanked search plus the --where filter.

Context bundlesCurated reading lists per topic.

Conformance checksScan a catalogue against the format rules.

Safe editsPreview, then apply renames and fixes.

Tags and registryKeep tags consistent.

Canon blocksOne source of truth, copies that stay in sync.

Where to go next

InstallationGet the okf binary.

First stepsIndex, find, read and check a catalogue.

ConceptsCatalogue, bundle, concept and type.

Agent onboardingMCP server, skill and okf prime.

Command referenceEvery command with its options.