GitHub - Lum1104/Understand-Anything: Graphs that teach > graphs that impress. Turn any code, or knowledge base (Karpathy LLM wiki), into an interactive knowledge graph you can explore, search, and ask questions about. Works with Claude Code, Codex, Cursor, Copilot, Gemini CLI, and more.

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.

English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Español | Türkçe

TipA 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.

Graphs that teach > graphs that impress.

✨ Features NoteWant 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.

# 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

🌐 Multi-Platform Installation Understand-Anything works across multiple AI coding platforms. Claude Code (Native) /plugin marketplace add Lum1104/Understand-Anything /plugin install understand-anything Codex Tell Codex: Fetch and follow instructions from https://raw.githubusercontent.com/Lum1104/Understand-Anything/refs/heads/main/.codex/INSTALL.md

OpenCode Tell OpenCode: Fetch and follow instructions from https://raw.githubusercontent.com/Lum1104/Understand-Anything/refs/heads/main/.opencode/INSTALL.md

OpenClaw Tell OpenClaw: Fetch and follow instructions from https://raw.githubusercontent.com/Lum1104/Understand-Anything/refs/heads/main/.openclaw/INSTALL.md

Cursor 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. 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. For personal skills (available across all projects), tell GitHub Copilot: Fetch and follow instructions from https://raw.githubusercontent.com/Lum1104/Understand-Anything/refs/heads/main/.vscode/INSTALL.md

Copilot CLI copilot plugin install Lum1104/Understand-Anything:understand-anything-plugin Antigravity Tell Antigravity: Fetch and follow

instructions from https://raw.githubusercontent.com/Lum1104/Understand-Anything/refs/heads/main/.antigravity/INSTALL.md

Gemini CLI Tell Gemini CLI: Fetch and follow instructions from https://raw.githubusercontent.com/Lum1104/Understand-Anything/refs/heads/main/.gemini/INSTALL.md

Pi Agent Tell Pi Agent: Fetch and follow instructions from https://raw.githubusercontent.com/Lum1104/Understand-Anything/refs/heads/main/.pi/INSTALL.md

Platform Compatibility

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

VS Code + GitHub Copilot ✅ Supported Auto-discovery

Copilot CLI ✅ Supported Plugin install

Antigravity ✅ Supported AI-driven install

Gemini CLI ✅ Supported AI-driven install

Pi Agent ✅ Supported AI-driven install

📦 Share the Graph with Your Team The graph is just JSON — commit it once, and teammates skip the pipeline. Good for onboarding, PR reviews, and docs-as-code.

Example: GoogleCloudPlatform/microservices-demo (fork) — Go / Java / Python / Node reference with a committed graph.

What to commit: everything in .understand-anything/ except intermediate/ and diff-overlay.json (those are local scratch). .understand-anything/intermediate/ .understand-anything/diff-overlay.json 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. Large graphs (10 MB+): track with git-lfs.

git lfs install git lfs track ".understand-anything/*.json" git add .gitattributes .understand-anything/

🔧 Under the Hood Multi-Agent Pipeline The /understand command orchestrates 5 specialized agents, and /understand-domain adds a 6th:

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)

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.

🤝 Contributing 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.

Star History

MIT License © Lum1104