Lum1104 / Understand-Anything

Understand Anything Turn any codebase into an interactive knowledge graph you can explore, search, and ask questions about. English | 中文 | 日本語 --- > [!TIP] > **A huge thank you to the community!** The support for Understand-Anything has been incredible. If this tool saves you a few minutes of digging through complexity, that's all I wanted. 🚀 **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. --- 🤔 Why? Reading code is hard. Understanding a whole codebase is harder. Documentation is always out of date, onboarding takes weeks, and every new feature feels like archaeology. Understand Anything fixes this by combining **LLM intelligence** with **static analysis** to produce a living, explorable map of your project — with plain-English explanations for everything. --- 🎯 Who is this for? 👩‍💻 Junior Developers Stop drowning in unfamiliar code. Get guided tours that walk you through the architecture step by step, with every function and class explained in plain English. 📋 Product Managers & Designers Finally understand how the system actually works without reading code. Ask questions like "how does authentication work?" and get clear answers grounded in the real codebase. 🤖 AI-Assisted Developers Give your AI tools deep context about your project. Use /understand-diff before code review, /understand-explain to dive into any module, or /understand-chat to reason about architecture. --- 🚀 Quick Start • Install the plugin • Analyze your codebase A multi-agent pipeline scans your project, extracts every file, function, class, and dependency, then builds a knowledge graph saved to . • Explore the 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 --- 🌐 Multi-Platform Installation Understand-Anything works across multiple AI coding platforms. Claude Code (Native) Codex Tell Codex: OpenCode Add to your : OpenClaw Tell OpenClaw: Cursor Cursor auto-discovers the plugin via when this repo is cloned. No manual installation needed — just clone and open in Cursor. Antigravity Tell Antigravity: Platform Compatibility | Platform | Status | Install Method | |----------|--------|----------------| | Claude Code | ✅ Native | Plugin marketplace | | Codex | ✅ Supported | AI-driven install | | OpenCode | ✅ Supported | Plugin config | | OpenClaw | ✅ Supported | AI-driven install | | Cursor | ✅ Supported | Auto-discovery | | Antigravity | ✅ Supported | AI-driven install | --- ✨ Features 🗺️ Interactive Knowledge Graph Files, functions, classes, and their relationships visualized with React Flow. Click any node to see its code and connections. 💬 Plain-English Summaries Every node described by an LLM so anyone — technical or not — can understand what it does and why it exists. 🧭 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. --- 🔧 Under the Hood Multi-Agent Pipeline The command orchestrates 5 specialized agents: | Agent | Role | |-------|------| | | Discover files, detect languages and frameworks | | | Extract functions, classes, imports; produce graph nodes and edges | | | Identify architectural layers | | | Generate guided learning tours | | | Validate graph completeness and referential integrity | File analyzers run in parallel (up to 3 concurrent). Supports incremental updates — only re-analyzes files that changed since the last run. Project Structure Tech Stack TypeScript, pnpm workspaces, React 18, Vite, TailwindCSS v4, React Flow, Zustand, web-tree-sitter, Fuse.js, Zod, Dagre Development Commands | Command | Description | |---------|-------------| | | Install all dependencies | | | Build the core package | | | Run core tests | | | Build the plugin package | | | Run plugin tests | | | Build the dashboard | | | Start dashboard dev server | --- 🤝 Contributing Contributions are welcome! Here's how to get started: • Fork the repository • Create a feature branch ( ) • Run the tests ( ) • Commit your changes and open a pull request Please open an issue first for major changes so we can discuss the approach. --- Stop reading code blind. Start understanding everything. Star History MIT License © Lum1104