Dicklesworthstone/coding_agent_session_search

해결하는 문제

코딩 에이전트(Cursor, Claude Code, Aider 등)는 방대한 양의 대화 기록을 생성하지만, 이 데이터는 일반적으로 서로 다른 독점 형식과 저장 위치에 파편화되어 있습니다. 이로 인해 다양한 도구를 넘나들며 과거 세션에서 특정 솔루션이나 컨텍스트를 찾는 것이 어렵습니다. cass는 이러한 로컬 히스토리를 인덱싱하고 검색할 수 있는 통합된 고성능 인터페이스를 제공합니다.

작동 원리

cass는 다양한 에이전트의 세션 데이터를 공통 스키마로 정규화하여 로컬 SQLite 데이터베이스에 저장합니다. 다음과 같은 다계층 검색 방식을 사용합니다:

• Lexical Search: BM25 전체 텍스트 검색과 edge N-grams를 사용하여 정확한 용어 및 코드 심볼에 대해 즉각적인 접두사 기반 매칭을 수행합니다.
• Semantic Search: 선택적 기능으로, 로컬 MiniLM 모델(frankensearch를 통해)을 사용하여 네트워크 연결 없이 개념적 쿼리에 대한 벡터 유사성 검색을 수행합니다.
• Hybrid Search: 기본 모드로, Reciprocal Rank Fusion (RRF)을 사용하여 어휘 및 의미 검색 결과를 결합하여 정밀도와 재현율의 균형을 맞춥니다.

사용자를 위한 터미널 사용자 인터페이스(TUI)와 다른 AI 에이전트가 히스토리를 쿼리할 수 있도록 특별히 설계된 "Robot Mode"(JSON 출력이 있는 CLI)를 제공합니다.

대상 사용자

• 개인 개발자: AI 지원 코딩 세션의 단일 검색 가능한 아카이브를 원하는 개발자.
• 팀: 서로 다른 도구 선호도에 관계없이 조직적 지식을 공유하고자 하는 팀.
• AI 에이전트: 현재 문제 해결 능력을 향상시키기 위해 사용자의 히스토리 컨텍스트에 액세스해야 하는 에이전트.

주요 특징

• 폭넓은 호환성: Codex, Claude Code, Gemini CLI, Cursor, Aider, GitHub Copilot 및 기타 많은 도구의 히스토리를 통합합니다.
• 60ms 미만의 지연 시간: Rust 네이티브 백엔드를 기반으로 한 초고속 "타이핑 중 검색" 경험.
• 개인정보 보호 우선: 모든 인덱싱 및 추론이 로컬에서 수행되며, 데이터가 외부 서버로 전송되지 않습니다.
• Robot Mode: 다른 AI 에이전트와의 원활한 통합을 위해 안정적인 JSON 계약을 가진 전용 API 인터페이스.
• 원자적 업데이트: 원자적 스왑(atomic swaps)을 사용하여 인덱스 무결성을 보장하며, 백그라운드 인덱싱 중 검색 결과가 손상되는 것을 방지합니다.