SUPERGRAPH

Your entire monorepo in one file.

supergraph analyzes your monorepo and generates a compact text map of every module, symbol, dependency edge, and issue. ~500 lines that fit in any AI context window. For humans, it generates an interactive graph visualization.

$ curl -fsSL https://raw.githubusercontent.com/bravenewxyz/supergraph/master/install.sh | bash

$ brew install bravenewxyz/supergraph/supergraph

Also installs /deep-audit for Claude Code.

01 — The Output

supergraph.txt

Run supergraph in any monorepo. Get audit/supergraph.txt — every package, module, exported symbol, and cross-package edge in a structured, compressed format.

audit/supergraph.txt — real output, 21 packages

GNOMEFORTRESS-V2 SUPERGRAPH | 2026-03-05
365m · 852ie · 209xe

# PACKAGES  (short=npm,modules)
agent=@gnomefortress/agent,7m  cli=@gnomefortress/cli,13m
core=@gnomefortress/core,14m  fortress=@gnomefortress/fortress,85m
graph=@gnomefortress/graph,37m  flow=@gnomefortress/flow,35m  ...

# MODULES  path [exp(/total)]<-importers symbols | ext-deps

[fortress]
actors/orchestrator [68/93]<-2 OrchestratorActorContext,OrchestratorActorInput,actor,+63
    | @gnomefortress/constants,@gnomefortress/graph,xstate
events [119/120]<-16 AbortEvent,ActorErrorLog,AnomalyDetectedEvent,+111
    | @gnomefortress/graph,xstate

[graph]
store/graph-store [2/4]<-9 SerializedGraph,GraphStore | graphology
schema/nodes [4]<-11 SymbolNode,SymbolKind,createSymbolNode,KIND_PRIORITY

# CROSS-PACKAGE DEPENDENCIES
fortress/actors/orchestrator -> constants/idx graph/idx utils/idx xstate/idx
fortress/events -> graph/idx graph-bridge/idx xstate/idx

[68/93]

Symbol Counts

Exported vs total per module. API surface at a glance.

<-16

Fan-in

How many modules depend on this one. High = critical. Zero = dead code.

Cross-Package Edges

Every inter-package import, explicit and queryable.

02 — Deep Audit

/deep-audit pkg/src

10-phase systematic code audit as a Claude Code slash command. Finds bugs, dead code, race conditions, schema mismatches, and overengineering. Writes actionable plans to disk.

Generate & Read

Runs supergraph, reads all artifacts. Full context before analysis begins.

Structural Audit

Dead exports, circular deps, complexity hotspots, oversized modules.

Deep Read

Source files prioritized by risk. Duplicates, inconsistencies, bugs, unfinished features.

Cross-Cutting

Architectural coherence, abstraction consistency, SRP violations.

Data Flow

Schema-type mismatches, unsafe assertions, error paths, missing validation.

Logic

Decision table gaps, guard consistency, temporal ordering bugs.

Invariants

Property-based tests on pure functions. Distinguishes real bugs from wrong invariants.

Plans & Execute

Groups findings into actionable plans by severity. Dispatches fixes via parallel subagents.

Output: audit/<pkg>/findings.md + audit/<pkg>/plans/. No subagent delegation during analysis — full cross-file context throughout.

03 — Visualization

supergraph.html

Also generates a self-contained interactive graph. Force-directed physics, search, package filtering, issue overlays. The background of this page is a live example.

Key	Action
`p`	Toggle physics
`l`	Toggle labels
`scroll`	Zoom
`drag`	Pan / pin nodes
`click`	Inspect node symbols