Skip to main content
This guide gets you from installation to an interactive knowledge graph as fast as possible. For full installation options across all platforms, see the Installation guide.

Prerequisites

Steps

1

Install the plugin

In Claude Code, run:
/plugin marketplace add Lum1104/Understand-Anything
/plugin install understand-anything
For other platforms (Codex, OpenCode, Cursor, OpenClaw, Antigravity), see the Installation guide.
2

Analyze your codebase

Open a terminal in your project directory and run:
/understand
A multi-agent pipeline starts immediately. It runs 5 specialized agents in sequence:
  1. project-scanner — discovers all files, detects languages and frameworks
  2. file-analyzer — extracts functions, classes, and imports from each file (up to 3 in parallel)
  3. architecture-analyzer — groups files into logical layers (API, Service, Data, UI, etc.)
  4. tour-builder — generates a guided tour ordered by dependency
  5. graph-reviewer — validates graph completeness and referential integrity
When complete, the knowledge graph is saved to .understand-anything/knowledge-graph.json in your project.
On subsequent runs, Understand Anything only re-analyzes files that changed since the last run. Large codebases stay fast after the first analysis.
3

Open the dashboard

Once analysis completes, the dashboard opens automatically. You can also open it manually:
/understand-dashboard
The interactive web UI shows your codebase as a graph — color-coded by architectural layer, with every node labelled and searchable.What you’ll see:
  • Nodes for each file, function, class, and module
  • Edges showing imports, calls, inheritance, and other relationships
  • A layer legend in the top-left (click to filter)
  • A search bar at the top
  • A sidebar showing project overview on the right
Click any node to see its plain-English summary, file path, complexity rating, and direct connections.
4

Explore and ask questions

With your codebase loaded, use the full command set:
# Ask any question about the codebase
/understand-chat How does authentication work?

# See the impact of your current uncommitted changes
/understand-diff

# Deep-dive into a specific file or function
/understand-explain src/auth/login.ts

# Generate an onboarding guide for a new team member
/understand-onboard
Start with /understand-chat and an open-ended question like “what are the main layers of this codebase?” to get oriented quickly.

What’s next

Command Reference

Full documentation for every command and option.

Dashboard Guide

Learn how to navigate the interactive knowledge graph.

Core Concepts

Understand the knowledge graph structure and how it’s built.

Platform Guides

Install on your preferred AI coding platform.

Build docs developers (and LLMs) love