---
title: "okfctl"
description: "Author and maintain Open Knowledge Format (OKF) bundles from your agent, scaffold and validate nodes, run curation health checks, plan v0.1→v0.2 migrations, and query the opt-in semantic layer."
canonical: https://agentpluginsdirectory.com/plugins/okfctl
last-updated: 2026-10-02
---

# okfctl
Author and maintain Open Knowledge Format (OKF) bundles from your agent, scaffold and validate nodes, run curation health checks, plan v0.1→v0.2 migrations, and query the opt-in semantic layer.
- Slug: okfctl
- Publisher: Casey West
- Repository: https://github.com/cwest/okfctl
- Manifest: plugin.json
- License: Apache-2.0
- Category (editorial): databases
- Skills: 4 (okf-authoring, okf-curation-health, okf-migrate-plan, okf-semantic-search)
- MCP servers: 0
- Stars: 8
- Repository created: 2026-07-21
- Repository last pushed: 2026-10-01
- Publisher type: User
- Listing: https://agentpluginsdirectory.com/plugins/okfctl
- Schema: https://agent-plugins.org/schemas/1.0.0/plugin.schema.json

## What okfctl does, in the publisher's words

Markdown knowledge bases don't rot because people stop writing. They rot because nothing keeps the structure honest, links break on a rename, the index drifts from the tree, provenance goes stale, and no one notices until the corpus is already a maze.

okfctl is the tool that keeps it honest. It authors and maintains Open Knowledge Format (OKF) bundles, a curated tree of Markdown "nodes" with a link graph, reserved index.md/log.md files, and frontmatter provenance: and it checks the whole thing against the spec so drift surfaces as a finding instead of a surprise.

Use okfctl to scaffold a bundle, add and move nodes without breaking links, keep the reserved index and change log current, check a corpus against the spec, and inspect its health and link graph. It's a single static Go binary, so it runs anywhere without a toolchain, an interpreter, or a model download.

From the project README, punctuation lightly normalized. Full text: https://raw.githubusercontent.com/cwest/okfctl/HEAD/README.md

## Skills

- okf-authoring: Use when creating or maintaining nodes in an OKF bundle with okfctl, scaffolding concept nodes, applying type templates, running the bundle lifecycle, and keeping the reserved index.md and log.md files current.
- okf-curation-health: Use when keeping an OKF bundle healthy with okfctl, running validate for spec-floor and type-template conformance, and lint for curation findings (orphans, missing cross-references, broken internal links, coverage gaps, type hygiene), including as a CI or pre-commit gate.
- okf-migrate-plan: Use when working an okfctl migrate-plan.json: the judgment items okfctl migrate refuses to guess when upgrading a v0.1 bundle to v0.2. Covers the deterministic/judgment split, handing a plan to any agent or working it by hand, and verifying the applied migration.
- okf-semantic-search: Use when adding the opt-in semantic layer to an OKF bundle with okfctl, configuring an offline embedding model, building the semantic index with okfctl-search, running semantic search/related, and driving lint --semantic (similar-unlinked, no-semantic-neighbors) with the reasoning behind the calib…

Descriptions come from the frontmatter of each SKILL.md, punctuation lightly normalized.