에이전트의 행동을 개선하는 로컬 우선 메모리 시스템 'Solitaire' 공개

실용적 조언

pip install solitaire-ai 명령어를 통해 즉시 설치하여 로컬 에이전트 메모리 시스템을 구축할 수 있다.
Claude Code나 Gemini CLI 사용 시 MCP 레지스트리를 통해 Solitaire를 통합하여 메모리 기능을 확장할 수 있다.

섹션별 상세

Solitaire는 기존 메모리 도구가 정보를 단순히 불러오는 '노트북' 역할에 머물러 있다는 점을 해결하기 위해 설계됐다. 600회 이상의 실제 세션과 15,700개 이상의 항목을 처리하며 에이전트가 사용자와의 상호작용을 통해 페르소나와 행동 정체성을 컴파일하도록 구현했다. 모든 데이터는 SQLite와 JSONL 형식으로 로컬 워크스페이스에 저장되며 외부 API 호출이나 텔레메트리 전송을 완전히 차단하여 데이터 주권을 보장한다. 이를 통해 에이전트는 시간이 흐를수록 사용자의 의도를 더 잘 이해하는 협력자로 기능한다.

시스템의 기술적 핵심은 자가 수정 지식 그래프와 계층적 부팅 컨텍스트 구조에 있다. 지식 그래프는 정보 간의 모순을 감지하고 엔티티를 다시 연결하며 신뢰도를 재계산하여 기억의 무결성을 유지한다. 에이전트가 실행될 때 백지상태가 아닌 이전 세션의 핵심 맥락과 '세션 잔여물'을 바탕으로 브리핑된 상태로 시작하게 하여 연속성 있는 업무 수행을 지원한다. 검색 가중치는 실제 유용했던 정보를 기반으로 동적으로 조정되며 Claude Code, Gemini CLI 등 다양한 도구와의 호환성을 확보했다.

용어 해설

로컬 우선 방식(Local-first): — 데이터 저장과 처리를 클라우드가 아닌 사용자의 로컬 기기에서 우선적으로 수행하는 설계 원칙이다. SQLite와 JSONL을 사용하여 외부 네트워크 요청 없이 작동하며, 데이터 주권과 보안을 보장하는 데 핵심적인 역할을 한다.
지식 그래프(Knowledge Graph): — 개체 간의 관계를 네트워크 형태로 구조화하여 저장하는 기술이다. 에이전트가 단순 검색을 넘어 정보 사이의 맥락과 모순을 감지하고, 엔티티를 재연결하여 기억의 정확성을 스스로 수정하는 메커니즘을 제공한다.
JSON 라인(JSONL): — 각 줄이 하나의 독립적인 JSON 객체로 구성된 텍스트 파일 형식이다. 대규모 데이터셋을 한 줄씩 읽고 쓸 수 있어 메모리 효율적이며, 에이전트의 세션 로그나 기억 항목을 순차적으로 기록하고 백업하는 데 유리하다.
페르소나 컴파일(Persona Compilation): — 정적인 설정 파일 대신 사용자와의 실제 상호작용 데이터를 분석하여 에이전트의 정체성과 행동 양식을 동적으로 구축하는 과정이다. 시간이 지남에 따라 에이전트가 사용자의 선호도에 맞춰 진화하도록 돕는다.

언급된 도구

Solitaire추천링크

에이전트 행동 개선 및 로컬 메모리 관리

Claude Code중립

에이전트 통합 및 실행 환경

MCP Registry추천

에이전트 도구 및 컨텍스트 프로토콜 등록

언급된 리소스

GitHubSolitaire-for-Agents GitHub Repository