okf-cli — Open Knowledge Format tooling
Convert plain markdown directories into OKF-conformant knowledge bundles. okf bundle generates YAML frontmatter, concept types, provenance, and per-directory index.md files; okf validate, okf list, and okf read consume the resulting bundle.
Install
uv tool install okf-cli
Dev quickstart
uv sync
uv run okf --help
uv run okf --version
Commands
| Command | Purpose |
|---|---|
okf bundle <input-dir> [output-dir] |
Convert markdown into an OKF bundle |
okf validate <directory> |
Check OKF v0.2 §11 conformance |
okf list <directory> |
List concepts (ID, type, title, description) |
okf read <directory> <concept-id> |
Print a concept by ID |
Run okf <command> --help for options such as --default-type, --force, --strict, and --dry-run.
Quick example
uv run okf bundle example --default-type reference --force
uv run okf validate example_knowledge_base
uv run okf list example_knowledge_base
uv run okf read example_knowledge_base tables/customers
Documentation
- Detailed user and contributor docs: openwiki/quickstart.md
- Agent contributor context: AGENTS.md
- OKF v0.2 specification: SPEC/OKF_SPEC_V0_2.md
1 maintainer
Release files for okf-cli 0.6.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| okf_cli-0.6.0.tar.gz | 59.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| okf_cli-0.6.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 75.1 kB
Release files / okf_cli-0.6.0.tar.gz
| Download URL | okf_cli-0.6.0.tar.gz |
|---|---|
| Size | 59.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e4d0473005c2dfba7d613a242d3585ff379d62d9d9ade59765d2dbc063d0fb2e
|
|
BLAKE2b-256 checksum How to use checksums |
58ba0d835cd863c7278bb2e6024de1ba8f1c13f7f7c389c99a14ca0a30bf07ca
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.9 {"installer":{"name":"uv","version":"0.10.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Arch Linux","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / okf_cli-0.6.0-py3-none-any.whl
| Download URL | okf_cli-0.6.0-py3-none-any.whl |
|---|---|
| Size | 15.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
73c76ca0e6cdd1e85dfb809c56629651d6249ec63877d3ec776add98a4ddce10
|
|
BLAKE2b-256 checksum How to use checksums |
6bda05297f94b05a30f0eb33ecab7f1ba790d553d52e0e3467d11ef34a0847cc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.9 {"installer":{"name":"uv","version":"0.10.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Arch Linux","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
