AI 코딩 에이전트를 위한 로컬 우선 영구 메모리로, 결정과 교훈을 SQLite에 저장하고 MCP를 통해 Claude Code, Cursor 및 다른 클라이언트에 제공합니다.
kitfunso/hippo-memory
코딩 에이전트를 위한 장기 메모리로, 로컬 SQLite 데이터베이스에 메모리를 저장하고 Claude Code, Codex, Cursor 및 기타 MCP 클라이언트에서 공유합니다.
- 스타
- 784
- 포크
- 46
- 열린 이슈
- 29
- 마지막 커밋
- 5시간 전
어떤 프로젝트인가요?
Hippo는 코딩 에이전트에 세션과 도구가 바뀌어도 유지되는 영구 메모리를 제공합니다. 메모리는 사용자의 컴퓨터에 있는 SQLite 저장소에 보관되며, Git에 커밋할 수 있는 Markdown 미러도 함께 생성됩니다. 기본 회상 방식은 BM25 키워드 검색으로, 모델을 다운로드하거나 네트워크를 호출하지 않습니다. 임베딩은 선택적으로 설치할 수 있습니다.
모든 내용을 저장해 두었다가 나중에 검색하는 시스템과 달리, Hippo는 시간이 지남에 따라 메모리 강도를 조정합니다. 메모리는 설정 가능한 반감기에 따라 약해지고, 다시 회상한 메모리는 강화됩니다. 오류 메모리는 더 천천히 약해지며, 결과를 긍정 또는 부정으로 표시하면 메모리 순위가 올라가거나 내려갑니다. `hippo sleep`을 실행하면 관련 에피소드를 통합해 하나의 메모리로 합치고 중복 항목을 제거합니다.
`hippo init`은 Claude Code와 OpenCode용 훅을 설치하고, Codex가 설치되어 있으면 훅 항목을 추가하며, AGENTS.md 또는 CLAUDE.md에 안내문을 추가합니다. 모든 MCP 클라이언트에서 연결할 수 있습니다. 또한 ChatGPT 내보내기 파일, CLAUDE.md, .cursorrules, Markdown에서 가져올 수 있으며, HTTP API를 통해 Slack 및 GitHub 이벤트를 수집할 수도 있습니다.
핵심 기능
- 01Git에 커밋할 수 있는 Markdown 미러를 포함한 로컬 SQLite 저장소
- 02모델이나 네트워크 호출 없이 기본으로 제공되는 BM25 검색
- 03메모리 감쇠, 회상 시 강화, 순위 산정을 위한 결과 피드백
- 04Claude Code 및 OpenCode용 훅과 Codex 및 AGENTS.md 통합
- 05호환되는 모든 클라이언트에서 사용할 수 있는 MCP 서버 및 HTTP API
- 06ChatGPT 내보내기 파일, CLAUDE.md, Cursor 규칙 및 Markdown에서 가져오기
활용 사례
- Claude Code, Cursor, Codex를 오가며 작업할 때 과거 버그에서 얻은 교훈을 활용하기
- 검토 가능하고 Git으로 추적할 수 있는 형태로 프로젝트 규칙과 결정 사항을 저장하기
- 호스팅 서비스 대신 자체 컴퓨터에 독점 프로젝트 메모리를 보관하기
- 기존 CLAUDE.md 또는 Cursor 규칙을 공유 저장소로 가져오기
빠른 시작
- 1
npm으로 패키지를 전역 설치합니다
npm install -g hippo-memory - 2
프로젝트에서 init을 실행해 스토어를 만들고 에이전트를 연결합니다
hippo init
사용 전 알아둘 점
- 모든 에이전트에서 자동 캡처를 사용하려면 추가 설정과 호스트 신뢰 설정이 필요합니다. 예를 들어 /hooks에서 Codex hooks를 신뢰해야 합니다.
- ANTHROPIC_API_KEY가 설정되어 있으면 Sleep은 사실 추출을 위해 메모리 텍스트를 Anthropic에 전송합니다. config에서 추출을 비활성화할 수 있습니다.
- Embeddings는 선택 사항이며 별도로 설치해야 합니다. 검색은 기본적으로 BM25를 사용합니다.
- Node.js 22.16 이상이 필요합니다.
토픽
자주 묻는 질문
- hippo-memory은(는) 무엇인가요?
- 코딩 에이전트를 위한 장기 메모리로, 로컬 SQLite 데이터베이스에 메모리를 저장하고 Claude Code, Codex, Cursor 및 기타 MCP 클라이언트에서 공유합니다. Hippo는 코딩 에이전트에 세션과 도구가 바뀌어도 유지되는 영구 메모리를 제공합니다. 메모리는 사용자의 컴퓨터에 있는 SQLite 저장소에 보관되며, Git에 커밋할 수 있는 Markdown 미러도 함께 생성됩니다. 기본 회상 방식은 BM25 키워드 검색으로, 모델을 다운로드하거나 네트워크를 호출하지 않습니다. 임베딩은 선택적으로 설치할 수 있습니다.
- hippo-memory은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- hippo-memory은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- hippo-memory은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. hippo-memory의 마지막 커밋은 2026년 10월 22일입니다.
- hippo-memory은(는) 어디에 사용할 수 있나요?
- Claude Code, Cursor, Codex를 오가며 작업할 때 과거 버그에서 얻은 교훈을 활용하기 검토 가능하고 Git으로 추적할 수 있는 형태로 프로젝트 규칙과 결정 사항을 저장하기 호스팅 서비스 대신 자체 컴퓨터에 독점 프로젝트 메모리를 보관하기 기존 CLAUDE.md 또는 Cursor 규칙을 공유 저장소로 가져오기
- hippo-memory는 어떻게 설치하나요?
- npm으로 패키지를 전역 설치합니다: npm install -g hippo-memory 프로젝트에서 init을 실행해 스토어를 만들고 에이전트를 연결합니다: hippo init
- hippo-memory은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/kitfunso/hippo-memory
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
Claude Code, Codex, Cursor 같은 코딩 에이전트가 MCP를 통해 같은 메모리를 읽고 쓸 수 있도록 하는 로컬 우선 공유 프로젝트 메모리 계층입니다.
코딩 에이전트의 세션 활동을 기록하고 AI로 압축한 뒤, 이후 세션에 관련 컨텍스트를 제공하는 지속성 메모리입니다.
모든 대화 원문을 요약 없이 보관하고 시간순으로 색인하는, 개인용 AI를 위한 로컬 파일 기반 장기 메모리입니다.
Claude와 Codex 세션 기록을 로컬에서 검색하는 도구로, Rust 검색 코어와 JSON CLI, 데스크톱 앱을 제공합니다.
클라이언트, 모델, 에이전트 인터페이스를 넘나들며 AI 정체성에 지속성을 제공하는 셀프 호스팅 장기 메모리 서비스입니다.