Quick start

Installation

pip install okflint
# or with uv:
uv add okflint

Auditing a base

okflint audit --bundle /path/to/base --vault /path/to/vault

Displays a summary: file count, OKF status, broken links, split candidates. Add --apply to write the JSON report to .okflint/.

Validation (CI gate)

okflint validate --manifest okf-base.yaml docs/

Returns exit 0 if all files are conformant, exit 1 otherwise. Add --json for machine-readable JSON output suitable for CI.