understand-anything

Understand Anything는 코드베이스, 지식베이스, 문서를 상호작용 가능한 지식 그래프로 변환하는 오픈소스 코드 이해 도구입니다. 결정론적 Tree-sitter 파싱과 LLM 기반 의미 분석을 결합한 하이브리드 접근 방식으로 프로젝트를 분석한 다음, 상호작용 가능한 웹 대시보드를 통해 결과를 제시합니다. ## 주요 기능 **코드베이스 시각화** - 모든 파일, 함수, 클래스, 의존성의 노드와 엣지 그래프를 구축합니다 - 아키텍처 레이어(API, 서비스, 데이터, UI, 유틸리티)에 따라 노드를 색상 코딩합니다 - 그래프 전체에 대한 퍼지 및 의미 검색을 지원합니다 - 각 노드에 대한 평이한 언어 요약을 제공합니다 **다중 에이전트 파이프라인** 이 도구는 전문 에이전트를 오케스트레이션합니다: 프로젝트 스캐너, 파일 분석기, 아키텍처 분석기, 투어 빌더, 그래프 리뷰어. 파일 분석기는 최대 5개의 병렬 작업자로 실행됩니다. 이후 실행은 증분 방식으로 변경된 파일만 재분석합니다. **도메인 및 지식 분석** - 도메인 뷰는 코드를 비즈니스 프로세스, 흐름 및 단계에 매핑합니다 - 지식베이스 분석은 Karpathy 패턴 LLM 위키와 작동하여 엔티티, 주장, 암시적 관계를 커뮤니티 클러스터링으로 추출합니다 **안내 학습** - 의존성 순으로 정렬된 자동 생성 안내 투어 - 컨텍스트에서 설명되는 12개의 프로그래밍 패턴 - 주니어 개발자, PM 또는 파워 사용자를 위해 상세 수준을 조정하는 페르소나 적응형 UI **diff 영향 분석** - 커밋하기 전에 시스템 변경이 영향을 미치는 부분을 확인 - 코드베이스 전반의 연쇄 효과 추적 ## 설치 이 도구는 Claude Code용 플러그인으로 제공되며, Cursor, VS Code + GitHub Copilot, Codex, Gemini CLI, OpenCode, Copilot CLI, Kiro, Trae, Cline 등을 포함한 18개 이상의 플랫폼에 설치됩니다. 대부분의 설치는 단일 스크립트를 사용합니다: ``` curl -fsSL https://raw.githubusercontent.com/Egonex-AI/Understand-Anything/main/install.sh | bash ``` Claude Code 사용자는 플러그인 마켓플레이스를 통해 설치합니다. Cursor와 VS Code는 저장소를 클론하면 플러그인을 자동으로 탐색합니다. ## LLM 없이 대시보드 생성된 지식 그래프는 JSON으로 저장되며 다음 명령으로 독립적으로 볼 수 있습니다: ``` npx https://github.com/Egonex-AI/Understand-Anything/releases/latest/download/understand-anything-viewer.tgz /path/to/project ``` 이것은 Node.js (>= 18)만 필요로 하며, 로컬 디스크에서 읽기 전용으로 제공하고 LLM 호출을 하지 않습니다. ## 현지화 `--language` 플래그를 통해 다국어 출력(en, zh, zh-TW, ja, ko, ru)을 지원하며, 노드 요약, 대시보드 UI, 안내 투어 내용에 영향을 미칩니다. ## 공유 JSON 그래프를 버전 관리에 커밋하여 팀원이 파이프라인을 실행하지 않고 탐색할 수 있습니다. 대형 그래프(10 MB 이상)에는 Git LFS를 권장합니다. 선택적 post-commit 훅이 그래프를 증분으로 업데이트합니다. ## 라이선스 MIT 라이선스. Lum1104가 제작하고 Egonex(Infinite Universe, Inc.)가 배포합니다.