understand-anything

name	understand-anything
description	Turn any codebase into an interactive knowledge graph that you can explore, search, and ask questions about. Use when arriving on an unfamiliar repo, before touching architectural code, to map dependencies, or to answer "where does X live and what calls it". Compatible with Claude Code, Codex, Cursor.
license	MIT
metadata	{"author":"Lum1104","source":"https://github.com/Lum1104/Understand-Anything","source-version":"2026-05-15","maintainer":"izo","argument-hint":"[--scope <path>] [--depth N]"}

Understand-Anything

Builds an interactive knowledge graph of a codebase — nodes (files, classes, functions), edges (imports, calls, inheritance, type references). The graph is local and persistent, and a query interface returns the minimal relevant subgraph for any question.

Invocation

/understand-anything — index the whole repo (first run, 30s–5min depending on size). /understand-anything --scope src/ — restrict to a path. /understand-anything --query "what calls UserService?" — query the graph.

What you get

• Module dependency map (which files depend on which)
• Type and symbol cross-references
• Hot paths (most-called functions, most-imported modules)
• Cold corners (unused exports, files never imported)
• Layer detection (UI / domain / infra / glue)

Coexistence with ulk

ulk already ships code-review-graph (--with-code-graph, ADOPT-CONDITIONAL) — a similar capability focused on code review (read only the files that matter, save 6.8× tokens on average, 49× in monorepo).

Routing rule:

• Onboarding / exploration (you don't know the repo yet) → /understand-anything is more pedagogic and interactive.
• Code review (PR diff, you know the repo) → code-review-graph is leaner and faster.
• Compatible with non-Claude clients (Codex, Cursor) → /understand-anything works there too.

ulk agents that benefit:

• strange (16) — reverse documentation (loads the graph to seed docs/rewrite/).
• godspeed (00) — phase 1.5 vault surface (can use the graph as a backup signal source).
• blackemperor (18) — multi-mode agent that picks a strategy based on repo shape.

Installation

Bundled in framework/community-skills/understand-anything/. Upstream provides the indexer + query API:

# Upstream restructuré en plugin multi-skills — point d'entrée principal :
curl.md https://raw.githubusercontent.com/Lum1104/Understand-Anything/main/understand-anything-plugin/skills/understand/SKILL.md
# Autres skills upstream : understand-diff, understand-explain, understand-chat, understand-onboard, understand-dashboard
# Index a repo:
# (per upstream instructions — typically a one-time `understand-anything index .`)

Caveats

• First indexing pass can be heavy on large monorepos (> 100k LOC) — let it run in background.
• Graph file is local (gitignore it).
• Re-index after major refactors — the graph is a snapshot.