defendend/Claude-ast-index-search

해결하는 문제

간단한 텍스트 기반 검색(Grep 등)은 대규모 다중 언어 코드베이스를 탐색할 때 너무 느리거나 정확도가 떨어집니다. 이 도구는 개발자와 AI 에이전트가 파일 전체를 읽거나 심볼이 정의된 위치를 추측하지 않고도 클래스, 함수, 종속성과 같은 정확한 구조적 요소를 찾을 수 있도록 합니다.

작동 방식

이 도구는 프로젝트의 추상 구문 트리(AST)에 대한 로컬 SQLite 인덱스를 생성합니다. 코드의 구조를 분석함으로써 심볼, 참조, 임포트, 모듈, 상속 패턴을 매핑합니다. 사용자는 CLI를 통해 이 인덱스를 질의하여 정의로 바로 이동하거나, 심볼의 모든 사용 사례를 찾거나, 모듈 간 종속성 경로를 매핑할 수 있습니다.

대상 사용자

• 개발자: 특히 모노레포에서 작업하며 빠르고 구조적인 코드 탐색이 필요한 사용자.
• AI 코딩 에이전트 (예: Claude Code, Cursor, Gemini 등): 토큰을 절약하고 정확도를 높이기 위해 원시 파일 덤프 대신 작고 분석 가능한 구조적 컨텍스트가 필요한 사용자.

주요 기능

• 광범위한 언어 지원: Kotlin, Java, Swift, Rust, TypeScript, Python, Go, C# 등 수많은 언어를 지원합니다.
• 에이전트 최적화: 전체 파일 대신 구조적 슬라이스를 제공하여 에이전트의 토큰 사용량을 40–50% 감소시킵니다.
• 고성능: 인포트, 종속성, 클래스 검색에서 Grep보다 훨씬 빠릅니다 (일부 벤치마크에서 최대 260배 빠름).
• 심층 통합: Claude Code, Cursor, Codex, Gemini CLI용 플러그인과 스킬 제공.
• 고급 분석: 모듈 종속성 라우팅, XML/리소스 사용 분석, iOS 전용 구조적 쿼리 등 전문 명령어 포함.