Lum1104 / Understand-Anything

Understand Anything turns any codebase, knowledge base, or documentation into an interactive knowledge graph that you can explore, search, and query. It is compatible with Claude Code, Codex, Cursor, Copilot, Gemini CLI, and more.

Understand Anything 可以将任何代码库、知识库或文档转化为交互式知识图谱，供你进行探索、搜索和提问。它兼容 Claude Code、Codex、Cursor、Copilot、Gemini CLI 等多种工具。

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. The goal isn’t a graph that wows you with how complex your codebase is — it’s a graph that quietly teaches you how every piece fits together.

你刚加入一个新团队，面对的是 20 万行代码的代码库。你该从哪里入手？Understand Anything 是一个 Claude Code 插件，它通过多智能体流水线分析你的项目，构建包含每个文件、函数、类和依赖关系的知识图谱，并提供一个交互式仪表盘，让你能直观地进行探索。别再盲目地阅读代码了，开始从全局视角审视项目吧。它的目标不是通过展示代码库的复杂性来让你惊叹，而是通过图谱默默地教会你各个部分是如何协同工作的。

✨ Features | 功能特性

Note: Want to skip the reading? Try the live demo on 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.

分析知识库： 将 /understand-knowledge 指向一个 Karpathy 模式的 LLM 维基，即可获得带有社区聚类的力导向知识图谱。确定性解析器会从 index.md 中提取维基链接和分类，随后 LLM 智能体会发现隐含关系、提取实体并呈现观点，将你的维基转化为一个可导航的互联思想图谱。

🧭 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 | 角色自适应 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.

按架构层级（API、服务、数据、UI、工具）自动分组，并配有颜色编码图例。

📚 Language Concepts | 语言概念

12 programming patterns (generics, closures, decorators, etc.) explained in context wherever they appear.

在代码中出现的位置，提供 12 种编程模式（泛型、闭包、装饰器等）的上下文解释。

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

多智能体流水线会扫描你的项目，提取每个文件、函数、类和依赖关系，然后构建一个保存至 .understand-anything/knowledge-graph.json 的知识图谱。

Localized output | 本地化输出: Use --language to generate content in your preferred language: 使用 --language 生成你偏好语言的内容：

# Generate Chinese content (知识图节点描述和 Dashboard UI)
/understand --language zh
# Supported languages: en (default), zh, zh-TW, ja, ko, ru

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.

打开一个交互式 Web 仪表盘，你的代码库将以图谱形式可视化——按架构层级进行颜色编码，支持搜索和点击。选择任意节点即可查看其代码、关联关系和通俗易懂的解释。

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

# 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. Understand-Anything 适用于多个 AI 编程平台。

Claude Code (Native)

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

One-line install (Codex / OpenCode / OpenClaw / Antigravity / Gemini CLI / Pi Agent / Vibe CLI / VS Code Copilot / Hermes / Cline / KIMI CLI)

# macOS / Linux:
curl -fsSL https://raw.githubusercontent.com/Lum1104/Understand-Anything/main/install.sh | bash

# Windows (PowerShell):
iwr -useb https://raw.githubusercontent.com/Lum1104/Understand-Anything/main/install.ps1 | iex

The installer clones the repo to ~/.understand-anything/repo and creates the right symlinks for the chosen platform. Restart your CLI/IDE afterwards. 安装程序会将仓库克隆到 ~/.understand-anything/repo 并为所选平台创建正确的符号链接。安装后请重启你的 CLI 或 IDE。

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. 当克隆此仓库时，Cursor 会通过 .cursor-plugin/plugin.json 自动发现插件。无需手动安装——只需克隆并在 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. 当克隆此仓库时，安装了 GitHub Copilot (v1.108+) 的 VS Code 会通过 .copilot-plugin/plugin.json 自动发现插件。无需手动安装。