bifrost

<h1 align="center">Bifrost</h1> <p align="center"> <a href="https://bifrost.brokk.ai/"> <img src="docs/src/assets/bifrost-social-card.svg" alt="Bifrost — code intelligence for AI, with structural queries and multi-language analysis designed for repository-scale use" width="720"> </a> </p> <p align="center"> <a href="https://github.com/BrokkAi/bifrost/actions/workflows/ci.yml"><img src="https://github.com/BrokkAi/bifrost/actions/workflows/ci.yml/badge.svg" alt="CI"></a> <a href="https://github.com/BrokkAi/bifrost/releases/latest"><img src="https://img.shields.io/github/v/release/BrokkAi/bifrost" alt="Latest release"></a> <a href="https://crates.io/crates/brokk-bifrost"><img src="https://img.shields.io/crates/v/brokk-bifrost" alt="crates.io"></a> <a href="https://pypi.org/project/brokk-bifrost-searchtools/"><img src="https://img.shields.io/pypi/v/brokk-bifrost-searchtools" alt="PyPI"></a> <a href="LICENSE.md"><img src="https://img.shields.io/github/license/BrokkAi/bifrost" alt="LGPL-3.0-or-later"></a> </p> <p align="center"> <a href="#run-your-first-query">Quickstart</a> · <a href="https://bifrost.brokk.ai/">Documentation</a> · <a href="https://bifrost.brokk.ai/evaluate-bifrost/">Ten-minute evaluation</a> · <a href="https://discord.gg/geYkWUeH">Discord</a> </p>

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:

cargo install brokk-bifrost --locked
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

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

{
  "isError": false,
  "structuredContent": {
    "results": [
      {
        "enclosing_symbol": "src.app.handle",
        "end_line": 5,
        "kind": "call",
        "language": "python",
        "path": "src/app.py",
        "result_type": "structural_match",
        "start_line": 5,
        "text": "audit(value)"
      }
    ],
    "truncated": false
  }
}

Continue with the ten-minute evaluation to run the same query through the CLI, an MCP-connected coding agent, and VS Code.

See Bifrost in Action

Turn Source into a Query in VS Code

<p align="center"> <a href="https://bifrost.brokk.ai/rune-ir/"> <img src="docs/src/assets/bifrost-vscode-query-playground.gif" alt="Selecting Python source in VS Code, inspecting its normalized Rune IR, using the generated starter RQL, and browsing the exact query result" width="900"> </a> </p>

Select a source