AI 에이전트의 장기 기억을 로컬 Markdown 파일 + SQLite 인덱스로 관리하는 런타임
중간맛 분석
Python 3.12+ 기반의 로컬 우선 에이전트 메모리 런타임입니다. BM25(FTS5)와 선택적 벡터 검색을 RRF로 융합한 랭킹 파이프라인, 링크 기반 그래프 관계, 계층적 읽기(L0 목록 → 개요 → 전문)를 제공합니다. 설치 후 mem init으로 즉시 사용 가능하며, Claude Code·Codex 훅 자동 설정(mem setup --host claude-code)을 지원합니다. MCP 서버(mem-mcp)도 내장되어 있어 MCP를 지원하는 호스트에도 연결됩니다. LongMemEval-S 벤치마크에서 메모리 없음 대비 52.9% vs 5.8%의 정확도 차이를 기록했습니다. 의존성: Python 3.12+, uv (PyPI 릴리스 없음, 소스에서 설치).
이런 레포예요
이럴 때 쓰면 좋아요
- Claude Code나 Codex CLI 같은 AI 코딩 에이전트가 세션 간 학습 내용을 기억하게 하고 싶을 때
- 여러 AI 에이전트가 동일한 지식 저장소를 공유하며 협업하게 하고 싶을 때
- API 키나 외부 서비스 없이 완전히 로컬에서 에이전트 메모리를 운영하고 싶을 때
핵심 기능
대안 대비 차별점
검색 엔진의 정밀도와 파일시스템의 이식성·가독성을 하나의 저장소에 결합하며, LLM 클라이언트 없이 API 키·빌링 없이 완전 로컬로 동작하는 점이 유사 메모리 시스템(MemCore 등) 대비 차별점입니다.
먹어본 사람들
실제로 차려 먹어본 손님들의 흔적이에요 — 한마디와 완주 인증 모두 검수 후 공개돼요.
이 레포, 해먹는 법
처음 오셨어요? 어렵지 않아요 — 위에서 아래로 따라 하면 내 컴퓨터에 이 레포를 차려서 바로 맛볼 수 있어요.
준비물
- Python 3.12 이상
- uv 패키지 매니저
바로 차려먹기Python (uv)
깃밥이 레포 구조를 확인하고 만든 실행 명령이에요. 터미널에 붙여넣으면 받기부터 실행까지 한 번에 진행돼요.
git clone --depth 1 https://github.com/tigerless-labs/agent-memory.git && cd agent-memory && uv sync
uv가 없다면: brew install uv · 실행 명령은 README를 확인하세요.
코드는 내 컴퓨터에서 실행돼요 — 처음 보는 레포라면 내용을 한번 훑어보고 실행하는 습관을 추천해요.
README가 안내하는 자세한 단계 보기
- 레포지토리를 클론하고 의존성을 설치합니다.
git clone https://github.com/tigerless-labs/agent-memory.git
cd agent-memory
uv sync --all-packages
- 빌드된 CLI를 PATH에 추가합니다.
export PATH="$PWD/.venv/bin:$PATH"
- 메모리 저장소를 초기화합니다.
mem init
- 메모리를 기록하고 검색한 뒤 인덱스 재빌드를 테스트합니다.
mem record --type decision --field project=agent-memory \
--abstract "Markdown files are the single source of truth" \
--body "Indexes are rebuildable caches."
mem --json recall "source of truth"
rm -rf ~/agent-memory-store/.index && mem rebuild
- 에이전트 호스트에 훅을 자동 연결합니다.
mem setup --host claude-code
깃밥트라이로 맛보기
받아보기 귀찮고 살짝 불안했다면 — 안전 스캔부터 설치까지 터미널 한 줄로 끝나요.
터미널에 붙여넣으면 깃밥 안전 스캔 → 격리 폴더 clone → 설치 → 실행법 안내까지 자동이에요. 처음이어도 괜찮아요 — 이 한 줄이 전부예요.
npx gitbap-try tigerless-labs/agent-memory
Node.js만 있으면 설치 없이 실행돼요 · 깃밥트라이가 뭐예요? →
별 추이 · 7일
활용성 · 따라 만들기 좋은가
- 관대한 라이선스
- 테스트 있음
- 예제 디렉토리
- 최근 활동
- AGENTS.md
- llms.txt
- 템플릿
🟢 최근 활동 있음 · 2026년 생성
「LLM 도구·RAG」 이런 레포, 매주 받아보실래요?
매주 월요일 아침, 골라 담은 밥상만. 광고 없이 · 언제든 해지.
내 레포인가요? README에 깃밥 배지 달기
[](https://www.gitbap.com/r/tigerless-labs/agent-memory)🔌 클로드에서 바로 써보기 — 깃밥 연결하는 법
깃밥을 클로드에 연결하면 이런 레포를 클로드·커서·Codex에서 바로 찾고 체험할 수 있어요.
클로드 설정 → 커넥터에 이 주소를 붙여넣기.
https://www.gitbap.com/api/mcp플러그인을 설치하면 /gitbap-trending·/gitbap-try 슬래시 커맨드로 레포를 그 자리에서 체험. Claude Code에서 아래 두 줄을 차례로 실행하세요.
/plugin marketplace add jakeparkcolde/gitbap-cowork/plugin install gitbap-cowork@gitbapAI가 README 기반으로 요약했습니다 · 원문 보기