← 보드로 돌아가기

rohitg00/agentmemory

#1 Persistent memory for AI coding agents based on real-world benchmarks

GitHub에서 열기 ↗ agentmemoryagentsaiclaudeclaudecodecodexcopilotcursorgenaiharnesshermesmemoryopenclaw
24,925
GitHub 스타
2,057
포크
TypeScript
언어
Apache-2.0
라이선스
2026.07.06
최근 푸시
2026.05.12
별표한 날

AI 분석

설치 난이도: 보통
큐레이터 노트
AI 코딩 에이전트의 지속적 메모리 문제를 해결하는 실용적인 도구로, 특히 여러 에이전트를 사용하는 개발자에게 유용합니다. 성능 벤치마크와 다양한 통합 옵션이 신뢰성을 높여주므로 채택을 고려할 만합니다.

강점

  • 벤치마크 기반 95.2% 검색 정확도(R@5)와 92% 토큰 절감 효과를 입증하여 성능이 검증됨.
  • 외부 데이터베이스 의존성이 없어(0 external DBs) 설치와 유지보수가 간편함.
  • Claude Code, Copilot CLI, Cursor 등 15개 이상의 주요 AI 코딩 에이전트와 호환되어 범용성이 높음.
  • 53개의 MCP 도구와 12개의 자동 후크를 제공하여 에이전트와의 통합이 풍부함.
  • 1,423개 이상의 테스트를 통과하여 안정성이 높음.

약점

  • Windows 네이티브 지원이 제한적이며(WSL2 권장, agentmemory connect 미지원) 일부 사용자에게 불편을 초래할 수 있음.
  • npm 전역 설치 시 macOS/Linux에서 EACCES 권한 문제가 발생할 수 있어 추가 조치가 필요함.
  • README가 매우 길고 상세하여 초보자가 필요한 정보를 빠르게 찾기 어려울 수 있음.

주의사항

  • npx 캐싱 문제로 인해 최신 버전이 아닌 이전 버전이 실행될 수 있으므로 주의해야 함.
  • Windows에서 네이티브 엔진 설정은 수동이며 시간이 소요되므로 WSL2 사용을 권장함.
  • 설치 후 agentmemory connect 명령이 모든 에이전트에서 즉시 작동하지 않을 수 있으므로 문서를 확인해야 함.

시작 가이드

  • npm을 통해 @agentmemory/agentmemory를 전역 설치하고 메모리 서버를 시작합니다.
  • agentmemory connect 명령으로 사용 중인 코딩 에이전트(예: Claude Code)와 연결합니다.
  • agentmemory demo를 실행하여 기본 기능을 테스트하고 샘플 데이터를 확인합니다.
  • npx skills add로 네이티브 스킬을 설치하여 에이전트가 메모리 도구를 인식하도록 설정합니다.
  • Windows 사용자라면 WSL2 환경에서 설치하는 것을 권장합니다.

README 한국어 번역

이 번역은 AI가 원문 README를 옮긴 것입니다. 원문이 항상 우선합니다.

<p align="center"> <img src="assets/banner.png" alt="agentmemory — AI 코딩 에이전트를 위한 영구 메모리" width="720" /> </p>

<p align="center"> <strong> 당신의 코딩 에이전트는 모든 것을 기억합니다. 더 이상 다시 설명할 필요가 없습니다. <a href="https://github.com/iii-hq/iii">iii 엔진</a> 기반 </strong><br/> Claude Code, GitHub Copilot CLI, Cursor, Gemini CLI, Codex CLI, Hermes, OpenClaw, pi, OpenCode 및 모든 MCP 클라이언트를 위한 영구 메모리. </p>

<p align="center"> <a href="README.md">English</a> | <a href="READMEs/README.zh-CN.md">简体中文</a> | <a href="READMEs/README.zh-TW.md">繁體中文</a> | <a href="READMEs/README.ja-JP.md">日本語</a> | <a href="READMEs/README.ko-KR.md">한국어</a> | <a href="READMEs/README.es-ES.md">Español</a> | <a href="READMEs/README.tr-TR.md">Türkçe</a> | <a href="READMEs/README.ru-RU.md">Русский</a> | <a href="READMEs/README.hi-IN.md">हिन्दी</a> | <a href="READMEs/README.pt-BR.md">Português</a> | <a href="READMEs/README.fr-FR.md">Français</a> | <a href="READMEs/README.de-DE.md">Deutsch</a> </p>

