SUPERGRAPH

Your entire monorepo in one file.

supergraph analyzes your monorepo and generates a unified text map — every module, schema, endpoint, type, and cross-package edge. Domain-aware. Fits in one AI context window. For humans, 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 and /high-level for Claude Code.

01 — The Output

superhigh.txt

Domains, schemas, modules, types, and edges — unified into one file. An agent reads it once and knows the entire architecture. A human greps it and gets answers.

audit/superhigh.txt — real output, 21 packages

SUPERHIGH | 2026-03-05

# PART 1 — DOMAINS

[guild]
r/guild GET /v2/guilds/:id  cache:60s
c/guild createGuild,updateGuild,deleteGuild
z/GuildSchema id:str name:str urlName:str? imageUrl:str? +8
t/guilds id:int name:varchar url_name:varchar +12

# PART 2 — PACKAGES

[fortress]
actors/orchestrator [68/93]<-2 OrchestratorActorContext,actor,+63
events [119/120]<-16 AbortEvent,ActorErrorLog,+111

# PART 3 — TYPES

GuildResponse { id:num name:str urlName:str roles:Role[] +6 }
CreateGuildInput { name:str urlName:str? description:str? }

domains

Domain-Aware

Routes, controllers, Zod schemas, SQL tables, and Redis keys grouped by domain.

schemas

Full Schema Fields

Zod schemas, SQL tables, and TS types with field definitions inline. No separate lookup needed.

shortcut

Two Versions

superhigh.txt (full) and superhigh-shortcut.txt (compressed paths, abbreviated deps) for context-constrained agents.

02 — Deep Audit

/deep-audit pkg/src

Claude Code slash command. Point it at a package, it reads the superhigh map, audits source files across 10 phases, writes findings and fix plans to disk. Say "do all" and it executes them.

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

Self-contained interactive module graph. Zero dependencies. The background of this page is a live one.

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