ctx: 코딩 에이전트 히스토리 로컬 검색

ctx: 코딩 에이전트 히스토리 로컬 검색

ctx는 에이전트가 로컬 히스토리에서 과거 컨텍스트를 복구하도록 함

코딩 에이전트는 일반적으로 각 세션을 시작할 때 이전 상호작용에 대한 기억이 없습니다. 저장소의 현재 상태를 검사할 수는 있지만, 현재 코드베이스에 이르게 된 이전 토론, 거부된 접근 방식, 실패한 명령 등에 접근하지 못하는 경우가 많습니다. ctx는 로컬 에이전트 히스토리 파일을 로컬 SQLite 데이터베이스에 인덱싱함으로써 현재 및 미래의 에이전트가 CLI를 사용해 특정 이전 이벤트와 결정을 검색할 수 있게 합니다.

토큰 효율적인 검색 vs. 원시 전사 검색

원시 전사를 검색하는 것은 토큰 사용량 측면에서 종종 감당하기 어려울 정도로 비쌉니다. ctx는 히스토리를 세션, 이벤트, 메타데이터로 구조화함으로써 원시 검색보다 최대 50배 더 토큰 효율적으로 설계되었습니다.

전체 전사를 모델의 컨텍스트 창에 넣는 대신, ctx는 순위가 매겨진 인용 매치를 반환합니다. 이는 원시 검색의 "토큰 무거움" 때문에 히스토리가 에이전트에게 사용 불가능해지는 상황을 방지합니다.

기술 아키텍처와 프라이버시

Rust로 작성된 ctx는 백그라운드 서비스나 API 키가 필요 없는 로컬 퍼스트 도구입니다. 다음과 같은 파이프라인을 통해 동작합니다:

  1. Discovery: ctx는 머신에서 지원되는 로컬 제공자 히스토리 파일을 식별합니다.
  2. Import: 지속된 레코드를 가져와 세션, 이벤트, 터치된 파일 메타데이터를 정규화합니다.
  3. Storage: 데이터는 검색에 최적화된 로컬 SQLite 인덱스에 저장됩니다.

프라이버시를 유지하기 위해 인덱스는 기본적으로 로컬에 보관되고 비공개입니다. 이 도구는 프롬프트, 전사, 히스토리를 클라우드 서비스로 전송하지 않습니다. 그러나 전사 텍스트에는 로컬 경로와 잠재적인 비밀이 포함될 수 있으므로, 사용자는 머신 외부에 공유하기 전에 출력물을 검토해야 합니다.

지원되는 에이전트와 통합

ctx는 다음을 포함한 다양한 에이전트 하네스를 발견하고 히스토리를 가져올 수 있습니다:

  • Claude Code
  • Cursor
  • Codex
  • Copilot CLI
  • Pi
  • OpenCode
  • Antigravity / Gemini CLI
  • Factory AI Droid

사용자는 npx skills add ctxrs/ctx 로 "Agent Skill" 로 ctx를 통합하거나 Cursor, Claude Code와 같은 도구용 특정 플러그인 설치를 통해 에이전트 자체가 검색 CLI를 호출하도록 할 수 있습니다.

다른 메모 도구와의 비교

ctx는 코드 뒤에 있는 "왜"에 초점을 맞춘다는 점에서 일반적인 에이전트 메모 도구 및 코드베이스 매핑 도구와 차별화됩니다:

  • Agent Memory Tools: 보통 압축된 사실이나 벡터만 저장하는데, 이는 특정 결정이 왜 내려졌는지 혹은 명령이 왜 실패했는지 이해하는 데 필요한 증거가 부족합니다.
  • Codebase Graphs (예: Graphify): 파일과 심볼의 현재 상태를 매핑하지만, 저장소가 어떻게 변했는지에 대한 히스토리 프로세스를 포착하지 못합니다.
  • Grep/Log Search: 가능은 하지만, ctx는 구조화되고 인덱싱된 접근 방식을 제공하여 수동 grep보다 효율적입니다.

커뮤니티 관점 및 논의

구조화된 검색 도구의 유용성은 명확하지만, Hacker News의 일부 사용자는 이미 특정 에이전트가 자체 히스토리를 검색할 수 있다고 지적했습니다.

"나는 종종 Claude Code에 ~/.claude에 있는 이전 세션을 보라고 말하고, 특별한 도구 없이 jq/grep으로 이를 처리하게 합니다."

다른 기여자들은 다양한 제공자 간에 이러한 도구 제작을 단순화하기 위해 에이전트 전사와 로그에 대한 표준화된 포맷이 필요하다고 강조했습니다. ctx의 작성자 luca-ctx는 도구를 만들면서 에이전트 전사를 위한 표준 사양이 필요하다는 점이 명백해졌다고 언급했습니다.

요약: ctx는 로컬 코딩 에이전트 세션을 SQLite에 인덱싱하여 과거 토론, 결정, 실패 시도에 대한 빠르고 토큰 효율적인 검색을 제공하는 오픈 소스 CLI 도구입니다.

제목: ctx: 코딩 에이전트 히스토리 로컬 검색

Sources