¿Prefieres verlo? Armé una página con capturas del dashboard y qué hace cada comando para entender de qué se trata en dos minutos.
Para qué sirve cada comando
Understand Anything no es un solo comando, es un set. Una vez instalado el plugin, estos son los que más vas a usar:
| Comando | Qué hace |
|---|---|
/understand |
Corre el pipeline completo y construye el grafo de conocimiento. Incremental por defecto. |
/understand-dashboard |
Abre el dashboard web interactivo con el grafo navegable. |
/understand-chat |
Pregúntale al código en lenguaje natural ("¿cómo funciona el flujo de pago?"). |
/understand-diff |
Análisis de impacto: qué partes del sistema tocan tus cambios actuales. |
/understand-explain |
Deep-dive en un archivo o función específica. |
/understand-onboard |
Genera una guía de onboarding para gente nueva del equipo. |
/understand-domain |
Extrae el conocimiento de dominio de negocio (dominios, flujos, pasos). |
/understand-knowledge |
Analiza una wiki estilo Karpathy y la vuelve un grafo de ideas conectadas. |
Por qué tree-sitter + LLM y no solo LLM
La decisión técnica interesante es que no le entregan todo el código crudo al modelo. Primero un parser determinista (tree-sitter) saca los hechos estructurales —imports, exports, definiciones, llamadas, herencia— y los pre-resuelve en un importMap. Eso significa que la parte estructural del grafo es reproducible: el mismo código siempre genera las mismas aristas, corrida tras corrida. También es lo que permite la detección de cambios por fingerprint para las actualizaciones incrementales.
El LLM entra después, leyendo la estructura ya parseada junto al código original, y produce lo que un parser no puede: resúmenes en lenguaje plano, asignación de capa arquitectónica, mapeo a dominios de negocio, tours guiados. Esta división es la razón de que el grafo sea confiable en lo estructural y a la vez capture la intención —para qué sirve un archivo, no solo qué importa.
El grafo se comparte
Un detalle operativo que vale oro para equipos: el grafo es solo JSON. Lo commiteas una vez al repo y tus compañeros se saltan el pipeline completo —abren el mapa ya construido. Sirve para onboarding, revisión de PRs y docs-as-code.
.understand-anything/intermediate/
.understand-anything/diff-overlay.json
Commiteas todo .understand-anything/ excepto el scratch local de arriba. Para mantenerlo fresco, /understand --auto-update instala un hook post-commit que parcha el grafo incrementalmente en cada commit. Grafos grandes (10 MB+) se trackean con git-lfs.
Limitaciones honestas
- No baja tu factura de tokens. Al revés: gastas tokens una vez para que un humano entienda el sistema. Si lo que buscas es que el agente consuma menos contexto, esa es otra herramienta (codegraph).
- En repos chicos y conocidos, el setup no se justifica. El valor escala con el tamaño del código y con cuánta gente nueva pasa por él.
- El primer análisis de un monorepo grande toma su tiempo; después es incremental (hasta 5 archivos en paralelo, lotes de 20-30).
- Es un proyecto joven y de adopción explosiva (47k stars, creado en marzo 2026). Activo y mantenido, pero todavía no es código batalla-probado de años.
Mi recomendación
Si tu equipo sufre cada vez que alguien nuevo entra al código, o si tú mismo estás por meterte a un repo heredado que nadie documentó, instalarlo esta tarde te ahorra las semanas de leer a ciegas. Corre /understand, commitea el JSON, y el próximo que llegue arranca con el mapa ya hecho. El downside es bajo —es local y open source MIT— y el upside es convertir conocimiento que vive en la cabeza de una persona en algo que cualquiera puede navegar.