kbolt

kbolt is the command-line application for local-first indexing and retrieval over local notes and docs.

What it supports

• Register local directories as collections
• Search with keyword, semantic, reranked, and deep modes
• Organize collections into spaces
• Fetch source files with get, multi-get, and ls
• Check readiness with doctor and models list
• Serve the index over MCP with kbolt mcp

Typical flow

Install llama.cpp so llama-server is available, then run:

kbolt setup local
kbolt doctor
kbolt collection add /path/to/docs
kbolt search "your query"

kbolt collection add indexes immediately by default.

To enable deep search later:

kbolt local enable deep

This crate is the main user-facing package in the workspace. Most users should install and run kbolt, not the internal kbolt-core, kbolt-mcp, or kbolt-types crates directly.