tigerless-labs/agent-memory

어떤 프로젝트인가요?

핵심 기능

• 01Markdown 파일을 원본 데이터로 사용하며, SQLite 인덱스는 삭제한 뒤 다시 만들 수 있습니다.
• 02로컬 BM25 검색을 지원하며, reciprocal-rank fusion을 통한 벡터 검색 결합은 선택 사항입니다.
• 03요약, 개요, 전체 파일, 인용된 원본 메시지 순으로 단계적으로 읽을 수 있습니다.
• 04세션 경계에서 자동으로 메모리를 저장하며, 삭제 항목은 확인을 거치는 세션 종료 후 통합 기능을 제공합니다.
• 05Claude Code, Codex CLI, Muse Code가 저장소를 공유하며, MCP 서버 옵션도 제공합니다.
• 06대체된 메모리를 기록에 보존하면서 특정 시점 기준으로 검색할 수 있습니다.

활용 사례

• 서로 다른 세션에서도 코딩 에이전트가 프로젝트의 주요 결정을 기억하게 하기.
• 같은 머신에서 여러 에이전트 호스트가 메모리 저장소 하나를 공유하게 하기.
• 에이전트 도구와 분리해도 사용할 수 있고 grep으로 검색하거나 Git으로 버전 관리할 수 있는 파일에 메모리를 보관하기.
• 선택적 CJK 토크나이저를 사용해 에이전트 메모리에 중국어 검색 기능을 추가하기.

빠른 시작

1. 1

   저장소를 클론합니다

   git clone https://github.com/tigerless-labs/agent-memory.git
2. 2

   uv로 체크아웃한 소스에서 종속성을 설치합니다

   uv sync --all-packages
3. 3

   메모리 저장소를 초기화합니다

   mem init
4. 4

   Claude Code에 연결합니다

   mem setup --host claude-code

사용 전 알아둘 점

• !아직 PyPI 릴리스가 없어 설치하려면 소스 체크아웃이 필요합니다.
• !Python 3.12 이상과 uv가 필요합니다.
• !버전 0.1.0은 초기 단계이므로 Codex CLI 설정 시 추가 샌드박스 또는 신뢰 승인이 필요할 수 있습니다.

포함된 컬렉션

토픽

자주 묻는 질문

agent-memory은(는) 무엇인가요?

AI 에이전트를 위한 장기 메모리 런타임입니다. 메모리를 일반 Markdown 파일로 저장하고 로컬에서 관련도를 평가하며, Claude Code, Codex CLI 등 셸을 사용할 수 있는 여러 에이전트가 하나의 저장소를 공유합니다. agent-memory를 사용하면 AI 에이전트가 세션이 끝난 뒤에도 유지되는 메모리를 사용할 수 있습니다. 메모리는 하나의 디렉터리에 Markdown 파일로 저장되고, 옆에 있는 SQLite 인덱스는 다시 만들 수 있는 캐시이므로 인덱스를 삭제해도 지식은 사라지지 않습니다. Claude Code, Codex CLI, Muse Code를 비롯해 셸 명령을 실행할 수 있는 도구라면 무엇이든 동일한 저장소에서 읽고 쓸 수 있습니다.

agent-memory은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

agent-memory은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

agent-memory은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. agent-memory의 마지막 커밋은 2026년 11월 6일입니다.

agent-memory은(는) 어디에 사용할 수 있나요?

서로 다른 세션에서도 코딩 에이전트가 프로젝트의 주요 결정을 기억하게 하기. 같은 머신에서 여러 에이전트 호스트가 메모리 저장소 하나를 공유하게 하기. 에이전트 도구와 분리해도 사용할 수 있고 grep으로 검색하거나 Git으로 버전 관리할 수 있는 파일에 메모리를 보관하기. 선택적 CJK 토크나이저를 사용해 에이전트 메모리에 중국어 검색 기능을 추가하기.

agent-memory는 어떻게 설치하나요?

저장소를 클론합니다: git clone https://github.com/tigerless-labs/agent-memory.git uv로 체크아웃한 소스에서 종속성을 설치합니다: uv sync --all-packages 메모리 저장소를 초기화합니다: mem init Claude Code에 연결합니다: mem setup --host claude-code

agent-memory은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/tigerless-labs/agent-memory