프로젝트 소개

deja-vu는 AI 코딩 에이전트를 위한 로컬 전용 메모리 계층입니다. Claude Code, Codex CLI, Cursor, Copilot CLI, Gemini CLI, Goose 등 34개 이상의 에이전트가 이미 디스크에 기록하는 세션 트랜스크립트를 인덱싱하여, 그 기록을 모든 에이전트에서 검색할 수 있게 합니다. 한 에이전트에서 찾은 수정 사항을 다른 어떤 에이전트에서도 검색할 수 있습니다. 주요 기능: - 소급 검색: deja-vu 설치 이전의 세션을 포함하여 기존 기록의 기가바이트 단위를 쿼리합니다. 자연어 쿼리는 관련성 계층으로 폴백되며, 시간은 필터가 아닌 힌트입니다. - MCP를 통한 에이전트 간 회상: `recall` 모드의 단일 `deja` MCP 도구가 "3주 전에 이걸 고쳤잖아"와 같은 질문에 답합니다. 원래 어떤 에이전트가 해결했든 상관없습니다. - 컴팩션 생존: Claude Code와 Codex에서 훅이 컴팩션 시작 시 작업, 파일, 명령을 캡처한 뒤 다음 세션에서 한 번 반환합니다. 43회의 컴팩션을 측정한 결과, 요약은 결정의 77%를 보존하지만 명령은 0.2%만 보존합니다. deja-vu가 나머지를 복구합니다. - 행동 시점 회상: 에이전트가 파일을 편집하거나 명령을 실행하기 전에 deja-vu가 이전 결정이나 작동했던 호출을 표시합니다. PostToolUse 훅이 동일한 오류 뒤에 이전에 무엇이 뒤따랐는지 답합니다. - 작업 인덱싱: 열린 파일, 종료 상태와 함께 실행된 명령, 정확한 편집 범위를 기록합니다—요약이 버리는 세부 사항입니다. - 리댁션: AWS 키, API 토큰, JWT, PEM 개인 키 블록, 베어러 토큰, URL 자격 증명, 고엔트로피 값이 인덱싱 시점에 제거됩니다. CLI 명령에는 검색용 `deja <query>`, 파일 수준 기록용 `deja blame <path>`, 과거 오류 해결용 `deja fix <error>`, 반복 오류용 `deja friction`, 마크다운 다이제스트용 `deja ctx <query>`, 머신 간 메모리 전송용 `deja sync ssh`, 시각적 요약용 `deja stats --card`가 있습니다. `deja forget`은 제거된 세션의 재인덱싱을 방지하기 위해 툼스톤을 기록합니다. 설치는 curl 스크립트, Homebrew, Scoop, Go install 또는 npx를 통해 이루어집니다. `deja install --auto`는 감지된 모든 에이전트에 MCP 회상을 연결하고 첫 인덱스를 구축합니다. 선택적 시맨틱 회상은 로컬 Ollama, LM Studio 또는 OpenAI 호환 엔드포인트와 함께 `deja embed`를 통해 사용할 수 있으며, 어휘 검색은 이것 없이도 작동합니다. 저장소에는 벤치마크 하네스(LongMemEval-S 및 LoCoMo)와 회상 순위, 컨텍스트 다이제스트, 블록 생존, 수집 비용을 위한 여러 `deja bench` 하위 명령이 포함되어 있습니다. 모든 인덱싱과 검색은 로컬에서 실행되며, 네트워크는 `deja update`, `deja sync ssh`, 버전 확인에만 사용됩니다.