# Understand Anything

> Turn any codebase, knowledge base, or docs into an interactive knowledge graph you can explore, search, and ask questions about — works with Claude Code, Cursor, Copilot, Gemini CLI, and more.

Understand Anything is an open-source plugin created by Lum1104 that transforms codebases, knowledge bases, and documentation into interactive, explorable knowledge graphs. It works natively as a Claude Code plugin and supports a wide range of AI coding platforms including Cursor, GitHub Copilot, Codex, Gemini CLI, and over a dozen others. The project is licensed under MIT and available on GitHub, where it has accumulated over 45,000 stars.

## What It Is

Understand Anything sits in the code intelligence category: it analyzes a project using a hybrid of static parsing and LLM reasoning, then produces a visual, interactive knowledge graph saved as JSON. The graph captures every file, function, class, and dependency, and layers on semantic meaning — plain-English summaries, architectural layer assignments, business domain mappings, and guided learning tours. The goal, as the project README states, is "a graph that quietly teaches you how every piece fits together," not just one that displays complexity.

## How the Multi-Agent Pipeline Works

The `/understand` command orchestrates five specialized agents in sequence:

- **project-scanner** — discovers files and detects languages and frameworks
- **file-analyzer** — extracts functions, classes, and imports; produces graph nodes and edges (runs in parallel, up to 5 concurrent, 20–30 files per batch)
- **architecture-analyzer** — assigns architectural layers (API, Service, Data, UI, Utility)
- **tour-builder** — generates guided learning walkthroughs ordered by dependency
- **graph-reviewer** — validates graph completeness and referential integrity

A sixth agent, **domain-analyzer**, is added when running `/understand-domain` to extract business domains, flows, and process steps. A seventh, **article-analyzer**, handles Karpathy-pattern LLM wikis via `/understand-knowledge`.

The underlying approach is a Tree-sitter + LLM hybrid: Tree-sitter handles deterministic structural parsing (imports, exports, call sites, inheritance), while LLMs produce semantic output (summaries, tags, domain mapping) that parsers cannot derive. This split makes the structural graph reproducible while keeping semantic annotations meaningful.

## Platform Reach and Installation

Understand Anything supports 15+ platforms through a combination of native plugin marketplace installation, auto-discovery, and a one-line shell installer:

- **Claude Code** — native plugin marketplace (`/plugin marketplace add Lum1104/Understand-Anything`)
- **Cursor** — auto-discovery via `.cursor-plugin/plugin.json`
- **VS Code + GitHub Copilot** — auto-discovery via `.copilot-plugin/plugin.json`
- **Codex, OpenCode, Gemini CLI, Cline, Trae, and others** — `install.sh` with a platform flag

The installer clones the repo to `~/.understand-anything/repo` and creates the appropriate symlinks. Windows users get a PowerShell equivalent.

## Key Capabilities

Beyond the core graph, the tool ships several commands:

- `/understand-chat` — ask natural-language questions about the codebase
- `/understand-diff` — analyze the impact of current uncommitted changes before committing
- `/understand-explain` — deep-dive into a specific file or function
- `/understand-onboard` — generate an onboarding guide for new team members
- `/understand-domain` — extract business domain knowledge as a horizontal graph
- `/understand-knowledge` — analyze a Karpathy-pattern LLM wiki into a force-directed knowledge graph with community clustering

The graph supports incremental updates (only re-analyzes changed files), a `--language` flag for localized output (English, Chinese, Japanese, Korean, Russian, and more), and a `--auto-update` flag that hooks into git post-commit to keep the graph current automatically.

## Update: v2.7.3

The latest release is v2.7.3, published on May 19, 2026, with the repository last updated on May 31, 2026. The project was created in March 2026 and has moved rapidly, accumulating over 45,900 stars and nearly 3,700 forks in that window. The Trendshift badge on the homepage reflects trending repository status. A community walkthrough video by Better Stack is featured on the project homepage, and the README lists an active Discord community for questions and contributions.

## Features
- Interactive knowledge graph of files, functions, classes, and dependencies
- Business domain mapping (domains, flows, process steps)
- Guided learning tours ordered by dependency
- Fuzzy and semantic search across the graph
- Diff impact analysis before committing changes
- Persona-adaptive UI (junior dev, PM, power user)
- Architectural layer visualization with color-coded legend
- 12 programming language concept callouts in context
- Knowledge base analysis for Karpathy-pattern LLM wikis
- Incremental updates (only re-analyzes changed files)
- Multi-language output via --language flag
- Auto-update via git post-commit hook
- Export to PNG, SVG, or filtered JSON
- Dependency path finder between any two components
- Onboarding guide generation for new team members
- Natural-language Q&A about the codebase via /understand-chat
- Tree-sitter + LLM hybrid analysis pipeline
- Multi-agent pipeline with 6-7 specialized agents
- Shareable graph via committed JSON

## Integrations
Claude Code, Cursor, VS Code + GitHub Copilot, Copilot CLI, Codex, OpenCode, Gemini CLI, Cline, Trae, Pi Agent, Vibe CLI, Hermes, KIMI CLI, OpenClaw, Antigravity, Tree-sitter, git

## Platforms
WINDOWS, MACOS, LINUX, WEB, API, VSC_EXTENSION, CLI

## Pricing
Open Source

## Version
v2.7.3

## Links
- Website: https://understand-anything.com
- Documentation: https://github.com/Lum1104/Understand-Anything
- Repository: https://github.com/Lum1104/Understand-Anything
- EveryDev.ai: https://www.everydev.ai/tools/understand-anything