defendend/Claude-ast-index-search

해결하는 문제

ast-index는 대규모 다중 언어 저장소를 위해 설계된 구조화된 코드 탐색 CLI입니다. 부정확한 "grep 스타일" 텍스트 검색을 AST(추상 구문 트리) 인식 인덱스로 대체하여, 개발자와 AI 에이전트가 단순한 텍스트 일치가 아닌 클래스, 함수, 상속 관계와 같은 정확한 구조를 기반으로 코드를 탐색할 수 있게 합니다.

작동 방식

이 도구는 심볼, 참조, 임포트, 모듈 및 의존성에 대한 로컬 SQLite 인덱스를 구축합니다. Kotlin, Java, Rust, Python, Go, C++ 등 다양한 언어를 지원합니다. 사용자는 rebuild로 인덱스를 구축하고 update로 최신 상태를 유지할 수 있습니다.

AI 에이전트에게는 원시 파일 덤프 대신 간결하고 파싱 가능한 구조화된 코드 조각을 제공하여 대규모 저장소에서 토큰 사용량을 40~50%까지 줄일 수 있습니다. 또한 플러그인이나 스킬을 통해 Claude Code, Cursor, Gemini CLI와 같은 AI 도구와 통합됩니다.

대상 사용자

• 개발자: 대규모 모노레포나 다중 언어 프로젝트에서 심볼과 의존성을 빠르고 정확하게 탐색해야 하는 분.
• AI 에이전트 개발자: 코딩 에이전트에게 코드베이스에 대한 고정밀, 저토큰 컨텍스트를 제공하고자 하는 분.

주요 특징

• AST 인식 탐색: 수십 개의 언어에 걸쳐 정의, 사용처, 호출자 및 구현으로 직접 이동할 수 있습니다.
• 에이전트 최적화: 구조화된 코드 조각을 반환하여 토큰을 절약하고 LLM에 더 나은 컨텍스트를 제공합니다.
• Git 통합 인사이트: hotspots 명령을 포함하여 변경 빈도, 버그 수정, 작성자 수에 따라 파일 순위를 매겨 불안정한 코드를 식별합니다.
• 심볼 그래프: 심볼 간 의존성 그래프를 구축하여 영향 분석, 순환 참조 찾기, 가장 핵심적인 심볼을 결정합니다.
• 고성능: 대규모 프로젝트에서 임포트, 의존성, 클래스를 찾을 때 grep보다 훨씬 빠릅니다.
• 모노레포 지원: 중첩된 프로젝트 마커 및 루트를 넘나드는 워크스페이스를 위한 특정 워크플로우를 포함합니다.