<p align="center"> <a href="https://trendshift.io/repositories/25123" target="_blank"><img src="https://trendshift.io/api/badge/repositories/25123" alt="rohitg00/agentmemory | Trendshift" width="250" height="55"/></a> </p>

<p align="center"> <a href="https://www.star-history.com/?repos=rohitg00%2Fagentmemory&type=date&legend=top-left"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=rohitg00/agentmemory&type=date&theme=dark&legend=top-left" /> <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=rohitg00/agentmemory&type=date&legend=top-left" /> <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=rohitg00/agentmemory&type=date&legend=top-left" /> </picture> </a> </p>

<p align="center"> <a href="https://gist.github.com/rohitg00/2067ab416f7bbe447c1977edaaa681e2"><img src="https://img.shields.io/badge/Viral%20GitHub%20Gist-1.3k%20stars%20%2F%20182%20forks-FF6B35?style=for-the-badge&logo=github&logoColor=white&labelColor=1a1a1a" alt="Design doc: 1.3k stars / 182 forks on the gist" /></a> </p>

<p align="center"> <em>이 gist는 Karpathy의 LLM Wiki 패턴을 신뢰도 점수, 수명 주기, 지식 그래프 및 하이브리드 검색으로 확장합니다: agentmemory는 그 구현체입니다.</em> </p>

<p align="center"> <a href="https://www.npmjs.com/package/@agentmemory/agentmemory"><img src="https://img.shields.io/npm/v/@agentmemory/agentmemory?color=CB3837&label=npm&style=for-the-badge&logo=npm" alt="npm version" /></a> <a href="https://www.npmjs.com/package/@agentmemory/mcp"><img src="https://img.shields.io/npm/dm/@agentmemory/mcp?color=CB3837&label=downloads&style=for-the-badge&logo=npm" alt="npm downloads" /></a> <a href="https://github.com/rohitg00/agentmemory/actions"><img src="https://img.shields.io/github/actions/workflow/status/rohitg00/agentmemory/ci.yml?label=tests&style=for-the-badge&logo=github" alt="CI" /></a> <a href="https://github.com/rohitg00/agentmemory/blob/main/LICENSE"><img src="https://img.shields.io/github/license/rohitg00/agentmemory?color=blue&style=for-the-badge" alt="License" /></a> <a href="https://github.com/rohitg00/agentmemory/stargazers"><img src="https://img.shields.io/github/stars/rohitg00/agentmemory?style=for-the-badge&color=yellow&logo=github" alt="Stars" /></a> </p>

<p align="center"> <picture><source media="(prefers-color-scheme: dark)" srcset="assets/tags/light/stat-recall.svg"><img src="assets/tags/stat-recall.svg" alt="95.2% retrieval R@5" height="38" /></picture> <picture><source media="(prefers-color-scheme: dark)" srcset="assets/tags/light/stat-tokens.svg"><img src="assets/tags/stat-tokens.svg" alt="92% fewer tokens" height="38" /></picture> <picture><source media="(prefers-color-scheme: dark)" srcset="assets/tags/light/stat-tools.svg"><img src="assets/tags/stat-tools.svg" alt="53 MCP tools" height="38" /></picture> <picture><source media="(prefers-color-scheme: dark)" srcset="assets/tags/light/stat-hooks.svg"><img src="assets/tags/stat-hooks.svg" alt="12 auto hooks" height="38" /></picture> <picture><source media="(prefers-color-scheme: dark)" srcset="assets/tags/light/stat-deps.svg"><img src="assets/tags/stat-deps.svg" alt="0 external DBs" height="38" /></picture> <picture><source media="(prefers-color-scheme: dark)" srcset="assets/tags/light/stat-tests.svg"><img src="assets/tags/stat-tests.svg" alt="1,423+ tests passing" height="38" /></picture> </p>

<p align="center"> <img src="assets/demo.gif" alt="agentmemory demo" width="720" /> </p>

<p align="center"> <a href="#install">설치</a> &bull; <a href="#quick-start">빠른 시작</a> &bull; <a href="#benchmarks">벤치마크</a> &bull; <a href="#vs-competitors">경쟁사 대비</a> &bull; <a href="#works-with-every-agent">에이전트</a> &bull; <a href="#how-it-works">작동 방식</a> &bull; <a href="#mcp-server">MCP</a> &bull; <a href="#real-time-viewer">뷰어</a> &bull; <a href="#iii-console">iii 콘솔</a> &bull; <a href="#powered-by-iii">iii 기반</a> &bull; <a href="#configuration">설정</a> &bull; <a href="#api">API</a> </p>

