block beaver
A beaver builds a dam from blocks marked with code and graph connections
LOCAL ARCHITECTURE WORKSPACE

Build a better
picture of your code.

Block Beaver maps your repository, traces the evidence, and helps you shape changes you can review.

Get started
Latest GitHub release CI status Secret scan status CodeQL status Apache-2.0 license Node.js 22, 24 and 26 Linux, macOS and Windows Report an issue

See the connections.
Keep the context.

Block Beaver is a local architecture workspace for JavaScript, TypeScript, and React. It scans source into an evidence-linked graph, helps you propose feature boundaries, and checks changes in isolated Git worktrees.

Early development. The graph supports review; it does not replace it.

Observe

Find the real edges

Explore files, components, hooks, and functions. Follow each observed connection back to a source location.

Shape

Bound a feature

Declare a block with an explicit file scope, dependencies, rationale, and verification commands.

Review

Leave a trail

Run checks in a worktree, inspect the proposal, and record decisions in a resumable roadmap ledger.

Open a map in two commands.

Requires Node.js 22.18 or newer. The browser console runs on your machine and scans the repository path you choose.

Read the full guide 
git clone https://github.com/sirnax/block-beaver.git
cd block-beaver
npm ci
npm start