Understand Anything

Convierte cualquier código fuente, base de conocimiento o documentación en un grafo de conocimiento interactivo que puedes explorar, buscar y consultar.
Compatible con Claude Code, Codex, Cursor, Copilot, Gemini CLI y más.

Understand Anything — Convierte cualquier código fuente en un grafo de conocimiento interactivo

An open-source project from Egonex
Originally created by Lum1104.

--- **Acabas de unirte a un nuevo equipo. El código tiene 200,000 líneas. ¿Por dónde empiezas?** Understand Anything es un [Claude Code Plugin](https://code.claude.com/docs/en/plugins-reference#plugins-reference) que analiza tu proyecto con un pipeline multi-agente, construye un grafo de conocimiento de cada archivo, función, clase y dependencia, y luego te ofrece un panel interactivo para explorarlo visualmente. Deja de leer código a ciegas. Empieza a ver el panorama completo. > **El objetivo no es un grafo que te impresione mostrándote lo complejo que es tu código — es un grafo que, sin alardes, te enseña cómo encaja cada pieza.** --- ## ✨ Características > [!NOTE] > **¿Quieres probarlo directamente?** Prueba la [demo en vivo](https://understand-anything.com/demo/) en nuestra [página principal](https://understand-anything.com/) — un panel interactivo donde puedes navegar, hacer zoom, buscar y explorar directamente en tu navegador. ### Explora el grafo estructural Navega tu código como un grafo de conocimiento interactivo: cada archivo, función y clase es un nodo que puedes hacer clic, buscar y explorar. Selecciona cualquier nodo para ver resúmenes en lenguaje natural, relaciones y recorridos guiados. ### Comprende la lógica de negocio Cambia a la vista de dominio y observa cómo tu código se mapea a procesos de negocio reales: dominios, flujos y pasos representados como un grafo horizontal. ### Analiza bases de conocimiento Apunta `/understand-knowledge` a un [wiki LLM con patrón Karpathy](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f) y obtén un grafo de conocimiento dirigido por fuerzas con agrupación por comunidad. El parser determinístico extrae wikilinks y categorías de `index.md`, luego los agentes LLM descubren relaciones implícitas, extraen entidades y revelan afirmaciones, convirtiendo tu wiki en un grafo navegable de ideas interconectadas.

🧭 Recorridos Guiados

Recorridos generados automáticamente de la arquitectura, ordenados por dependencia. Aprende el código en el orden correcto.

🔍 Búsqueda Difusa y Semántica

Encuentra cualquier cosa por nombre o por significado. Busca "¿qué partes manejan la autenticación?" y obtén resultados relevantes en todo el grafo.

📊 Análisis de Impacto de Cambios

Visualiza qué partes del sistema afectan tus cambios antes de hacer commit. Comprende los efectos en cascada a través del código.

🎭 Interfaz Adaptativa por Persona

El panel ajusta su nivel de detalle según quién eres: desarrollador junior, PM o usuario avanzado.

🏗️ Visualización por Capas

Agrupación automática por capa arquitectónica — API, Servicio, Datos, UI, Utilidades — con leyenda codificada por colores.

📚 Conceptos del Lenguaje

12 patrones de programación (genéricos, closures, decoradores, etc.) explicados en contexto donde aparecen.

--- ## 🚀 Inicio Rápido ### 1. Instala el plugin ```bash /plugin marketplace add Egonex-AI/Understand-Anything /plugin install understand-anything ``` ### 2. Analiza tu código ```bash /understand ``` Un pipeline multi-agente escanea tu proyecto, extrae cada archivo, función, clase y dependencia, y construye un grafo de conocimiento guardado en `.understand-anything/knowledge-graph.json`. **Salida localizada:** Usa `--language` para generar contenido en tu idioma preferido: ```bash # Genera contenido en el idioma preferido (descripciones de nodos y UI del dashboard) /understand --language en # Idiomas soportados: en (default), zh, zh-TW, ja, ko, ru ``` El parámetro `--language` afecta: - Resúmenes y descripciones de nodos en el grafo de conocimiento - Etiquetas, botones y tooltips de la UI del dashboard - Explicaciones de los tours guiados ### 3. Explora el panel ```bash /understand-dashboard ``` Se abre un panel web interactivo con tu código visualizado como un grafo, codificado por colores según la capa arquitectónica, con funciones de búsqueda y clic. Selecciona cualquier nodo para ver su código, relaciones y una explicación en lenguaje natural. ### 4. Sigue aprendiendo ```bash # Pregunta cualquier cosa sobre el código /understand-chat How does the payment flow work? # Analiza el impacto de tus cambios actuales /understand-diff # Profundiza en un archivo o función específica /understand-explain src/auth/login.ts # Genera una guía de incorporación para nuevos miembros del equipo /understand-onboard # Extrae conocimiento de dominio de negocio (dominios, flujos, pasos) /understand-domain # Analiza un wiki LLM con patrón Karpathy /understand-knowledge ~/path/to/wiki # Vuelve a ejecutarlo cuando quieras — incremental por defecto (solo archivos modificados) /understand # Instala un hook post-commit para actualizaciones incrementales automáticas /understand --auto-update # Acota el análisis a un subdirectorio (útil para monorepos enormes) /understand src/frontend ``` --- ## 🌐 Instalación Multiplataforma Understand-Anything funciona en múltiples plataformas de codificación con IA. ### Claude Code (Nativo) ```bash /plugin marketplace add Egonex-AI/Understand-Anything /plugin install understand-anything ``` ### Instalación de una línea (Codex / OpenCode / OpenClaw / Antigravity / Gemini CLI / Pi Agent / Vibe CLI / VS Code Copilot / Hermes / Cline / KIMI CLI / Nanobot) **macOS / Linux:** ```bash curl -fsSL https://raw.githubusercontent.com/Egonex-AI/Understand-Anything/main/install.sh | bash # o pasa la plataforma directamente para saltar el prompt: curl -fsSL https://raw.githubusercontent.com/Egonex-AI/Understand-Anything/main/install.sh | bash -s codex ``` **Windows (PowerShell):** ```powershell iwr -useb https://raw.githubusercontent.com/Egonex-AI/Understand-Anything/main/install.ps1 | iex ``` El instalador clona el repositorio en `~/.understand-anything/repo` y crea los enlaces simbólicos correspondientes para la plataforma elegida. Reinicia tu CLI/IDE al terminar. - Valores soportados de ``: `gemini`, `codex`, `opencode`, `pi`, `openclaw`, `antigravity`, `vibe`, `vscode`, `hermes`, `cline`, `kimi`, `nanobot` - Actualizar más adelante: `./install.sh --update` - Desinstalar: `./install.sh --uninstall ` ### Cursor Cursor detecta automáticamente el plugin a través de `.cursor-plugin/plugin.json` cuando se clona este repositorio. No requiere instalación manual: simplemente clona y abre en Cursor. Si la detección automática no lo reconoce, instálalo manualmente: abre **Cursor Settings → Plugins**, pega `https://github.com/Egonex-AI/Understand-Anything` en el campo de búsqueda y añádelo desde allí. ### VS Code + GitHub Copilot VS Code con GitHub Copilot (v1.108+) detecta automáticamente el plugin a través de `.copilot-plugin/plugin.json` cuando se clona este repositorio. No requiere instalación manual: simplemente clona y abre en VS Code. Para habilidades personales (disponibles en todos los proyectos), ejecuta el `install.sh` de arriba con la plataforma `vscode`. ### Copilot CLI ```bash copilot plugin install Egonex-AI/Understand-Anything:understand-anything-plugin ``` ### Compatibilidad de Plataformas | Plataforma | Estado | Método de Instalación | |----------|--------|----------------| | Claude Code | ✅ Nativo | Marketplace de plugins | | Cursor | ✅ Soportado | Detección automática | | VS Code + GitHub Copilot | ✅ Soportado | Detección automática | | Copilot CLI | ✅ Soportado | Instalación de plugin | | Codex | ✅ Soportado | `install.sh codex` | | OpenCode | ✅ Soportado | `install.sh opencode` | | OpenClaw | ✅ Soportado | `install.sh openclaw` | | Antigravity | ✅ Soportado | `install.sh antigravity` | | Gemini CLI | ✅ Soportado | `install.sh gemini` | | Pi Agent | ✅ Soportado | `install.sh pi` | | Vibe CLI | ✅ Soportado | `install.sh vibe` | | Hermes | ✅ Soportado | `install.sh hermes` | | Cline | ✅ Soportado | `install.sh cline` | | KIMI CLI | ✅ Soportado | `install.sh kimi` | | Nanobot | ✅ Soportado | `install.sh nanobot` | --- ## 📦 Comparte el Grafo con tu Equipo El grafo es solo JSON — **confírmalo una vez y tus compañeros se saltan el pipeline**. Ideal para onboarding, revisiones de PR y flujos docs-as-code. > **Ejemplo:** [GoogleCloudPlatform/microservices-demo](https://github.com/GoogleCloudPlatform/microservices-demo) — referencia políglota (Go / Java / Python / Node) con el grafo ya confirmado. **Qué confirmar:** todo lo que hay en `.understand-anything/` *excepto* `intermediate/` y `diff-overlay.json` (archivos temporales locales). ```gitignore .understand-anything/intermediate/ .understand-anything/diff-overlay.json ``` **Mantenlo al día:** activa `/understand --auto-update` — un hook post-commit parchea el grafo de forma incremental, así cada commit llega con su grafo correspondiente. O vuelve a ejecutar `/understand` manualmente antes de cada release. **Grafos grandes (10 MB o más):** úsalos con **git-lfs**. ```bash git lfs install git lfs track ".understand-anything/*.json" git add .gitattributes .understand-anything/ ``` --- ## 🔧 Bajo el Capó ### Híbrido Tree-sitter + LLM Lo determinista lo hace el análisis estático, lo semántico lo hace el LLM: - **Tree-sitter (determinista)** — parsea el código a un árbol de sintaxis concreto y extrae hechos estructurales: imports, exports, definiciones de funciones/clases, llamadas, herencia. Se preresuelve como `importMap` en la fase de escaneo y se pasa al file-analyzer para que no tenga que volver a derivar los imports desde el código fuente. La misma entrada siempre produce la misma salida, y también es la base de los fingerprints usados para las actualizaciones incrementales. - **LLM (semántico)** — lee la estructura parseada junto con el código original para producir lo que los parsers no pueden: resúmenes en lenguaje natural, etiquetas, asignaciones de capa arquitectónica, mapeo de dominios de negocio, tours guiados, notas sobre conceptos del lenguaje. Esta división es la que hace que el grafo sea reproducible en lo estructural (el mismo código siempre genera las mismas aristas) y a la vez capture intención en lo semántico (para *qué* sirve un archivo, no solo qué importa). ### Pipeline Multi-Agente El comando `/understand` orquesta 5 agentes especializados, y `/understand-domain` añade un sexto: | Agente | Rol | |-------|------| | `project-scanner` | Descubre archivos, detecta lenguajes y frameworks | | `file-analyzer` | Extrae funciones, clases e importaciones; produce nodos y aristas del grafo | | `architecture-analyzer` | Identifica capas arquitectónicas | | `tour-builder` | Genera recorridos de aprendizaje guiados | | `graph-reviewer` | Valida la completitud y la integridad referencial del grafo (se ejecuta inline por defecto; usa `--review` para una revisión completa con LLM) | | `domain-analyzer` | Extrae dominios de negocio, flujos y pasos de proceso (usado por `/understand-domain`) | | `article-analyzer` | Extrae entidades, afirmaciones y relaciones implícitas de artículos wiki (usado por `/understand-knowledge`) | Los analizadores de archivos se ejecutan en paralelo (hasta 5 concurrentes, 20-30 archivos por lote). Soporta actualizaciones incrementales: solo reanaliza los archivos que cambiaron desde la última ejecución. --- ## 🎥 Comunidad Un recorrido en video hecho por la comunidad de **Better Stack**.

Ver en YouTube →

¿Has hecho un video, post o tutorial? Abre un issue o PR — estaremos encantados de mostrarlo aquí. --- ## 🤝 Contribuir ¡Las contribuciones son bienvenidas! Así puedes empezar: 1. Haz fork del repositorio 2. Crea una rama de funcionalidad (`git checkout -b feature/my-feature`) 3. Ejecuta las pruebas (`pnpm --filter @understand-anything/core test`) 4. Haz commit de tus cambios y abre un pull request Para cambios importantes, abre primero un issue para que podamos discutir el enfoque. ---

Deja de leer código a ciegas. Empieza a entenderlo todo.

## Historial de Stars

Gracias a todas las personas que lo han usado y han contribuido — saber que les ahorra tiempo es lo que hizo que valiera la pena construirlo.