Repolode
kitfunso

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. 1

    npm으로 패키지를 전역 설치합니다

    npm install -g hippo-memory
  2. 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 통계는 매일 갱신됩니다.

관련 프로젝트