코딩 에이전트용 로컬 코드 인덱스: 언어 서버 없이 임포트 해결

Basemind는 MIT 라이선스의 Rust 도구로, AI 코딩 에이전트를 위한 로컬 코드 인덱스를 구축하고, 언어 서버 없이 import를 해석하고 호출 그래프를 만듭니다. 빌드 단계나 언어별 데몬 없이 완전히 오프라인으로 실행되며, 에이전트가 편집 중인 저장소가 컴파일되지 않을 때 중요합니다.

이 도구는 이해 깊이에 따라 언어 지원을 계층화합니다. JS/TS는 oxc를 통해 실제 스코프 트리, 심볼 테이블, import/export 해석, 모노레포의 tsconfig 경로 별칭을 지원합니다. Python과 Java는 GitHub의 stack-graphs (아카이브되었지만, 포크되어 유지 관리되며, 타입 스플랫 매개변수나 연쇄 할당에서 해석을 중단하던 4개의 업스트림 규칙 버그가 수정됨)를 사용합니다. 나머지 언어는 파일 내 어휘적 스코프 바인딩만 지원합니다.

371개의 문법이 파싱되고, 약 100개가 심볼과 호출을 제공하며, 3개가 실제 해석을 지원합니다. 핵심 설계 선택: 함수의 호출자를 요청하면 이름 스캔으로 찾은 모든 호출 사이트를 반환하고, 해석이 증명된 것에 주석을 달지만, 증명된 부분만 필터링하지 않습니다. 이는 이전 버전의 실패 모드를 방지합니다. 이전 버전은 증명된 히트만 필터링하여 172개의 파일에서 2개의 호출자를 보고했으며, 잘림 플래그가 없었습니다.

성능: TypeScript 컴파일러(81k 파일) 스캔은 M4에서 약 18초가 걸립니다. git 기록 쿼리는 기록 깊이에 관계없이 수십 마이크로초에 응답합니다. 인덱스는 로컬 캐시에 저장됩니다.

저자는 이것이 LSP 정밀도가 아니라고 인정합니다. 제네릭, 매크로, 동적 디스패치, DI 컨테이너, 몽키 패칭의 경우 언어 서버가 정확하고 Basemind는 틀릴 수 있습니다. 그러나 컴파일되지 않는 저장소를 편집 중인 에이전트에게는 실용적인 대안입니다.

대상: 언어 서버의 오버헤드 없이 빠르고 오프라인 코드 탐색이 필요한 AI 코딩 에이전트를 개발하거나 사용하는 개발자.