understand-anything-knowledge-graph
understand-anything-knowledge-graph — an installable skill for AI agents.
By reason-machines · 2,420 installs
npx skills add reason-machines/trending-skills --skill understand-anything-knowledge-graph
Source repository · Upstream listing
Understand Anything — Codebase Knowledge Graph
Skill by [ara.so](https://ara.so) — Daily 2026 Skills collection.
Understand Anything is a [Claude Code](https://docs.anthropic.com/en/docs/claude code) plugin that runs a multi agent pipeline over your project, builds a knowledge graph of every file, function, class, and dependency, and opens an interactive React dashboard for visual exploration. It produces plain English summaries of every node so anyone — developer, PM, or designer — can understand the codebase.
Installation
Via Claude Code plugin marketplace
From source (development)
Core Skills / Commands
Command What it does
/understand Run the full multi agent analysis pipeline on the current project
/understand dashboard Open the interactive knowledge graph dashboard
/understand chat <question Ask anything about the codebase in natural language
/understand diff Analyze impact of current uncommitted changes
/understand explain <path Deep dive explanation of a specific file or function
/understand onboard Generate an onboarding guide for new team members
Typical Workflow
1. Analyze a project
This orchestrates 5 agents in sequence (with file analyzers running up to 3 concurrent):
1. project scanner — discovers files, detects languages/frameworks
2. file analyzer — extracts functions, classes, imports; builds graph nodes and edges
3. architecture analyzer — groups nodes into architectural layers (API, Service, Data, UI, Utility)
4. tour builder — generates ordered learning tours
5. graph reviewer — validates referential integrity
Output is saved to .understand anything/knowledge graph.json in your project root.
2. Open the dashboard
The React + Vite dashboard opens in your browser. Features:
Graph view — React Flow canvas, color coded by layer, zoom/pan
Node inspector — click any node for code, relationships, LLM summary
Search — fuzzy + semantic search across all nodes
Tours — guided walkthroughs ordered by dependency
Persona mode — toggle detail level (Junior Dev / PM / Power User)
3. Ask questions
4. Review diff impact before committing
Returns a list of affected nodes in the knowledge graph — shows ripple effects before you push.
5. Explain a specific file
Knowledge Graph Schema
The graph is stored at .understand anything/knowledge graph.json . Key types (from packages/core ):
Working with the Core Package Programmatically
Dashboard Development
The dashboard is a Vite + React 18 app using:
React Flow — graph canvas rendering
Zustand — graph state management
TailwindCSS v4 — styling
Fuse.js — fuzzy search
web tree sitter — in browser AST parsing
Dagre — automatic graph layout
Project Structure
Incremental Updates
Re running /understand only re analyzes files that changed since the last run (based on mtime and content hash stored in the graph metadata). For large monorepos this makes subsequent runs fast.
To force a full re analysis:
Development Commands
Common Patterns
Before a code review
Onboarding a new engineer
Researching a feature area
Understanding an unfamiliar module
Troubleshooting
/understand times out on large repos
The file analyzer runs up to 3 workers concurrently. Very large repos ( 50k files) may need patience. Delete .understand anything/ and re run if a previous run was interrupted.
Dashboard doesn't open
Run pnpm filter @understand anything/dashboard build first if working from source, then retry /understand dashboard .
Stale graph after major refactor
Delete .understand anything/knowledge graph.json to force full re analysis: rm .understand anything/knowledge graph.json && /understand
pnpm install fails with workspace errors
Ensure you are using pnpm v8+: pnpm version . The project uses pnpm workspaces defined in pnpm workspace.yaml .
Search returns no results
Confirm the graph was generated: cat .understand anything/knowledge graph.json head 5 . If empty or missing, run /understand first.
Contributing
License: MIT © [Lum1104](https://github.com/Lum1104)