redhat-et/ripwire

그것이 무엇인가 ripwire는 코드 저장소에서 실행하는 단일 바이너리입니다. 가벼운 인덱스를 구축하고 "X는 어디에서 처리되나?" 또는 "이 변경이 무엇을 깨뜨릴까?"와 같은 질문에 간결하고 순위가 매겨진 답변을 제공합니다. 서버, API 키, 임베딩, 백그라운드 데몬이 필요 없습니다. 오프라인으로 작동하며 많은 언어(C++, Python, Rust, Java, TypeScript 등)를 지원합니다.

왜 중요한가 코딩 에이전트(Claude Code, Codex, Cursor 등)는 종종 전체 파일을 읽거나 반복적으로 grep하여 코드를 탐색하며, 이는 토큰과 시간을 소모합니다. ripwire는 한 번의 호출로 동일한 정보를 제공합니다: 관련 항목의 순위가 매겨진 호출 그래프, 존재하는 호출자, 기호를 다루는 테스트, 제안된 편집이 영향을 미칠 범위입니다. 목표는 "하나의 질문, 하나의 완전한 답변"이며 후속 grep이 필요 없습니다.

주요 기능

• 방향 설정: ripwire .는 주요 하위 시스템, 진입점, 중요한 기호의 순위가 매겨진 개요를 제공합니다.
• 대상 쿼리: --for("곧 수행할 변경"), --callers, --expand, --path 등은 각각 간결하고 완전한 응답을 반환합니다.
• 편집 안전성: --edit-check는 호출 사이트 호환성, 폭발 반경, 변경에 도달하는 테스트를 표시합니다.
• 품질 게이트: --quality-delta는 12가지 코드 품질 문제(예: 중복, 공유 유틸리티 오용) 중 악화된 것만 보고합니다. 또한 후속 에이전트를 위해 기호에 고정할 수 있는 영구 메모를 추적합니다.
• 정직성: 출력은 항상 한계를 표시하고(예: "이것은 하한이며 총계가 아님"), 잘림을 공개하며, 누락된 행을 가져오기 위한 next= 토큰을 제공합니다. 조용히 버리지 않습니다.
• 토큰 예산: 답변당 예산을 설정할 수 있습니다. 맞지 않으면 알려주고 나머지를 얻는 방법을 보여줍니다.

설치 및 사용 한 줄로 바이너리를 설치하고 컴퓨터에서 찾은 모든 코딩 에이전트(Claude Code, Codex, Cursor, Windsurf, Gemini, opencode, aider)에게 ripwire를 언제 사용할지 자동으로 가르칩니다. 그런 다음 "이 저장소에서 ripwire 사용"과 같은 세션을 시작합니다. 에이전트는 필요에 따라 호출합니다. 선택적 MCP 서버 인터페이스도 있습니다.

성능 증거 README에는 측정값이 포함되어 있습니다: 저장소 인덱싱은 0.25–0.45초, 6.6–16.5MB를 사용하는 반면, 주요 그래프 데이터베이스 MCP 서버는 23–52초, 391–623MB가 걸립니다. 웜 쿼리는 197ms로 응답하는 반면 비교 대상은 1,082ms입니다. 일반적인 작업의 토큰 절약은 단순 파일 읽기나 grep에 비해 2–25배입니다.

구축 방법 품질 렌즈는 50년의 소프트웨어 엔지니어링 연구(McCabe 1976, Halstead 1977 등)와 최근 논문(2026년 말 기준)에 기반하며, 모두 docs/LINEAGE.md에 하나씩 기록되어 있습니다. 또한 237개의 도구를 조사했지만 기여한 것은 없었습니다(그리고 그렇게 말합니다)—접근 방식을 정직하고 증거 기반으로 유지합니다.

제한 사항(README에 명시)

• 정직성의 하한선이며, 맞춤 측정 설계를 대체하지 않습니다.
• arity 휴리스틱은 기본 후행 매개변수가 존재할 때 호환되지 않는 호출 사이트를 과대 계산할 수 있습니다(문서화됨; 컴파일로 검증).
• 광범위하고 일반적인 단어 개념 쿼리의 경우 단순 grep 및 읽기가 여전히 승리할 수 있습니다.

버전 및 라이선스 현재 버전은 0.6.8(Apache 2.0)입니다. 전체 참조 가이드, 설치 옵션, 평가는 저장소의 docs에 있습니다.