Bifrost

Quickstart · Documentation · Ten-minute evaluation · Discord

Why Bifrost?

bifrost is Brokk's Rust-based static analysis toolbox for AI coding harnesses, editors, and large repositories.

Bifrost gives every supported language a shared intermediate representation, so the same structural query and navigation workflows work across a mixed-language repository instead of stopping at language boundaries.

• One multi-language IR. Parse unbuilt or partially broken workspaces and normalize their source structure for cross-language analysis.
• A real query language. Use JSON CodeQuery or the Rune Query Language (RQL) to find language-neutral code shapes and traverse indexed declarations, references, calls, imports, and type relationships.
• Built for agents and editors. Expose structured MCP tools to coding agents, LSP features to editors, and the same analyzer through the CLI, Python, and Rust.
• Designed for active repositories. Snapshot isolation, incremental updates, content-based caching, and git/worktree awareness keep analysis responsive as a repository changes.

See Choose Bifrost for the right interface for your workflow, and the Language and Analysis Capabilities matrix for language-by-language support, precision tiers, and current analysis boundaries.

Run Your First Query

Install the released CLI, clone the small verified evaluation fixture, and run its saved RQL query:

curl -fsSL https://raw.githubusercontent.com/BrokkAi/bifrost/refs/heads/master/install.sh | bash
git clone --depth 1 https://github.com/BrokkAi/bifrost.git
cd bifrost/docs/fixtures/ten-minute-evaluation
bifrost --root . --query-file queries/find-audit.rql

Users with uv or pipx can instead run uv tool install brokk-bifrost or pipx install brokk-bifrost; both install the same native bifrost command from a platform wheel in an isolated environment. uvx brokk-bifrost --version runs it without a persistent install.

The installer downloads the checksum-verified release binary into ~/.local/bin on macOS (Apple Silicon and Intel), Linux (x86-64 glibc or musl, ARM64 glibc), WSL, and Android under Termux. Homebrew users on macOS and Linux (x86-64 and ARM64 glibc) can run brew install brokkai/tap/bifrost instead. On Windows, and on ARM64 musl distributions such as Alpine, build from source with cargo install brokk-bifrost --locked. See Install Bifrost for the full platform table.

The result identifies the normalized Python call and its exact source location: