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 search | tokens | ctx search: 917, raw transcript search: 45,734 | vs raw transcript search: 45,734 |
이미지 분석

627
STARS
30
FORKS
+249
TRENDING
4
조회수
관련 토론
아직 관련 토론이 없습니다.
댓글
댓글을 작성하려면 로그인이 필요합니다.