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

--- > [!TIP] > **¡Un enorme agradecimiento a la comunidad!** El apoyo a Understand-Anything ha sido increíble. Si esta herramienta te ahorra unos minutos de buscar entre la complejidad, eso es todo lo que quería. 🚀 **Acabas de unirte a un nuevo equipo. El código tiene 200,000 líneas. ¿Por dónde empiezas?** Understand Anything es un plugin de [Claude Code](https://docs.anthropic.com/en/docs/claude-code) 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. > **Grafos que enseñan > grafos que solo presumen.** --- ## ✨ Características > [!NOTE] > **¿Quieres probarlo directamente?** Prueba la [demo en vivo](https://lum1104.github.io/Understand-Anything/demo/) en nuestra [página principal](https://lum1104.github.io/Understand-Anything/) — 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.

Grafo estructural — explora archivos, funciones, clases y sus relaciones

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

Grafo de dominio — dominios de negocio, flujos y pasos de proceso

### 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 Lum1104/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`. ### 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 ``` --- ## 🌐 Instalación Multiplataforma Understand-Anything funciona en múltiples plataformas de codificación con IA. ### Claude Code (Nativo) ```bash /plugin marketplace add Lum1104/Understand-Anything /plugin install understand-anything ``` ### Codex Dile a Codex: ``` Fetch and follow instructions from https://raw.githubusercontent.com/Lum1104/Understand-Anything/refs/heads/main/.codex/INSTALL.md ``` ### OpenCode Dile a OpenCode: ``` Fetch and follow instructions from https://raw.githubusercontent.com/Lum1104/Understand-Anything/refs/heads/main/.opencode/INSTALL.md ``` ### OpenClaw Dile a OpenClaw: ``` Fetch and follow instructions from https://raw.githubusercontent.com/Lum1104/Understand-Anything/refs/heads/main/.openclaw/INSTALL.md ``` ### 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. ### 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), dile a GitHub Copilot: ```text Fetch and follow instructions from https://raw.githubusercontent.com/Lum1104/Understand-Anything/refs/heads/main/.vscode/INSTALL.md ``` ### Copilot CLI ```bash copilot plugin install Lum1104/Understand-Anything:understand-anything-plugin ``` ### Antigravity Dile a Antigravity: ```text Fetch and follow instructions from https://raw.githubusercontent.com/Lum1104/Understand-Anything/refs/heads/main/.antigravity/INSTALL.md ``` ### Gemini CLI Dile a Gemini CLI: ```text Fetch and follow instructions from https://raw.githubusercontent.com/Lum1104/Understand-Anything/refs/heads/main/.gemini/INSTALL.md ``` ### Pi Agent Dile a Pi Agent: ```text Fetch and follow instructions from https://raw.githubusercontent.com/Lum1104/Understand-Anything/refs/heads/main/.pi/INSTALL.md ``` ### Compatibilidad de Plataformas | Plataforma | Estado | Método de Instalación | |----------|--------|----------------| | Claude Code | ✅ Nativo | Marketplace de plugins | | Codex | ✅ Soportado | Instalación guiada por IA | | OpenCode | ✅ Soportado | Instalación guiada por IA | | OpenClaw | ✅ Soportado | Instalación guiada por IA | | Cursor | ✅ Soportado | Detección automática | | VS Code + GitHub Copilot | ✅ Soportado | Detección automática | | Copilot CLI | ✅ Soportado | Instalación de plugin | | Antigravity | ✅ Soportado | Instalación guiada por IA | | Gemini CLI | ✅ Soportado | Instalación guiada por IA | | Pi Agent | ✅ Soportado | Instalación guiada por IA | --- ## 📦 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 (fork)](https://github.com/Lum1104/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ó ### 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. --- ## 🤝 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