Install Bifrost

Install the released binary with Cargo:

cargo install brokk-bifrost --locked --force

For local development, build this checkout:

cargo build --bin bifrost

Check that the binary is available:

bifrost --help

When configuring tools that spawn Bifrost, prefer an absolute binary path unless bifrost is intentionally installed on the host PATH.

The packaged agent plugin uses a separate launcher that can download its pinned, checksum-verified Bifrost release into a user cache. See Data and Trust Boundaries for resolution order, cache locations, and the controls that disable or relocate downloads.

Python Package

Install the native Python client with pip:

pip install brokk-bifrost-searchtools

Import it as bifrost_searchtools. See Python Client for the API surface and local development workflow.

Optional Semantic Search

Semantic search is not part of the default Rust feature set. Build with --features nlp and enable it at runtime:

cargo build --features nlp --bin bifrost
BIFROST_SEMANTIC_INDEX=auto bifrost --root /path/to/project --mcp core

This core example is intentionally scoped to symbol navigation plus optional semantic search; it does not expose query_code. Use --mcp "symbol|extended" for a structural-query-capable agent, or add extended to the composition when semantic search and structural queries are both required.

See Semantic Search for model, accelerator, and index details.