redhat-et/ripwire

해결하는 문제

Ripwire는 AI 코드 에이전트가 대규모 코드베이스를 탐색하고 이해하는 데 있어 높은 정밀도와 토큰 효율성을 제공합니다. 단순한 grep 기반 검색이나 전체 파일을 읽는 것에 의존하는 대신, Ripwire는 순위가 매겨진 결정론적 콜 그래프를 생성합니다. 이로 인해 에이전트는 정확히 어떤 심볼을 수정해야 하는지, 변경의 영향 범위(블라스트 레이디우스)는 어느 정도인지, 어떤 테스트를 실행해야 하는지 파악할 수 있으며, 엄격한 토큰 예산 내에서 작업할 수 있습니다.

작동 방식

Ripwire는 로컬에서 오프라인으로 작동하는 자체 포함형 바이너리입니다. 21개의 다른 언어를 지원하는 내장된 tree-sitter 문법을 사용하여 코드를 분석합니다. API 키, 임베딩, 백그라운드 데몬이 필요하지 않습니다.

쿼리가 요청되면 다음을 포함한 최소화된 XML 출력을 생성합니다:

• 순위 매겨진 심볼: 작업과 관련된 심볼로, 중요도 순으로 정렬되며 복잡도, git churn, 변경 확대율 등의 메타데이터를 포함합니다.
• 1단계 콜 컨텍스트: 식별된 심볼의 즉각적인 호출자와 피호출자를 포함합니다.
• 신뢰도 점수: 도구가 결과에 대해 얼마나 확신하는지를 평가합니다.

또한 코드베이스의 자체 포함형 HTML 맵도 생성할 수 있으며, 순환 복잡도나 git churn과 같은 메트릭에 따라 노드의 색상으로 콜 그래프를 시각화합니다.

대상 사용자

Claude Code, Cursor, Windsurf, Gemini, Aider와 같은 AI 코드 에이전트를 사용하여 토큰 비용을 줄이고 에이전트의 코드 수정 정확도를 높이고자 하는 개발자들을 위한 도구입니다. 리포지토리의 구조화된 '지도'를 제공함으로써 이를 달성합니다.

주요 특징

• 토큰 효율성: 일반적인 작업에서 단순한 읽기 및 grep 방법 대비 최대 90%의 토큰 사용량 감소 가능.
• 광범위한 언어 지원: Rust, C++, Python, Go, TypeScript, Java 등 21개 언어를 지원.
• 고성능: 리포지토리 인덱싱은 0.31초(중앙값) 이내로 완료되며, 빠른 웜 쿼리 제공.
• 결정론적이고 투명함: 추측을 명시적으로 라벨링하고 출력 내 모든 자르기(트렁케이션)를 공개하며, 암시적 거짓말이나 재구성하지 않습니다.
• 인프라 없음: 인덱스 서버, 임베딩, API 키가 전혀 필요하지 않습니다.