AI 에이전트의 세션 기억을 돕는 MCP 기반 셸 히스토리 도구 Suvadu 공개

실용적 조언

AI 에이전트가 동일한 오류를 반복한다면 Suvadu를 통해 과거 세션의 실패 기록을 쿼리하게 하여 루프를 방지할 수 있다.
Claude Code 사용 시 'suv init claude-code' 명령어로 간단히 연동하여 이전 세션의 맥락을 이어갈 수 있다.

섹션별 상세

AI 에이전트가 세션 간 컨텍스트를 유지하지 못하는 문제를 해결하기 위해 Suvadu라는 셸 히스토리 도구를 개발했다. 이 도구는 MCP 서버를 내장하여 Claude가 사용자의 전체 터미널 기록을 쿼리할 수 있도록 지원한다. SQLite 기반의 로컬 저장소를 사용하여 보안성을 확보했으며, Rust로 작성되어 성능을 최적화했다. MIT 라이선스로 공개되어 누구나 자유롭게 이용 가능하다.

bash

install Suvadu
suv init claude-code

Suvadu 설치 및 Claude Code 연동을 위한 초기화 명령어

Claude Code와 Cursor 등 다양한 에이전트의 활동 내역을 통합하여 분석할 수 있는 기능을 제공한다. 사용자가 특정 프로젝트에서 작업한 에이전트 세션을 묻자, Suvadu는 10개의 세션을 찾아내어 각 세션의 프롬프트, 명령 횟수, 성공률을 정확히 제시했다. 이를 통해 파편화된 개발 워크플로우를 하나의 타임라인으로 연결하고 과거의 성공 사례를 재사용할 수 있다.

반복되는 실패 패턴을 추적하여 에이전트의 비효율적인 루프를 감지하고 개선하는 데 활용된다. 특정 테스트가 여러 세션에서 반복적으로 실패하는 것을 추적하거나, 에이전트가 이미 설치된 의존성을 8번이나 다시 설치하려는 무한 루프를 발견하는 사례가 공유됐다. 140개의 명령 중 60%의 성공률을 기록하며 3일간 정체되었던 원인을 파악하는 데 결정적인 근거를 제공했다.

용어 해설

모델 컨텍스트 프로토콜(MCP): — Model Context Protocol의 약자로, AI 모델이 외부 도구나 데이터 소스에 표준화된 방식으로 접근할 수 있게 해주는 프로토콜이다. 에이전트가 로컬 파일이나 데이터베이스를 일관된 방식으로 읽고 쓸 수 있게 하여 확장성을 높인다.
클로드 코드(Claude Code): — Anthropic에서 개발한 터미널 기반의 AI 코딩 에이전트로, 파일 수정, 명령 실행, 코드 분석 등을 직접 수행한다. 사용자의 로컬 환경에서 직접 작동하며 복잡한 개발 작업을 자동화하는 데 특화되어 있다.
에스큐엘라이트(SQLite): — 서버가 필요 없는 가벼운 파일 기반 관계형 데이터베이스 관리 시스템이다. 모든 데이터를 로컬 파일 하나에 저장하므로 설정이 간편하고 보안성이 뛰어나며, Suvadu에서는 셸 히스토리를 저장하는 용도로 사용된다.
러스트(Rust): — 메모리 안전성과 고성능을 동시에 제공하는 시스템 프로그래밍 언어이다. 가비지 컬렉션 없이도 안전한 메모리 관리가 가능하여 Suvadu와 같은 시스템 도구의 실행 속도와 안정성을 보장한다.
셸 히스토리(Shell History): — 사용자가 터미널(셸)에서 입력한 명령어들의 기록이다. Suvadu는 이 기록을 인덱싱하여 AI 에이전트가 과거에 어떤 명령을 내렸고 어떤 결과가 나왔는지 파악할 수 있는 컨텍스트로 활용한다.

언급된 도구

Suvadu추천

MCP 서버를 내장한 셸 히스토리 관리 및 에이전트 컨텍스트 제공 도구

Claude Code중립

터미널 기반 AI 코딩 에이전트

Cursor중립

AI 기반 코드 에디터