Home

codebase-vis

A local CLI tool that parses codebases, builds dependency graphs from AST analysis, and outputs interactive architecture visualizations. Zero-cloud, local-first — everything runs on your machine.

Quick Start

npm install -g codebase-vis
cd my-project
codebase-vis init     # create .agentignore
codebase-vis generate # parse & build graph
codebase-vis serve    # open visualizer at localhost:3000

At a Glance

Command	What It Does
init	Creates .agentignore with stack-aware defaults
generate	Discovers files, parses ASTs, builds dependency graph, exports HTML+JSON
serve	Serves interactive visualizer locally
query	Shows dependencies and dependents of any file
path	Finds shortest dependency chain between two files
explain	Generates LLM-powered architectural summaries via Groq API
detect	Finds circular dependencies
clean	Removes all generated output

Quick Links

• Installation
• Getting Started
• Commands Overview
• Architecture Overview
• Contributing
• Troubleshooting