okq-reference

okq is a fast, deterministic, local-first CLI for querying OKF bundles, Obsidian vaults, or any Markdown-with-frontmatter collection. No network, no embeddings, no API key — same bundle, same answer, every time. Use it instead of grep/rg/yq when working in a Markdown-with-frontmatter knowledge base.

Bundle basics

• A bundle is a directory of Markdown files, each with YAML frontmatter; one concept per file. --bundle <dir> selects it (default: current directory).
• A concept id is the path without .md: adrs/0004-exit-code-taxonomy. Partial ids resolve if unambiguous. get also accepts the .md path.
• index.md / log.md are reserved and are not concepts.
• Malformed files are skipped, not fatal — they never crash a query.

Commands