okf-manager

Build and maintain an Open Knowledge Format (OKF) knowledge base from Claude Code — for developers consolidating a repo's knowledge and for non-technical knowledge workers building an AI-readable second brain. OKF bundles are plain directories of markdown files with YAML frontmatter: human-readable, git-friendly, and consumable by any AI agent without an SDK or server. A dependency-free stdlib Python 3 engine keeps a bundle healthy and hard to let rot; every write previews first and is never destructive. Authoring and upkeep: `start` (guided onboarding), `new` (scaffold a concept or bundle), `add` (import existing markdown), `move` (link-safe rename/relocate), `check` (validate frontmatter + required `type`, broken cross-links, orphaned and stale concepts, index drift, `okf_version`, and agent-curated concepts missing citations — with a preview-gated `--fix` that regenerates indexes and frontmatter ordering but never deletes files or retargets links), and `map` (a self-contained, zero-dependency offline browser for the bundle — search, a reader panel with links and backlinks, and a needs-attention lens mirroring `check`, plus an optional graph view), plus an always-on `okf` conventions skill. Ingestion: `convert` (.txt/.html/.csv/.json — or agent-extracted PDF/docx — into one concept), `scan` (triage a repo or folder for importable knowledge), and `find` (ranked keyword/field search). Producing: `seed` (generate concepts in bulk from a SQLite database, OpenAPI/JSON-Schema file, or directory tree) and `enrich` (grow a bundle from web pages you point it at, with the agent applying a required domain allowlist and a 50-page cap — the engine itself never goes online). Claude Code only for now. Sync-agnostic — manage the knowledge here, sync the folder however you like (git, cloud folder, Obsidian, Syncthing).