설치

코딩 에이전트를 사용하는 경우 가장 빠른 방법: 다음 한 가지 지시를 에이전트에 전달하면 agentmemory를 종단 간 설치, 연결 및 검증합니다.

https://raw.githubusercontent.com/rohitg00/agentmemory/main/INSTALLFORAGENTS.md 에서 지침을 검색하여 따르세요.

Windows에서 빠른 경로는 WSL2입니다. 네이티브 Windows 엔진 설정은 수동(약 10~20분)이며 agentmemory connect는 현재 Windows에서 지원되지 않습니다. 단계별 지침은 아래 Windows 참고를 참조하세요.

npm install -g @agentmemory/agentmemory          # 한 번만 실행 — `agentmemory`를 PATH에 추가
# macOS/Linux 시스템 Node 설치에서 EACCES 오류가 발생하면 다음으로 재시도:
# sudo npm install -g @agentmemory/agentmemory
agentmemory                                      # :3111 포트에서 메모리 서버 시작
agentmemory demo                                 # 샘플 세션 시드 + 회상 증명
agentmemory demo --serve                         # 한 명령: 서버 부팅, 데모 실행, 종료 (두 번째 터미널 불필요)
agentmemory connect claude-code                  # 에이전트에 MCP 연결 (copilot-cli, codex, cursor, gemini-cli 등도 가능)
npx skills add rohitg00/agentmemory -y           # 15개의 네이티브 스킬 설치 (8개는 호출 가능, 7개는 참조) — 에이전트가 도구 사용 시점을 알게 됨

또는 npx 사용 (설치 불필요):

npx @agentmemory/agentmemory

참고 — npx는 버전별로 캐시합니다. npx @agentmemory/agentmemory가 이전 릴리스를 제공하는 경우 npx -y @agentmemory/agentmemory@latest로 최신 버전을 강제 사용하거나 rm -rf ~/.npm/npx(macOS/Linux; Windows는 %LOCALAPPDATA%\npm-cache\npx 삭제)로 캐시를 한 번 지우세요. v0.9.16 이상의 첫 번째 npx 실행은 인라인으로 전역 설치를 요청하여 이후 어디서든 agentmemory 명령을 사용할 수 있습니다.

전체 옵션은 아래 빠른 시작을 참조하세요. 에이전트별 연결은 모든 에이전트와 함께 작동을 참조하세요.

<h2 id="works-with-every-agent"><picture><source media="(prefers-color-scheme: dark)" srcset="assets/tags/light/section-agents.svg"><img src="assets/tags/section-agents.svg" alt="모든 에이전트와 함께 작동" height="32" /></picture></h2>

agentmemory는 후크, MCP 또는 REST API를 지원하는 모든 에이전트와 함께 작동합니다. 모든 에이전트는 동일한 메모리 서버를 공유합니다.

