Repolode
rohitg00

rohitg00/agentmemory

Claude Code, Cursor, Codex 및 기타 MCP 클라이언트에서 세션을 자동으로 기록하고 이후 세션에 관련 맥락을 주입하는 AI 코딩 에이전트용 영구 메모리입니다.

스타
29,683
포크
2,621
열린 이슈
582
마지막 커밋
15시간 전

어떤 프로젝트인가요?

agentmemory는 AI 코딩 에이전트를 위한 메모리 서버입니다. 세션 중 에이전트가 수행한 작업을 조용히 기록하고, 관찰 내용을 검색 가능한 메모리로 압축한 뒤 다음 세션이 시작될 때 관련 맥락을 제공합니다. 따라서 개발자는 매번 아키텍처, 과거 버그, 선호 사항을 다시 설명할 필요가 없습니다.

iii 엔진과 SQLite를 기반으로 로컬에서 실행되며 외부 데이터베이스가 필요하지 않습니다. 검색에는 BM25 키워드 검색, 선택 사항인 로컬 벡터 임베딩(all-MiniLM-L6-v2), 그래프 매칭을 결합합니다. 임베딩 제공자가 없어도 BM25를 사용해 키 없이 실행할 수 있습니다. MCP 도구 54개와 3111 포트의 REST API를 제공하며, 세션 재생 기능을 갖춘 3113 포트의 실시간 뷰어도 포함합니다.

Claude Code, Codex CLI, GitHub Copilot CLI, Cursor, Gemini CLI, OpenClaw, Hermes, OpenCode, Devin 및 그 밖의 다양한 MCP 호환 클라이언트를 지원하며, 모두 하나의 메모리 서버를 공유합니다.

핵심 기능

  • 01라이프사이클 훅을 통해 에이전트 활동을 자동으로 기록하므로 직접 저장할 필요가 없습니다.
  • 02BM25, 선택 사항인 로컬 벡터 임베딩, 그래프 매칭을 결합한 하이브리드 검색을 지원합니다.
  • 03모든 MCP 호환 클라이언트에서 사용할 수 있도록 MCP 도구 54개와 REST API를 제공합니다.
  • 04외부 데이터베이스 없이 SQLite와 iii 엔진을 사용해 로컬에서 실행됩니다.
  • 05세션 재생과 JSONL 트랜스크립트 가져오기를 지원하는 실시간 뷰어를 제공합니다.

활용 사례

  • Claude Code나 Cursor로 며칠에 걸쳐 작업할 때 프로젝트 아키텍처와 이전 결정 사항을 계속 활용합니다.
  • 같은 코드베이스에서 사용하는 여러 코딩 에이전트가 메모리 저장소 하나를 공유합니다.
  • 프롬프트에 메모를 복사하지 않고도 이전에 수정한 버그와 팀의 선호 사항을 떠올립니다.
  • 이전 세션에서 에이전트가 수행한 작업을 재생하고 검토합니다.

빠른 시작

  1. 1

    대화형 설정을 실행하고 메모리 서버를 시작합니다

    npx -y @agentmemory/agentmemory@latest
  2. 2

    샘플 세션을 등록하고 회상을 테스트합니다

    npx -y @agentmemory/agentmemory@latest demo
  3. 3

    에이전트용 네이티브 스킬 17개를 설치합니다

    npx skills add rohitg00/agentmemory -y

사용 전 알아둘 점

  • Windows 네이티브 환경에서는 고정 버전인 iii-engine v0.22.1을 수동으로 설치해야 합니다. WSL2 또는 Docker Desktop을 사용하는 편이 더 쉽습니다.
  • 키리스 모드에서는 벡터 임베딩이 비활성화되며, 로컬 또는 다른 임베딩 공급자를 설정하지 않으면 회상에 BM25를 사용합니다.
  • macOS/Linux에서 iii-engine을 자동 설치하려면 curl, sh, tar가 필요합니다. 최소 구성 이미지에는 해당 도구가 없을 수 있습니다.
  • iii-engine v0.22.1로 고정되어 있으며, 다른 버전의 iii engine을 직접 설치한 경우에는 작동하지 않습니다.

토픽

자주 묻는 질문

agentmemory은(는) 무엇인가요?
Claude Code, Cursor, Codex 및 기타 MCP 클라이언트에서 세션을 자동으로 기록하고 이후 세션에 관련 맥락을 주입하는 AI 코딩 에이전트용 영구 메모리입니다. agentmemory는 AI 코딩 에이전트를 위한 메모리 서버입니다. 세션 중 에이전트가 수행한 작업을 조용히 기록하고, 관찰 내용을 검색 가능한 메모리로 압축한 뒤 다음 세션이 시작될 때 관련 맥락을 제공합니다. 따라서 개발자는 매번 아키텍처, 과거 버그, 선호 사항을 다시 설명할 필요가 없습니다.
agentmemory은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
agentmemory은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
agentmemory은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. agentmemory의 마지막 커밋은 2026년 10월 19일입니다.
agentmemory은(는) 어디에 사용할 수 있나요?
Claude Code나 Cursor로 며칠에 걸쳐 작업할 때 프로젝트 아키텍처와 이전 결정 사항을 계속 활용합니다. 같은 코드베이스에서 사용하는 여러 코딩 에이전트가 메모리 저장소 하나를 공유합니다. 프롬프트에 메모를 복사하지 않고도 이전에 수정한 버그와 팀의 선호 사항을 떠올립니다. 이전 세션에서 에이전트가 수행한 작업을 재생하고 검토합니다.
agentmemory는 어떻게 설치하나요?
대화형 설정을 실행하고 메모리 서버를 시작합니다: npx -y @agentmemory/agentmemory@latest 샘플 세션을 등록하고 회상을 테스트합니다: npx -y @agentmemory/agentmemory@latest demo 에이전트용 네이티브 스킬 17개를 설치합니다: npx skills add rohitg00/agentmemory -y
agentmemory은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/rohitg00/agentmemory

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트