BiGI

Blast-radius Impact Graph Indexer

BiGI shows what breaks before you change the code. Hosted at AtlasMindAI/bigi.

Visualize downstream impact across any codebase.

Features

BiGI scans a repository and shows what changes affect downstream code.

• Works on any codebase (universal language fallback and text/binary auto-detection)
• Finds functions, files, scripts, rules, and links between them
• Traces downstream impact from a change
• Shows modified files inside the graph
• Finds the shortest path between two nodes
• Groups by file, folder, or package
• Limits focus to 1, 2, 3, or all hops
• Exports HTML, GraphML, and PR reports
• Adds a command palette for fast access
• Interactive Force Controls: Adjust gravity, repulsion strength, damping, and spring lengths in real-time
• Code Viewer: Prism.js Tomorrow-themed source code viewer embedded directly inside the details panel
• Label-Collision Mitigation: WebAssembly physics engine resolves overlap forces on both axes to prevent clustered label overlaps
• Floating Modality Legend: Dynamic color-coded legend overlay mapped to node types
• Supports webcam hand control for pan, zoom, pause, and node selection

Setup

Fastest way

pip install git+https://github.com/AtlasMindAI/bigi.git

Check it

bigi --help

From source

git clone https://github.com/AtlasMindAI/bigi.git
cd BiGI
pip install -e .

Optional npm wrapper

npx bigi --help

Usage

Build a graph

bigi analyze path/to/codebase --html graph.html

Open graph.html in a browser to inspect the graph.

Trace impact

bigi impact my_function --pipeline-dir path/to/codebase/

Export GraphML

bigi analyze . && bigi export graph.graphml

Analyze multiple repositories

bigi analyze repo1/ repo2/ repo3/ --html org_graph.html

Run the live monitor

bigi monitor --html graph.html --log run.log

Graph tools

• Command palette with Ctrl/Cmd + K
• Recent commands and pinned commands
• Single help view for every action
• Hand control with webcam input
• Pinch to select a node
• Open palm to pause or resume the graph

What it does

BiGI helps answer questions like:

• What breaks if I change this function, file, or script?
• Which nodes depend on this one?
• Which files were modified in this repo?
• How do I export the graph for review or tooling?

Output

BiGI can generate:

• an interactive HTML graph
• GraphML for Cytoscape, Gephi, or other graph tools
• a markdown PR impact report
• a live execution overlay for jobs, tasks, and runs

GitHub Action

BiGI can run automatically on pull requests to analyze change propagation and post an impact/blast-radius report directly as a PR comment.

Basic Workflow Configuration

Create a file named .github/workflows/bigi.yml in your repository:

name: BiGI Blast Radius Analysis

on:
  pull_request:
    types: [opened, synchronize, reopened]

# Permissions required to post PR comments
permissions:
  pull-requests: write
  contents: read

jobs:
  analyze-impact:
    runs-on: ubuntu-latest
    steps:
      - name: Run BiGI Blast Radius
        uses: AtlasMindAI/bigi@main
        with:
          pipeline-dir: '.' # Directory to scan (default is repo root)
          python-version: '3.11' # Python version to run (default is 3.11)

Action Configuration Inputs

Input	Description	Required	Default
pipeline-dir	The directory to scan for pipeline and source files (relative to repository root).	No	.
python-version	Python version to run for building the dependency graph.	No	3.11

Important

The composite action automatically checks out the repository with fetch-depth: 0 to properly parse git history and detect modified files. You do not need to call actions/checkout manually in your job steps.

How it works

1. Parse supported files and extract functions, calls, files, and schema reads.
2. Build a directed graph of dependencies.
3. Trace downstream impact from the item you changed.
4. Render the result in a self-contained HTML view.

Hand control

Open the graph, turn on Hand Control, and use your webcam to control the view.

• Move your hand to pan
• Change hand size to zoom
• Pinch to select a nearby node
• Open palm to pause or resume the graph
• Works best in a well-lit room with camera permission enabled

CLI reference

Command	Description
bigi analyze <dir|url> [--html out.html]	Build a graph and optionally export HTML
bigi impact <symbol> [--pipeline-dir .]	Trace downstream impact for a rule, function, or file
bigi export <file.graphml>	Export the saved index to GraphML
bigi pr-report [--pipeline-dir .] [--output report.md]	Generate a markdown blast radius report
bigi remediate <symbol> --prompt "..."	Ask Gemini for a code fix with impact context
bigi monitor --html graph.html --log run.log	Serve the graph and stream execution state

Testing

pytest tests/ -v

Vercel

BiGI can also run as a web app for any public GitHub codebase. Visit your deployment and append owner/repo:

https://your-bigi-app.vercel.app/AtlasMindAI/bigi