Sobre o projeto

Understand Anything é uma ferramenta open-source de compreensão de código que converte bases de código, bases de conhecimento e documentação em grafos de conhecimento interativos. Ele analisa projetos usando uma abordagem híbrida que combina parsing determinístico do Tree-sitter com análise semântica baseada em LLM, e apresenta os resultados por meio de um painel web interativo. ## Principais Recursos **Visualização de Codebase** - Constrói um grafo de nós e arestas de cada arquivo, função, classe e dependência - Codifica cores dos nós por camada arquitetônica (API, Serviço, Dados, UI, Utilidade) - Suporta busca fuzzy e semântica no grafo - Fornece resumos em linguagem simples para cada nó **Pipeline Multiagente** A ferramenta orquestra agentes especializados: scanner de projeto, analisador de arquivos, analisador de arquitetura, construtor de tours e revisor do grafo. Os analisadores de arquivos executam em paralelo com até 5 workers concorrentes. Execuções subsequentes são incrementais, reanalisando apenas arquivos alterados. **Análise de Domínio e Conhecimento** - A visão de domínio mapeia o código para processos de negócio, fluxos e etapas - A análise de base de conhecimento funciona com wikis LLM no padrão Karpathy, extraindo entidades, afirmações e relações implícitas com agrupamento comunitário **Aprendizado Guiado** - Tours guiados gerados automaticamente ordenados por dependência - 12 padrões de programação explicados em contexto - Interface adaptativa por persona ajustando o nível de detalhe para devs juniores, PMs ou usuários avançados **Análise de Impacto de Diff** - Veja quais partes do sistema uma alteração afeta antes de commitar - Rastreia efeitos em cascata em toda a base de código ## Instalação A ferramenta está disponível como plugin para Claude Code e instala em mais de 18 plataformas, incluindo Cursor, VS Code + GitHub Copilot, Codex, Gemini CLI, OpenCode, Copilot CLI, Kiro, Trae, Cline e outras. A maioria das instalações usa um único script: ``` curl -fsSL https://raw.githubusercontent.com/Egonex-AI/Understand-Anything/main/install.sh | bash ``` Usuários do Claude Code instalam pelo marketplace de plugins. Cursor e VS Code descobrem automaticamente o plugin quando o repositório é clonado. ## Dashboard Sem LLM O grafo de conhecimento gerado é armazenado como JSON e pode ser visualizado independentemente com: ``` npx https://github.com/Egonex-AI/Understand-Anything/releases/latest/download/understand-anything-viewer.tgz /path/to/project ``` Isso requer apenas Node.js (>= 18), serve conteúdo somente leitura do disco local e não faz chamadas a LLM. ## Localização Suporta saída multilíngue (en, zh, zh-TW, ja, ko, ru) via flag `--language`, afetando resumos dos nós, UI do dashboard e conteúdo dos tours guiados. ## Compartilhamento O grafo JSON pode ser commited ao version control para que membros da equipe possam explorar sem executar o pipeline. Git LFS é recomendado para grafos grandes (10 MB+). Um hook pós-commit opcional mantém o grafo incrementally atualizado. ## Licença Licença MIT. Criado por Lum1104 e publicado por Egonex (Infinite Universe, Inc.).