Back
links

Lum1104/Understand-Anything: Claude Code skills that turn any codebase into an interactive knowledge graph you can explore, search, and ask questions about (Multi-platform e.g., Codex are supported).

Claude Code skills that turn any codebase into an interactive knowledge graph you can explore, search, and ask questions about (Multi-platform e.g., Codex are supported). - Lum1104/Understand-Anything

by Lum1104 github.com 6,939 words
View original

Skip to content

Appearance settings

Search code, repositories, users, issues, pull requests…

Search

Clear

Search syntax tips

Provide feedback

We read every piece of feedback, and take your input very seriously.

Include my email address so I can be contacted

Saved searches

Use saved searches to filter your results more quickly

Name

Query

To see all available qualifiers, see our documentation.

Sign in

Sign up

Appearance settings

You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session. You switched accounts on another tab or window. Reload to refresh your session. Dismiss alert

Lum1104 / Understand-Anything Public

Additional navigation options

Lum1104/Understand-Anything

 

BranchesTagsOpen more actions menu

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

119 Commits
119 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Understand AnythingTurn any codebase into an interactive knowledge graph you can explore, search, and ask questions about.

English | 中文 | 日本語 | Türkçe

Quick Start License: MIT Claude Code Plugin Homepage

Understand Anything — Turn any codebase into an interactive knowledge graph

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### 1. Install the plugin/plugin marketplace add Lum1104/Understand-Anything

/plugin install understand-anything

2. Analyze your codebase/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.

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

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

🌐 Multi-Platform InstallationUnderstand-Anything works across multiple AI coding platforms.

Claude Code (Native)/plugin marketplace add Lum1104/Understand-Anything

/plugin install understand-anything

CodexTell Codex:

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

OpenCodeTell OpenCode:

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

OpenClawTell OpenClaw:

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

CursorCursor auto-discovers the plugin via .cursor-plugin/plugin.json when this repo is cloned. No manual installation needed — just clone and open in Cursor.

AntigravityTell Antigravity:

Fetch and follow instructions from https://raw.githubusercontent.com/Lum1104/Understand-Anything/refs/heads/main/.antigravity/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 | | Antigravity | ✅ Supported | AI-driven install |

✨ FeaturesDashboard Screenshot

### 🗺️ 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 PipelineThe /understand command orchestrates 5 specialized agents:

AgentRole
project-scannerDiscover files, detect languages and frameworks
file-analyzerExtract functions, classes, imports; produce graph nodes and edges
architecture-analyzerIdentify architectural layers
tour-builderGenerate guided learning tours
graph-reviewerValidate 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```

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


### Tech StackTypeScript, pnpm workspaces, React 18, Vite, TailwindCSS v4, React Flow, Zustand, web-tree-sitter, Fuse.js, Zod, Dagre

### Development Commands| 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 |

---

## 🤝 ContributingContributions 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.**

## Star History  [![Star History Chart](https://camo.githubusercontent.com/625d4a6f49563ca3ebf8f1921c330a9fefd3879c9839254b6aeac825a2a11ec9/68747470733a2f2f6170692e737461722d686973746f72792e636f6d2f696d6167653f7265706f733d4c756d313130342f556e6465727374616e642d416e797468696e6726747970653d64617465266c6567656e643d746f702d6c656674)](https://www.star-history.com/?repos=Lum1104%2FUnderstand-Anything&type=date&legend=top-left)

MIT License © [Lum1104](https://github.com/Lum1104)

## About

Claude Code skills that turn any codebase into an interactive knowledge graph you can explore, search, and ask questions about (Multi-platform e.g., Codex are supported).

[lum.is-a.dev/Understand-Anything/](https://lum.is-a.dev/Understand-Anything/ "https://lum.is-a.dev/Understand-Anything/")

### Topics

[knowledge-graph](https://github.com/topics/knowledge-graph "Topic: knowledge-graph") [codex](https://github.com/topics/codex "Topic: codex") [claude-code](https://github.com/topics/claude-code "Topic: claude-code") [claude-skills](https://github.com/topics/claude-skills "Topic: claude-skills") [codex-skills](https://github.com/topics/codex-skills "Topic: codex-skills") [opencode-skills](https://github.com/topics/opencode-skills "Topic: opencode-skills") [understandcode](https://github.com/topics/understandcode "Topic: understandcode")

### Resources

[Readme](https://github.com/Lum1104/Understand-Anything#readme-ov-file)

### License

[MIT license](https://github.com/Lum1104/Understand-Anything#MIT-1-ov-file)

### Contributing

[Contributing](https://github.com/Lum1104/Understand-Anything#contributing-ov-file)

### Uh oh!

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

[Activity](https://github.com/Lum1104/Understand-Anything/activity)

### Stars

[**5.7k** stars](https://github.com/Lum1104/Understand-Anything/stargazers)

### Watchers

[**27** watching](https://github.com/Lum1104/Understand-Anything/watchers)

### Forks

[**438** forks](https://github.com/Lum1104/Understand-Anything/forks)

[Report repository](https://github.com/contact/report-content?content_url=https%3A%2F%2Fgithub.com%2FLum1104%2FUnderstand-Anything&report=Lum1104+%28user%29)

## [Releases](https://github.com/Lum1104/Understand-Anything/releases)

No releases published

## [Packages 0](https://github.com/users/Lum1104/packages?repo_name=Understand-Anything)

### Uh oh!

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

## [Contributors](https://github.com/Lum1104/Understand-Anything/graphs/contributors)

### Uh oh!

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

## Languages

- [TypeScript 92.2%](https://github.com/Lum1104/Understand-Anything/search?l=typescript)
- [Astro 5.2%](https://github.com/Lum1104/Understand-Anything/search?l=astro)
- [CSS 2.3%](https://github.com/Lum1104/Understand-Anything/search?l=css)
- Other 0.3%

## Footer© 2026 GitHub, Inc.

### Footer navigation

- [Terms](https://docs.github.com/site-policy/github-terms/github-terms-of-service)
- [Privacy](https://docs.github.com/site-policy/privacy-policies/github-privacy-statement)
- [Security](https://github.com/security)
- [Status](https://www.githubstatus.com/)
- [Community](https://github.community/)
- [Docs](https://docs.github.com/)
- [Contact](https://support.github.com/?tags=dotcom-footer)
- 
-

You can’t perform that action at this time.