Turn any codebase into an interactive knowledge graph you can explore, search, and ask questions about.
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.
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.
|
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. |
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. |
Give your AI tools deep context about your project. Use |
/plugin marketplace add Lum1104/Understand-Anything
/plugin install understand-anything/understandA 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-dashboardAn 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.
# 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-onboardUnderstand-Anything works across multiple AI coding platforms.
/plugin marketplace add Lum1104/Understand-Anything
/plugin install understand-anythingTell Codex:
Fetch and follow instructions from https://raw.githubusercontent.com/Lum1104/Understand-Anything/refs/heads/main/.codex/INSTALL.md
Tell OpenCode:
Fetch and follow instructions from https://raw.githubusercontent.com/Lum1104/Understand-Anything/refs/heads/main/.opencode/INSTALL.md
Tell OpenClaw:
Fetch and follow instructions from https://raw.githubusercontent.com/Lum1104/Understand-Anything/refs/heads/main/.openclaw/INSTALL.md
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.
Tell Antigravity:
Fetch and follow instructions from https://raw.githubusercontent.com/Lum1104/Understand-Anything/refs/heads/main/.antigravity/INSTALL.md
Tell Gemini CLI:
Fetch and follow instructions from https://raw.githubusercontent.com/Lum1104/Understand-Anything/refs/heads/main/.gemini/INSTALL.md
Tell Pi Agent:
Fetch and follow instructions from https://raw.githubusercontent.com/Lum1104/Understand-Anything/refs/heads/main/.pi/INSTALL.md
| Platform | Status | Install Method |
|---|---|---|
| Claude Code | ✅ Native | Plugin marketplace |
| Codex | ✅ Supported | AI-driven install |
| OpenCode | ✅ Supported | AI-driven install |
| OpenClaw | ✅ Supported | AI-driven install |
| Cursor | ✅ Supported | Auto-discovery |
| Antigravity | ✅ Supported | AI-driven install |
| Gemini CLI | ✅ Supported | AI-driven install |
| Pi Agent | ✅ Supported | AI-driven install |
|
Files, functions, classes, and their relationships visualized with React Flow. Click any node to see its code and connections. |
Every node described by an LLM so anyone — technical or not — can understand what it does and why it exists. |
|
Auto-generated walkthroughs of the architecture, ordered by dependency. Learn the codebase in the right order. |
Find anything by name or by meaning. Search "which parts handle auth?" and get relevant results across the graph. |
|
See which parts of the system your changes affect before you commit. Understand ripple effects across the codebase. |
The dashboard adjusts its detail level based on who you are — junior dev, PM, or power user. |
|
Automatic grouping by architectural layer — API, Service, Data, UI, Utility — with color-coded legend. |
12 programming patterns (generics, closures, decorators, etc.) explained in context wherever they appear. |
The /understand command orchestrates 5 specialized agents:
| 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 |
File analyzers run in parallel (up to 3 concurrent). Supports incremental updates — only re-analyzes files that changed since the last run.
understand-anything-plugin/
.claude-plugin/ — Plugin manifest
agents/ — Specialized AI agents
skills/ — Skill definitions (/understand, /understand-chat, etc.)
src/ — TypeScript source (context-builder, diff-analyzer, etc.)
packages/
core/ — Analysis engine (types, persistence, tree-sitter, search, schema, tours)
dashboard/ — React + TypeScript web dashboard
TypeScript, pnpm workspaces, React 18, Vite, TailwindCSS v4, React Flow, Zustand, web-tree-sitter, Fuse.js, Zod, Dagre
| Command | Description |
|---|---|
pnpm install |
Install all dependencies |
pnpm --filter @understand-anything/core build |
Build the core package |
pnpm --filter @understand-anything/core test |
Run core tests |
pnpm --filter @understand-anything/skill build |
Build the plugin package |
pnpm --filter @understand-anything/skill test |
Run plugin tests |
pnpm --filter @understand-anything/dashboard build |
Build the dashboard |
pnpm dev:dashboard |
Start dashboard dev server |
Contributions are welcome! Here's how to get started:
- Fork the repository
- Create a feature branch (
git checkout -b feature/my-feature) - Run the tests (
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.
Stop reading code blind. Start understanding everything.
MIT License © Lum1104

