
archex: 코딩 에이전트를 위한 로컬 우선(local-first), 결정론적(deterministic) 코드 컨텍스트 — 26개 언어 지원
요약
archex는 코딩 에이전트를 위한 로컬 우선 및 결정론적 코드 컨텍스트 생성 도구입니다. BM25F와 그래프 확장을 사용하여 저장소를 효율적인 컨텍스트 번들로 변환하며, 기존 방식 대비 높은 재현율과 낮은 토큰 비용을 제공합니다.
핵심 포인트
- 로컬 임베딩과 그래프 확장을 통한 결정론적 컨텍스트 생성
- 기존 도구 대비 압도적인 필수 파일 재현율(0.95) 달성
- 토큰 사용량 절감 및 0ms의 콜드 스타트 성능 제공
- 26개 언어 지원 및 MCP 서버, CLI, Python API 제공
archex는 코딩 에이전트가 단순히 grep 방식으로 코드를 검색하게 두는 대신, 저장소(repo)를 순위가 매겨지고 토큰 예산(token-budgeted)이 설정된 컨텍스트 번들로 변환합니다. BM25F + 로컬 임베딩(local embeddings) + 임포트/타입/호출자(imports/types/callers)를 위한 그래프 확장(graph expansion)을 사용하여 완전히 결정론적(deterministic)입니다. 즉, 동일한 쿼리, 동일한 인덱스 버전, 동일한 번들이 매번 동일하게 생성됩니다. 호스팅된 추론(hosted inference), API 키, 핵심 경로에서의 텔레메트리(telemetry)가 없습니다. 동일한 19개 작업의 외부 저장소 세트(직접 실행, 저장소에 체크인됨, archex 벤치마크 headto-head 보고서로 재현 가능)를 기준으로 cocoindex-code 및 Graphify와 비교 측정했습니다: 필수 파일 재현율(required-file recall)은 archex 0.95 vs cocoindex-code 0.32 vs Graphify 0.70이며, 완성 패널티 토큰(completion-penalty tokens)은 922 vs 11,188 vs n/a (Graphify는 다른 영역을 측정함)이고, 콜드 스타트(cold-start)는 0ms vs 4.7s vs 937ms입니다. 전체 표와 방법론은 docs/ARCHEX_VS_COCOINDEX.md에서 확인할 수 있습니다. 전체/구조화/청크 전용(full/structured/chunk-only) 티어에 걸쳐 26개 언어를 지원하며, 17개의 도구를 갖춘 MCP 서버, CLI, Python API, Docker를 제공합니다. 개인 프로젝트로서 3,619개의 테스트와 91.1%의 커버리지를 달성했습니다. 데모가 첨부되어 있습니다. github.com/Mathews-Tom/archex 유용하다면 Star를 눌러주시고, 누락된 언어나 워크플로우가 있다면 이슈(issue)를 열어주세요. 그리고 grep-and-hope 방식의 컨텍스트와 싸우고 있는 다른 사람들에게도 전달해 주세요. /u/tom_mathews에 의해 제출됨 [link] [comments]
AI 자동 생성 콘텐츠
본 콘텐츠는 r/LocalLLaMA의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기