BiGI

Blast-radius Impact Graph Indexer

BiGI shows what breaks before you change the code in any codebase.

Visualize downstream impact across any codebase.

Features

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

• Works on any codebase
• 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
• 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 comment on pull requests with the downstream impact of changed files.

name: BiGI Blast Radius
on:
  pull_request:
    branches: [main, master]

permissions:
  pull-requests: write
  contents: read

jobs:
  blast-radius:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - uses: AtlasMindAI/bigi@main
        with:
          pipeline-dir: '.'
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

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