본문으로 건너뛰기

트렌딩 - GitHub 인기 레포 & HuggingFace 모델

ctxrs/ctx

Rust4 / 0

ctx는 로컬에 저장된 코딩 에이전트 세션을 SQLite로 색인하여 자연어 쿼리로 과거 대화와 명령을 빠르게 찾아주는 Rust 기반 CLI이다.

TL;DR

로컬에 흩어진 코딩 에이전트의 과거 세션을 재활용하지 못해 같은 실패를 반복하거나 결정의 근거를 잃는 문제가 존재했고 ctx는 Rust로 작성된 CLI로서 해당 기록을 발견해 세션·이벤트·파일 메타데이터로 정규화해 SQLite에 색인함으로써 자연어 검색으로 과거 작업을 빠르게 조회하게 한다. 검색 결과는 일치하는 스니펫과 세션/이벤트 식별자를 함께 반환해 출처 추적과 재현성을 보장하며, 문서의 차트는 ctx 검색이 raw transcript 검색보다 토큰 사용량을 대폭 줄여 응답 효율을 확보했음을 보여준다. 인덱스와 검색은 로컬에서만 동작하며 클라우드 전송이나 API 키를 요구하지 않아 민감한 기록을 외부에 노출하지 않으면서 기존 에이전트 메모리나 코드베이스 그래프와는 다른 '과거 세션의 원문 근거 기반' 검색을 제공한다.

핵심 포인트

  • 세션 단위 인용 검색을 제공한다. 많은 에이전트 메모리는 요약이나 벡터만 저장해 출처 추적이 어렵지만 ctx는 일치 스니펫과 세션/이벤트 식별자를 함께 반환해 어떤 발화가 근거인지 명확히 연결한다. 이는 명령 실패나 거부된 접근법의 원인을 확인할 때 직접적인 근거 추적을 가능하게 한다.
  • 로컬 전용, 서비스 불필요 모델을 지향한다. ctx는 색인을 로컬 SQLite에 보관하고 외부 모델 API나 클라우드 전송을 요구하지 않으므로 민감한 원문을 외부에 노출하지 않는다. 설치판은 서명된 자동 업그레이드를 제공하나 소스 빌드와 패키지 설치는 통제된 방식으로 유지된다.
  • 다수 에이전트 하네스에 대한 디스커버리와 플러그인 확장성을 갖췄다. README에 명시된 Codex, Claude Code, Cursor 등 여러 하네스의 기록을 직접 가져올 수 있으며 플러그인으로 미지원 포맷을 어댑터화할 수 있다. 이 구조는 조직별로 다양한 에이전트 도구를 혼용하는 환경에서도 일관된 검색 경험을 제공한다.
  • 색인하여 검색할 수 있다. ctx는 로컬에 분산된 에이전트 기록 파일을 발견해 세션, 이벤트, 터치된 파일 메타데이터로 정규화해 SQLite에 저장한다. 이 저장 방식은 반복적인 원문 스캔을 피하고 쿼리 응답 시 관련 스니펫과 출처 ID를 함께 반환해 재현성을 높인다.

벤치마크

벤치마크지표비교
Token output per agent history searchtokensctx search: 917, raw transcript search: 45,734vs raw transcript search: 45,734

이미지 분석

Token output per agent history search: ctx search 917 tokens, raw transcript search 45,734 tokens.
차트는 동일한 쿼리에 대해 ctx의 구조화된 세션·이벤트 기반 검색이 원시 트랜스크립트 검색에 비해 반환하는 토큰 수를 현저히 낮춘다는 것을 수치로 보여준다. 구체적으로 ctx 검색 결과는 약 917 토큰을 반환한 반면 원시 전체 텍스트 검색은 45,734 토큰을 반환해 토큰 소모 차이가 극명하게 나타났다. 이 수치는 로컬 인덱싱과 인용 기반 스니펫 반환이 토큰 효율성과 API 비용 절감에 직접적인 이점을 제공함을 의미한다.

627

STARS

30

FORKS

+249

TRENDING

4

조회수

watchers 627open issues 1Apache License 2.0

관련 토론

아직 관련 토론이 없습니다.

댓글

댓글을 작성하려면 로그인이 필요합니다.