Turn any codebase, knowledge base, or docs into an interactive knowledge graph you can explore, search, and ask questions about. Works with Claude Code, Codex, Cursor, Copilot, Gemini CLI, and more.
Understand Anything. Understand Anyone. AI should help people, not replace them.
English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Español | Türkçe | Русский
An open-source project from Egonex Originally created by Lum1104.
You just joined a new team. The codebase is 200,000 lines of code. Where do you even start?
Understand Anything is a Claude Code Plugin that analyzes your project with a multi-agent pipeline, builds a knowledge graph of every file, function, class, and dependency, then gives you an interactive dashboard to explore it all visually. Stop reading code blind. Start seeing the big picture.
The goal isn't a graph that wows you with how complex your codebase is — it's a graph that quietly teaches you how every piece fits together.
The goal isn't a graph that wows you with how complex your codebase is — it's a graph that quietly teaches you how every piece fits together.
✨ Features
Note
Want to skip the reading? Try the live demo in our homepage — a fully interactive dashboard you can pan, zoom, search, and explore right in your browser.
Explore the structural graph
Navigate your codebase as an interactive knowledge graph — every file, function, and class is a node you can click, search, and explore. Select any node to see plain-English summaries, relationships, and guided tours.
Understand business logic
Switch to the domain view and see how your code maps to real business processes — domains, flows, and steps laid out as a horizontal graph.
Analyze knowledge bases
Point /understand-knowledge at a Karpathy-pattern LLM wiki and get a force-directed knowledge graph with community clustering. The deterministic parser extracts wikilinks and categories from index.md, then LLM agents discover implicit relationships, extract entities, and surface claims — turning your wiki into a navigable graph of interconnected ideas.
/understand-knowledge
index.md
🧭 Guided Tours Auto-generated walkthroughs of the architecture, ordered by dependency. Learn the codebase in the right order. 🔍 Fuzzy & Semantic Search Find anything by name or by meaning. Search "which parts handle auth?" and get relevant results across the graph. 📊 Diff Impact Analysis See which parts of the system your changes affect before you commit. Understand ripple effects across the codebase. 🎭 Persona-Adaptive UI The dashboard adjusts its detail level based on who you are — junior dev, PM, or power user. 🏗️ Layer Visualization Automatic grouping by architectural layer — API, Service, Data, UI, Utility — with color-coded legend. 📚 Language Concepts 12 programming patterns (generics, closures, decorators, etc.) explained in context wherever they appear.
Turn any codebase, knowledge base, or docs into an interactive knowledge graph you can explore, search, and ask questions about. Works with Claude Code, Codex, Cursor, Copilot, Gemini CLI, and more.
Understand Anything. Understand Anyone. AI should help people, not replace them.
English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Español | Türkçe | Русский
An open-source project from Egonex Originally created by Lum1104.
You just joined a new team. The codebase is 200,000 lines of code. Where do you even start?
Understand Anything is a Claude Code Plugin that analyzes your project with a multi-agent pipeline, builds a knowledge graph of every file, function, class, and dependency, then gives you an interactive dashboard to explore it all visually. Stop reading code blind. Start seeing the big picture.
🧭 Guided Tours
Auto-generated walkthroughs of the architecture, ordered by dependency. Learn the codebase in the right order.
🔍 Fuzzy & Semantic Search
Find anything by name or by meaning. Search "which parts handle auth?" and get relevant results across the graph.
📊 Diff Impact Analysis
See which parts of the system your changes affect before you commit. Understand ripple effects across the codebase.
🎭 Persona-Adaptive UI
The dashboard adjusts its detail level based on who you are — junior dev, PM, or power user.
🏗️ Layer Visualization
Automatic grouping by architectural layer — API, Service, Data, UI, Utility — with color-coded legend.
📚 Language Concepts
12 programming patterns (generics, closures, decorators, etc.) explained in context wherever they appear.
A multi-agent pipeline scans your project, extracts every file, function, class, and dependency, then builds a knowledge graph saved to .understand-anything/knowledge-graph.json.
.understand-anything/knowledge-graph.json
Localized output: Use --language to generate content in your preferred language:
--language
Generate Chinese content (知识图节点描述和 Dashboard UI) /understand --language zh # Supported languages: en (default), zh, zh-TW, ja, ko, ru
On the first run in a project — when you don't pass --language and no language is stored yet — /understand detects the language you're conversing in. If it isn't English, it asks you to confirm (or override) before generating; English conversations are unaffected. Your choice is saved to .understand-anything/config.json and reused on every later run.
--language
/understand
.understand-anything/config.json
The --language parameter affects:
--language
Node summaries and descriptions in the knowledge graph
Dashboard UI labels, buttons, and tooltips
Guided tour explanations
Explore the dashboard
/understand-dashboard
An interactive web dashboard opens with your codebase visualized as a graph — color-coded by architectural layer, searchable, and clickable. Select any node to see its code, relationships, and a plain-English explanation.
Keep learning
Ask anything about the codebase /understand-chat How does the payment flow work? # Analyze impact of your current changes /understand-diff # Deep-dive into a specific file or function /understand-explain src/auth/login.ts # Generate an onboarding guide for new team members /understand-onboard # Extract business domain knowledge (domains, flows, steps) /understand-domain # Analyze a Karpathy-pattern LLM wiki knowledge base /understand-knowledge ~/path/to/wiki # Re-run anytime — incremental by default (only re-analyzes changed files) /understand # Auto-update on every commit via a post-commit hook /understand --auto-update # Scope to a subdirectory (for huge monorepos) /understand src/frontend
🌐 Multi-Platform Installation
Understand-Anything works across multiple AI coding platforms.
Cursor auto-discovers the plugin via .cursor-plugin/plugin.json when this repo is cloned. No manual installation needed — just clone and open in Cursor.
.cursor-plugin/plugin.json
If auto-discovery doesn't pick it up, install it manually: open Cursor Settings → Plugins, paste https://github.com/Egonex-AI/Understand-Anything into the search field, and add it from there.
https://github.com/Egonex-AI/Understand-Anything
VS Code + GitHub Copilot
VS Code with GitHub Copilot (v1.108+) auto-discovers the plugin via .copilot-plugin/plugin.json when this repo is cloned. No manual installation needed — just clone and open in VS Code.
.copilot-plugin/plugin.json
For personal skills (available across all projects), run the install.sh above with the vscode platform.
Keep it fresh: enable /understand --auto-update — a post-commit hook incrementally patches the graph so each commit lands with a matching graph. Or re-run /understand manually before releases.
Tree-sitter (deterministic) — parses source into a concrete syntax tree and extracts structural facts: imports, exports, function/class definitions, call sites, inheritance. Pre-resolved into an importMap during the scan phase and passed to file-analyzers so they don't re-derive imports from source. Same input → same output, every run. Also powers fingerprint-based change detection for incremental updates.
importMap
LLM (semantic) — reads the parsed structure alongside the original source to produce what parsers can't: plain-English summaries, tags, architectural layer assignments, business-domain mapping, guided tours, language concept callouts.
This split is why the graph is reproducible on the structural side (the same code always yields the same edges) while still capturing intent on the semantic side (what a file is for, not just what it imports).
Multi-Agent Pipeline
The /understand command orchestrates 5 specialized agents, and /understand-domain adds a 6th:
/understand
/understand-domain
Agent Role project-scanner Discover files, detect languages and frameworks file-analyzer Extract functions, classes, imports; produce graph nodes and edges architecture-analyzer Identify architectural layers tour-builder Generate guided learning tours graph-reviewer Validate graph completeness and referential integrity (runs inline by default; use --review for full LLM review) domain-analyzer Extract business domains, flows, and process steps (used by /understand-domain) article-analyzer Extract entities, claims, and implicit relationships from wiki articles (used by /understand-knowledge)
project-scanner
file-analyzer
architecture-analyzer
tour-builder
graph-reviewer
--review
domain-analyzer
/understand-domain
article-analyzer
/understand-knowledge
File analyzers run in parallel (up to 5 concurrent, 20-30 files per batch). Supports incremental updates — only re-analyzes files that changed since the last run.
🎥 Community
A community-made walkthrough by Better Stack.
Watch on YouTube →
Made a video, blog post, or tutorial? Open an issue or PR — happy to feature it here.
🤝 Contributing
Contributions are welcome! Here's how to get started:
Fork the repository
Create a feature branch (git checkout -b feature/my-feature)
git checkout -b feature/my-feature
Run the tests (pnpm --filter @understand-anything/core test)
pnpm --filter @understand-anything/core test
Commit your changes and open a pull request
Please open an issue first for major changes so we can discuss the approach.
The goal isn't a graph that wows you with how complex your codebase is — it's a graph that quietly teaches you how every piece fits together.
The goal isn't a graph that wows you with how complex your codebase is — it's a graph that quietly teaches you how every piece fits together.
✨ Features
Note
Want to skip the reading? Try the live demo in our homepage — a fully interactive dashboard you can pan, zoom, search, and explore right in your browser.
Explore the structural graph
Navigate your codebase as an interactive knowledge graph — every file, function, and class is a node you can click, search, and explore. Select any node to see plain-English summaries, relationships, and guided tours.
Understand business logic
Switch to the domain view and see how your code maps to real business processes — domains, flows, and steps laid out as a horizontal graph.
Analyze knowledge bases
Point /understand-knowledge at a Karpathy-pattern LLM wiki and get a force-directed knowledge graph with community clustering. The deterministic parser extracts wikilinks and categories from index.md, then LLM agents discover implicit relationships, extract entities, and surface claims — turning your wiki into a navigable graph of interconnected ideas.
/understand-knowledge
index.md
🧭 Guided Tours Auto-generated walkthroughs of the architecture, ordered by dependency. Learn the codebase in the right order. 🔍 Fuzzy & Semantic Search Find anything by name or by meaning. Search "which parts handle auth?" and get relevant results across the graph. 📊 Diff Impact Analysis See which parts of the system your changes affect before you commit. Understand ripple effects across the codebase. 🎭 Persona-Adaptive UI The dashboard adjusts its detail level based on who you are — junior dev, PM, or power user. 🏗️ Layer Visualization Automatic grouping by architectural layer — API, Service, Data, UI, Utility — with color-coded legend. 📚 Language Concepts 12 programming patterns (generics, closures, decorators, etc.) explained in context wherever they appear.
🧭 Guided Tours
Auto-generated walkthroughs of the architecture, ordered by dependency. Learn the codebase in the right order.
🔍 Fuzzy & Semantic Search
Find anything by name or by meaning. Search "which parts handle auth?" and get relevant results across the graph.
📊 Diff Impact Analysis
See which parts of the system your changes affect before you commit. Understand ripple effects across the codebase.
🎭 Persona-Adaptive UI
The dashboard adjusts its detail level based on who you are — junior dev, PM, or power user.
🏗️ Layer Visualization
Automatic grouping by architectural layer — API, Service, Data, UI, Utility — with color-coded legend.
📚 Language Concepts
12 programming patterns (generics, closures, decorators, etc.) explained in context wherever they appear.
A multi-agent pipeline scans your project, extracts every file, function, class, and dependency, then builds a knowledge graph saved to .understand-anything/knowledge-graph.json.
.understand-anything/knowledge-graph.json
Localized output: Use --language to generate content in your preferred language:
--language
Generate Chinese content (知识图节点描述和 Dashboard UI) /understand --language zh # Supported languages: en (default), zh, zh-TW, ja, ko, ru
On the first run in a project — when you don't pass --language and no language is stored yet — /understand detects the language you're conversing in. If it isn't English, it asks you to confirm (or override) before generating; English conversations are unaffected. Your choice is saved to .understand-anything/config.json and reused on every later run.
--language
/understand
.understand-anything/config.json
The --language parameter affects:
--language
Node summaries and descriptions in the knowledge graph
Dashboard UI labels, buttons, and tooltips
Guided tour explanations
Explore the dashboard
/understand-dashboard
An interactive web dashboard opens with your codebase visualized as a graph — color-coded by architectural layer, searchable, and clickable. Select any node to see its code, relationships, and a plain-English explanation.
Keep learning
Ask anything about the codebase /understand-chat How does the payment flow work? # Analyze impact of your current changes /understand-diff # Deep-dive into a specific file or function /understand-explain src/auth/login.ts # Generate an onboarding guide for new team members /understand-onboard # Extract business domain knowledge (domains, flows, steps) /understand-domain # Analyze a Karpathy-pattern LLM wiki knowledge base /understand-knowledge ~/path/to/wiki # Re-run anytime — incremental by default (only re-analyzes changed files) /understand # Auto-update on every commit via a post-commit hook /understand --auto-update # Scope to a subdirectory (for huge monorepos) /understand src/frontend
🌐 Multi-Platform Installation
Understand-Anything works across multiple AI coding platforms.
Cursor auto-discovers the plugin via .cursor-plugin/plugin.json when this repo is cloned. No manual installation needed — just clone and open in Cursor.
.cursor-plugin/plugin.json
If auto-discovery doesn't pick it up, install it manually: open Cursor Settings → Plugins, paste https://github.com/Egonex-AI/Understand-Anything into the search field, and add it from there.
https://github.com/Egonex-AI/Understand-Anything
VS Code + GitHub Copilot
VS Code with GitHub Copilot (v1.108+) auto-discovers the plugin via .copilot-plugin/plugin.json when this repo is cloned. No manual installation needed — just clone and open in VS Code.
.copilot-plugin/plugin.json
For personal skills (available across all projects), run the install.sh above with the vscode platform.
Keep it fresh: enable /understand --auto-update — a post-commit hook incrementally patches the graph so each commit lands with a matching graph. Or re-run /understand manually before releases.
Tree-sitter (deterministic) — parses source into a concrete syntax tree and extracts structural facts: imports, exports, function/class definitions, call sites, inheritance. Pre-resolved into an importMap during the scan phase and passed to file-analyzers so they don't re-derive imports from source. Same input → same output, every run. Also powers fingerprint-based change detection for incremental updates.
importMap
LLM (semantic) — reads the parsed structure alongside the original source to produce what parsers can't: plain-English summaries, tags, architectural layer assignments, business-domain mapping, guided tours, language concept callouts.
This split is why the graph is reproducible on the structural side (the same code always yields the same edges) while still capturing intent on the semantic side (what a file is for, not just what it imports).
Multi-Agent Pipeline
The /understand command orchestrates 5 specialized agents, and /understand-domain adds a 6th:
/understand
/understand-domain
Agent Role project-scanner Discover files, detect languages and frameworks file-analyzer Extract functions, classes, imports; produce graph nodes and edges architecture-analyzer Identify architectural layers tour-builder Generate guided learning tours graph-reviewer Validate graph completeness and referential integrity (runs inline by default; use --review for full LLM review) domain-analyzer Extract business domains, flows, and process steps (used by /understand-domain) article-analyzer Extract entities, claims, and implicit relationships from wiki articles (used by /understand-knowledge)
project-scanner
file-analyzer
architecture-analyzer
tour-builder
graph-reviewer
--review
domain-analyzer
/understand-domain
article-analyzer
/understand-knowledge
File analyzers run in parallel (up to 5 concurrent, 20-30 files per batch). Supports incremental updates — only re-analyzes files that changed since the last run.
🎥 Community
A community-made walkthrough by Better Stack.
Watch on YouTube →
Made a video, blog post, or tutorial? Open an issue or PR — happy to feature it here.
🤝 Contributing
Contributions are welcome! Here's how to get started:
Fork the repository
Create a feature branch (git checkout -b feature/my-feature)
git checkout -b feature/my-feature
Run the tests (pnpm --filter @understand-anything/core test)
pnpm --filter @understand-anything/core test
Commit your changes and open a pull request
Please open an issue first for major changes so we can discuss the approach.