AI 코딩 세션 기록, 로컬에서 검색한다

AI 코딩 에이전트를 두세 개씩 번갈아 쓰는 사람이 가장 자주 잃어버리는 자산은 '지난주에 이미 해결한 문제'다. 브레인컴퍼니(braincompany)가 아파치 2.0 라이선스로 공개한 세션그렙(sessiongrep)은 클로드 코드(Claude Code)·코덱스 CLI(Codex CLI)·커서(Cursor)·안티그래비티(Antigravity)·파이(Pi)가 각자 남긴 대화 기록을 하나의 로컬 데이터베이스로 묶고, 명령줄 도구 하나로 되찾아 준다.

무슨 일인가 / 배경

에이전트 도구가 늘어난 만큼 기록도 흩어졌다. 클로드 코드는 홈 디렉터리의 .claude/projects, 코덱스는 .codex/sessions, 커서는 .cursor/projects에 각각 JSONL 형식으로 대화를 쌓는다. 파일명은 사람이 알아볼 수 없는 문자열이고 내용은 도구 호출 결과가 뒤섞여 있어, 일반적인 문자열 검색으로는 원하는 대목을 건지기 어렵다. 정보가 없는 게 아니라, 분명히 있는데 꺼낼 수 없는 상태다.

셸 히스토리는 실행한 명령어만 남기지 그 판단의 이유를 남기지 않는다. 반대로 기록을 클라우드에 올려 벡터 검색을 붙이는 서비스는 코드와 URL, 자격증명까지 남의 서버로 보낸다는 부담이 따른다. 세션그렙은 이 지점을 정반대로 잡았다. 데몬도 서버도 없이 정적 바이너리 하나와 SQLite 파일 하나로 끝내고, 색인은 언제든 지웠다 다시 만들 수 있는 캐시로 취급한다.

핵심 짚어보기

동작 구조는 단순하다. 제공자별 어댑터가 각 도구의 대화 기록을 공통 형식으로 정규화한 뒤 SQLite(WAL 모드)에 적재하고, 전사문·제목·요약·미리보기 위에 FTS5 전문검색 테이블을 얹는다. 검색이나 목록 같은 읽기 명령을 실행할 때마다 증분 재색인이 먼저 돌지만, 수정 시각과 크기가 그대로인 파일은 건너뛰기 때문에 기록이 쌓여도 체감 속도는 유지된다. 크론 등록이나 수동 갱신 절차가 따로 없다는 뜻이다.

설치하면 실행 파일 두 개가 생긴다. 사람이 쓰는 sessiongrep(CLI·TUI)과 에이전트가 붙는 sessiongrep-mcp(MCP 서버)다. 후자가 핵심이다. 에이전트가 자기 과거 기록을 직접 검색해 예전에 내린 판단을 다시 꺼내 보고, 심지어 그 판단을 반박까지 할 수 있다. 빌드에는 러스트(Rust) 1.70 이상 툴체인이 필요하며, cargo 명령으로 설치한다.

1인기업 실전 적용 포인트

• 도구를 갈아탈 때 맥락을 버리지 않는다. 클로드 코드로 시작한 리팩터링을 코덱스에서 이어받을 때, 이전 세션의 결정 이유를 검색해 새 세션 첫 프롬프트에 붙여 넣으면 재설명 비용이 사라진다.
• 문의 대응을 자산으로 바꾼다. 고객 문의나 배포 사고를 에이전트와 함께 처리했다면 그 세션 자체가 검색 가능한 매뉴얼이 된다. 별도 문서화에 시간을 쓰지 않고도 '저번에 이 오류 어떻게 넘겼더라'가 1분 안에 해결된다.
• MCP 서버를 상시 연결해 둔다. 에이전트 설정에 sessiongrep-mcp를 등록해 두면, 새 작업을 시작할 때 '이 저장소에서 비슷한 작업 이력을 먼저 찾아보라'는 지시 한 줄로 중복 작업을 걸러낼 수 있다.
• 기밀이 걸린 작업일수록 유리하다. 색인이 로컬 SQLite 파일 하나이므로 고객사 코드나 API 키가 담긴 세션도 외부로 나가지 않는다.

전망 / 주의점

러스트 툴체인을 직접 깔고 빌드해야 한다는 점은 비개발자에게 명확한 진입 장벽이다. 별점 20여 개 수준의 초기 프로젝트라 각 도구가 기록 형식을 바꿀 때 어댑터가 따라가지 못할 가능성도 감안해야 한다. 그럼에도 방향은 분명하다. 에이전트 경쟁의 축이 모델 성능에서 '기억'으로 옮겨 가는 중이고, 그 기억을 남의 클라우드가 아니라 내 디스크에 두는 선택지가 실제로 작동한다는 것을 보여줬다. 세션 기록은 이미 매일 내 컴퓨터에 쌓이고 있다. 문제는 지금까지 꺼내 쓸 수단이 없었다는 것뿐이다.

출처: 해커뉴스(HN) (https://github.com/braincompany/sessiongrep)