Commit a new concept to the knowledge bundle.

Creates a concept file with the given title, type, and content. Optionally checks for duplicate concepts before committing.

Initialize a new OKF knowledge bundle at the specified path.

Creates .okf/config.json, a root index.md, and updates .gitignore if in a git repo. This is the only tool that does not require a pre-configured bundle.

Update an existing concept in the bundle.

Applies only the provided fields to the concept, leaving unspecified fields unchanged. Re-embeds the content and updates the vector index.

Move or rename a concept within the bundle.

Changes the concept's location (and therefore its concept_id) without losing content, metadata, or vector-index history. Optionally updates the title in frontmatter at the same time.

Examples:

• Rename: concept_id="notes/old-name", new_concept_id="notes/new-name"

• Move: concept_id="drafts/idea", new_concept_id="published/idea"

• Both: concept_id="tmp/scratch", new_concept_id="guides/setup-guide", new_title="Setup Guide"

Delete a concept from the bundle by its concept_id.

Show the full details of a concept by its concept_id.

Returns all frontmatter fields and the complete markdown body.

Rebuild the vector index for the knowledge bundle.

Performs an incremental reindex by default (only processes changed files). Set full=True to discard the existing index and rebuild from scratch.

Returns a JSON summary with counts of added, updated, removed, skipped concepts and the total number of indexed concepts.

Search the knowledge bundle using natural language queries.

Returns a ranked list of matching concepts with scores and snippets. Supports hybrid (semantic + keyword), keyword-only, or semantic-only modes.

List concepts in the knowledge bundle with optional filters.

Returns a filtered, sorted list of concepts. Supports filtering by type, tags, modification date, and path prefix.

Return bundle health statistics.

Returns concept count, type/tag distributions, last reindex timestamp, and the number of concepts pending re-embedding.