<table> <tr> <td align="center" width="12.5%"> <a href="https://claude.com/product/claude-code"><img src="https://github.com/anthropics.png?size=120" alt="Claude Code" width="48" height="48" /></a><br/> <strong>Claude Code</strong><br/> <sub>네이티브 플러그인 + 12개 후크 + MCP</sub> </td> <td align="center" width="12.5%"> <a href="https://github.com/openai/codex"><img src="https://github.com/openai.png?size=120" alt="Codex CLI" width="48" height="48" /></a><br/> <strong>Codex CLI</strong><br/> <sub>네이티브 플러그인 + 6개 후크 + MCP</sub> </td> <td align="center" width="12.5%"> <a href="https://github.com/features/copilot"><img src="https://github.githubassets.com/images/modules/site/copilot/copilot.png" alt="GitHub Copilot CLI" width="48" height="48" /></a><br/> <strong>GitHub Copilot CLI</strong><br/> <sub>MCP + 플러그인 후크/스킬</sub> </td> <td align="center" width="12.5%"> <a href="integrations/openclaw/"><img src="https://github.com/openclaw.png?size=120" alt="OpenClaw" width="48" height="48" /></a><br/> <strong>OpenClaw</strong><br/> <sub>네이티브 플러그인 + MCP</sub> </td> <td align="center" width="12.5%"> <a href="integrations/hermes/"><img src="https://github.com/NousResearch.png?size=120" alt="Hermes" width="48" height="48" /></a><br/> <strong>Hermes</strong><br/> <sub>네이티브 플러그인 + MCP</sub> </td> <td align="center" width="12.5%"> <a href="integrations/pi/"><img src="assets/agents/pi.svg" alt="pi" width="48" height="48" /></a><br/> <strong>pi</strong><br/> <sub>네이티브 플러그인 + MCP</sub> </td> <td align="center" width="12.5%"> <a href="https://github.com/tinyhumansai/openhuman"><img src="https://raw.githubusercontent.com/tinyhumansai/openhuman/main/app/src-tauri/icons/128x128.png" alt="OpenHuman" width="48" height="48" /></a><br/> <strong>OpenHuman</strong><br/> <sub>네이티브 Memory 특성 백엔드</sub> </td> <td align="center" width="12.5%"> <a href="https://cursor.com"><picture><source media="(prefers-color-scheme: dark)" srcset="https://svgl.app/library/cursordark.svg"><img src="https://svgl.app/library/cursorlight.svg" alt="Cursor" width="48" height="48" /></picture></a><br/> <strong>Cursor</strong><br/> <sub>MCP 서버</sub> </td> <td align="center" width="12.5%"> <a href="https://github.com/google-gemini/gemini-cli"><img src="https://github.com/google-gemini.png?size=120" alt="Gemini CLI" width="48" height="48" /></a><br/> <strong>Gemini CLI</strong><br/> <sub>MCP 서버</sub> </td> </tr> <tr> <td align="center" width="12.5%"> <a href="https://github.com/opencode-ai/opencode"><picture><source media="(prefers-color-scheme: dark)" srcset="https://svgl.app/library/opencode-dark.svg"><img src="https://svgl.app/library/opencode.svg" alt="OpenCode" width="48" height="48" /></picture></a><br/> <strong>OpenCode</strong><br/> <sub>22개 후크 + MCP + 플러그인</sub> </td> <td align="center" width="12.5%"> <a href="https://github.com/cline/cline"><img src="https://github.com/cline.png?size=120" alt="Cline" width="48" height="48" /></a><br/> <strong>Cline</strong><br/> <sub>MCP 서버</sub> </td> <td align="center" width="12.5%"> <a href="https://github.com/block/goose"><img src="https://github.com/block.png?size=120" alt="Goose" width="48" height="48" /></a><br/> <strong>Goose</strong><br/> <sub>MCP 서버</sub> </td> <td align="center" width="12.5%"> <a href="https://github.com/Kilo-Org/kilocode"><img src="https://github.com/Kilo-Org.png?size=120" alt="Kilo Code" width="48" height="48" /></a><br/> <strong>Kilo Code</strong><br/> <sub>MCP 서버</sub> </td> <td align="center" width="12.5%"> <a href="https://github.com/Aider-AI/aider"><img src="https://github.com/Aider-AI.png?size=120" alt="Aider" width="48" height="48" /></a><br/> <strong>Aider</strong><br/> <sub>REST API</sub> </td> <td align="center" width="12.5%"> <a href="https://claude.ai/download"><img src="https://github.com/anthropics.png?size=120" alt="Claude Desktop" width="48" height="48" /></a><br/> <strong>Claude Desktop</strong><br/> <sub>MCP 서버</sub> </td> <td align="center" width="12.5%"> <a href="https://windsurf.com"><picture><source media="(prefers-color-scheme: dark)" srcset="https://svgl.app/library/windsurf-dark.svg"><img src="https://svgl.app/library/windsurf-light.svg" alt="Windsurf" width="48" height="48" /></picture></a><br/> <strong>Windsurf</strong><br/> <sub>MCP 서버</sub> </td> <td align="center" width="12.5%"> <a href="https://github.com/RooCodeInc/Roo-Code"><img src="https://github.com/RooCodeInc.png?size=120" alt="Roo Code" width="48" height="48" /></a><br/> <strong>Roo Code</strong><br/> <sub>MCP 서버</sub> </td> </tr> </table>

[...truncated...]

원본 저장소: rohitg00/agentmemory

라이선스: Apache-2.0

게재 제외를 원하시면 삭제 요청을 보내주세요.