Understand Anything

• Uh oh!

  There was an error while loading. Please reload this page.

• Notifications You must be signed in to change notification settings
• Fork 856
• Star 10.2k

• Code
• Issues 5
• Pull requests 0
• Discussions
• Actions
• Projects
• Security and quality 0
• Insights

Additional navigation options  mainBranchesTagsGo to fileCodeOpen more actions menu

Folders and files

Name	Name	Last commit message	Last commit date
Latest commit History 404 Commits404 Commits
.antigravity	.antigravity
.claude-plugin	.claude-plugin
.codex	.codex
.copilot-plugin	.copilot-plugin
.cursor-plugin	.cursor-plugin
.gemini	.gemini
.github	.github
.openclaw	.openclaw
.opencode	.opencode
.pi	.pi
.vscode	.vscode
assets	assets
docs/superpowers	docs/superpowers
homepage	homepage
scripts	scripts
understand-anything-plugin	understand-anything-plugin
.gitignore	.gitignore
.npmrc	.npmrc
CLAUDE.md	CLAUDE.md
CONTRIBUTING.md	CONTRIBUTING.md
LICENSE	LICENSE
README.es-ES.md	README.es-ES.md
README.ja-JP.md	README.ja-JP.md
README.ko-KR.md	README.ko-KR.md
README.md	README.md
README.tr-TR.md	README.tr-TR.md
README.zh-CN.md	README.zh-CN.md
README.zh-TW.md	README.zh-TW.md
package.json	package.json
pnpm-lock.yaml	pnpm-lock.yaml
pnpm-workspace.yaml	pnpm-workspace.yaml
tsconfig.json	tsconfig.json
View all files

Repository files navigation

• README
• Contributing
• MIT license

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

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.

Graphs that teach > graphs that impress.

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.

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.

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.

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.

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.

/plugin marketplace add Lum1104/Understand-Anything
/plugin install understand-anything

/understand

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

# 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

Understand-Anything works across multiple AI coding platforms.

/plugin marketplace add Lum1104/Understand-Anything
/plugin install understand-anything

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

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 plugin install Lum1104/Understand-Anything:understand-anything-plugin

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

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/

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.

Contributions are welcome! Here's how to get started:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/my-feature)
3. Run the tests (pnpm --filter @understand-anything/core test)
4. 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

About

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.

understand-anything.com

Topics

memory knowledge-graph knowledge-base codex business-knowledge claude-code claude-skills codex-skills pi-agent gemini-cli-skills opencode-skills antigravity-skills understandcode karpathy-llm-wiki

Resources

Readme

License

MIT license

Contributing

Contributing

Uh oh!

There was an error while loading. Please reload this page.

Activity

Stars

10.2k stars

Watchers

41 watching

Forks

856 forks Report repository

Releases 5

v2.3.1 Latest Apr 12, 2026 + 4 releases

Sponsor this project

Uh oh!

There was an error while loading. Please reload this page.

• patreon.com/Lum1104

Packages 0

     

Uh oh!

There was an error while loading. Please reload this page.

Contributors

Uh oh!

There was an error while loading. Please reload this page.

Languages

• TypeScript 87.6%
• Python 7.0%
• Astro 2.9%
• JavaScript 1.6%
• Other 0.9%