ctxrs/ctx
Search the coding agent history already on your machine
해결하고자 하는 문제
코딩 에이전트는 이전 세션에 대한 기억이 부족해 이전 작업에서 내린 구체적인 결정, 실패한 시도, 사용한 명령을 복구하지 못합니다. 이로 인해 에이전트가 실수를 반복하거나 이전 논의에서 설정된 의도와 제약 조건을 잃어버릴 수 있습니다.
작동 방식
ctx는 Rust 기반 CLI 도구로, Cursor, Claude Code, Windsurf 등 다양한 코딩 에이전트 하네스에서 로컬 히스토리 파일을 발견하고 가져옵니다. 이 데이터를 로컬 SQLite 데이터베이스로 정규화하여 검색에 최적화합니다. 이를 통해 현재 에이전트는 자연어, 특정 파일, 혹은 키워드로 과거 세션을 검색하고 정확한 이벤트나 세션 전사를 컨텍스트로 가져올 수 있습니다.
대상 사용자
AI 코딩 에이전트를 사용하며, 에이전트에게 지속적이고 토큰 효율적인 방법으로 과거 프로젝트 컨텍스트에 접근하도록 하고 싶은 개발자를 위한 도구입니다.
주요 특징
- 광범위한 에이전트 지원: Claude Code, Cursor, Windsurf, GitHub Copilot CLI 등 다양한 에이전트 하네스를 지원합니다.
- 토큰 효율성: 전체 전사 검색 대신 순위가 매겨지고 인용된 매치를 반환함으로써 토큰 사용량을 크게 줄입니다.
- 로컬 및 프라이버시 보장: 모든 인덱싱 및 검색이 로컬 SQLite에서 이루어지며, 데이터가 클라우드 서비스나 모델 API로 전송되지 않습니다.
- 에이전트 친화적: 에이전트 자체가 사용할 수 있는 CLI를 제공하여 이전 세션의 컨텍스트를 검색하고 복구할 수 있습니다.