Agent Memory System
RAVBYTE TECHNOLOGIES PRIVATE LIMITED · 코딩
Agent Memory System은 워크스페이스의 모든 리포지토리에 프로젝트 맥락, 실행 이력, 인계 기록을 담은 영구적이고 읽기 쉬운 기록을 부여하는 오픈소스 메모리 계층이다. 명령 하나를 실행하면 폴더를 훑어 매니페스트, 라우트, API, 설정, 테스트를 찾아내고, Codex, Claude, Cursor 등 코딩 에이전트가 읽을 수 있는 Markdown과 JSON 인덱스를 작성한다. 세션이 끝날 때마다 새 어시스턴트에게 코드베이스를 다시 설명하는 데 지친 개발자를 위한 도구다. 익숙한가?
Agent Memory System 소개
Agent Memory System이란 무엇인가
Agent Memory System(AMS)은 AI 코딩 에이전트를 위한 맥락 인프라다. 에이전트가 매 세션마다 프로젝트를 처음부터 다시 파악하게 두는 대신, 워크스페이스를 한 번 매핑하고 그 지도를 에이전트가 이미 여는 법을 아는 파일에 보관한다. 유지되는 버전은 npm에 @ravbyte/agent-memory-system으로 올라가 있으며 RAVBYTE TECHNOLOGIES PRIVATE LIMITED가 소유한다.
이 도구가 해결하는 문제는 연속성이다. 하나의 리포지토리가 여러 폴더에 걸쳐 있는 일이 흔하고, 워크스페이스 하나에 여러 리포지토리가 함께 있을 수도 있다. Antigravity, Codex, Claude, Cursor 사이를 오갈 때면 직전 어시스턴트가 이해한 내용을 보통 잃는다. AMS는 그 이해를 기록한다. 다음 에이전트는 백지가 아니라 정보를 갖춘 상태로 시작한다.
가장 큰 한계는 이것이 CLI 도구이지 호스팅 서비스가 아니라는 점이다. 대시보드도 계정도 없다. 그래서 설정은 터미널에서 하고, 관리는 코드가 바뀔 때 유지 명령을 돌리는지에 달려 있다. 설치가 npx를 거치므로 Node.js도 필요하다.
시작하기
- 매핑하려는 워크스페이스에서 터미널을 열고
npx @ravbyte/agent-memory-system@latest init을 실행한다. - 스캐너가 폴더를 훑도록 둔다. 매니페스트, 라우트, API, 설정, 테스트, 스토리지 단서, 생성된 디렉터리를 감지한다.
- 생성된
memory/폴더를 살펴본다. 맥락 인덱스와 지침 및 작업 로그용 Markdown 파일이 들어 있다. agent-memory worklog handoff --agent codex --message "tests pass; next publish pages"로 다음 에이전트에 작업을 넘긴다.- Git의 구조적 변경 뒤에는
agent-memory maintain --since main을 실행해 메모리를 최신으로 유지한다.
제품 정보
Agent Memory System의 요금, 지원 플랫폼, 성능을 한눈에 확인해 보세요.
추천 대상
이 도구가 가장 잘 맞는 사용자, 작업, 상황입니다.
사용자
- 여러 부업 프로젝트를 동시에 다루는 1인 개발자
- 사람과 어시스턴트 사이에서 작업을 인계하는 팀
- 여러 코딩 에이전트를 시험하는 엔지니어
작업
- 새 AI 에이전트를 큰 코드베이스에 합류시키기
- 리팩터링 뒤 무엇이 바뀌었는지 추적하기
- API 변경의 영향 범위 찾기
활용 상황
- 2주 쉬었다가 프로젝트를 다시 시작하기
- 반쯤 끝난 작업을 밤새 다른 에이전트에 넘기기
- 보안을 신경 쓰는 리포지토리 운영하기
주요 기능
리포지토리 스캔
명령 하나로 워크스페이스의 모든 리포지토리를 매핑한다. 스캐너는 매니페스트, 라우트, API, 설정, 테스트, 스토리지 단서, 문서를 읽고 Markdown과 JSON 주제 인덱스를 작성한다. 출력은 일반 텍스트라서 파일에 접근할 수 있는 에이전트라면 플러그인 없이 쓸 수 있다.
Git을 인식하는 자동 유지
코드가 움직이면 메모리는 어긋난다. AMS는 이를 막으려 한다. agent-memory maintain --since main을 실행하면 Git의 구조적 변경을 감지하고, 메모리 폴더를 갱신하고, 결과를 검증한다. 요점은 오래된 맥락이 코드 리뷰에 조용히 섞여 드는 것을 막는 것이다. 그렇지 않으면 의미가 없다.
에이전트 간 인계
worklog 명령은 한 에이전트가 다음 에이전트에게 메모를 남기게 한다. 받는 이를 표시하고 짧은 메시지를 넘기면, 도구가 인계 파일을 작성하고 다음 어시스턴트가 시작할 때 그것을 읽는다. Claude 맥락과 Cursor 에이전트 메모리 모두 이렇게 지속된다. 에이전트를 바꾸는 일이 처음부터 다시 하는 것처럼 느껴지지 않는다.
의존성 그래프 인텔리전스
내장 정적 분석이 의존성과 아키텍처 계층을 매핑한다. 에이전트는 그래프에 질의해 API가 바뀌면 어떤 파일이 깨지는지 알아낸다. 추측 게임이 조회로 바뀐다. 이 프로젝트는 O(1) 그래프 질의와 누락 임포트 제로를 내세운다. 큰 리포지토리에서 유용하다.
비밀을 인식하는 메모리
메모리 파일은 시스템을 설명해야지 자격 증명을 노출해서는 안 된다. AMS는 환경 변수의 이름을 기록하고, 뚜렷한 비밀 패턴을 차단하며, 생성된 디렉터리와 벤더 디렉터리를 피하고, 추론한 내용에 표시를 달아 에이전트가 무엇을 추측했고 무엇을 확인했는지 알게 한다. 커밋하기 전에 폴더를 검토하자.
개방형 벤치마크 도구
오픈소스 벤치마크 도구가 에이전트의 콜드 스타트 흐름과 AMS가 이끄는 실행을 리포지토리 이해, 디버깅, 복구, 다중 에이전트 연속성 면에서 비교한다. 유지 관리자들 스스로 현재 수치는 자신들의 측정이며 독립적 재현이 아직 필요하다고 밝힌다. 인용하기 전에 알아 두면 좋다.
장단점
장점
- 무료에 MIT 라이선스라 저울질할 요금 등급이 없고 소스를 읽을 수 있다.
- 메모리가 일반 Markdown과 JSON으로 존재하므로 이식 가능하고 Codex, Claude, Cursor, Antigravity에서 작동한다.
- Git을 인식하는 유지가 몇 달 전 스냅샷이 아니라 코드의 실제 상태에 인덱스를 가깝게 둔다.
- 보안 기본값이 뚜렷한 비밀을 차단하고 벤더 경로를 건너뛴다. 공유 리포지토리에서 중요한 부분이다.
단점
- 호스팅 서비스도 대시보드도 없으므로 유지는 기억해서 실행해야 하는 명령이다.
- 벤치마크 결과는 유지 관리자가 돌린 것이고 아직 독립적으로 검증되지 않았으니 성능 주장은 잠정적으로 받아들이자.
- Node.js를 갖춰야 한다. 순수하게 Python이나 Go 환경에서 일하는 팀에는 단계가 하나 늘어난다.
자주 묻는 질문
리포지토리를 스캔해 영구적인 Markdown과 JSON 인덱스로 바꾸고, AI 코딩 에이전트에게 프로젝트 맥락, 이력, 인계의 공유 기록을 제공한다. 매 세션 코드를 다시 파악하는 대신 에이전트가 읽어 들이는 노트라고 보면 된다.
관련 콘텐츠
Agent Memory System와 관련된 도구, 스킬, 아티클을 살펴보세요.
Agent Memory System 대안
Forefront
Forefront · 코딩Forefront는 오픈소스 AI로 무언가를 만드는 웹 플랫폼이다. 대표적인 오픈소스 언어 모델을 자신의 데이터로 미세 조정하고, 성능을 평가하고, API로 실행하거나 내보내 직접 호스팅할 수 있다. 폐쇄형 플랫폼의 편의를 원하면서도 모델과 데이터의 소유권은 놓지 않으려는 개발자가 대상이다.
Startkit
StartKit.AI · 코딩Startkit은 AI SaaS와 AI 래퍼 제품을 만들기 위한 보일러플레이트다. 지루한 부분을 미리 연결해 둔 AI 스타트업 보일러플레이트라고 생각하면 된다. 인증, Stripe와 Lemon Squeezy 결제, 사용량 제한, 트랜잭션 이메일, 그리고 OpenAI, Anthropic, Groq, Llama와 통신하는 AI API 스타터 키트가 포함된다. 저장소를 복제하고 가격을 정한 뒤 사용자가 실제로 돈을 내는 부분에 착수하면 된다. React와 Tailwind 위의 Next.js로 만들어졌기 때문에 보일러플레이트 코드의 상당 부분이 이미 익숙하게 느껴진다.
Testim
Tricentis · 코딩Testim은 웹, 모바일, Salesforce 애플리케이션 전반에 걸쳐 엔드투엔드 테스트를 만들고 실행하는 AI 기반 테스트 자동화 플랫폼이다. 머신러닝에 기대어 인터페이스가 바뀌어도 테스트를 안정적으로 유지하므로, 팀은 깨진 셀렉터를 고치는 데 쓰는 시간을 줄인다. 오늘부터 쓸 수 있는 자동화 테스트 도구치고 나쁘지 않다. 브라우저에서 동작을 녹화해 테스트를 만들고, 더 세밀한 제어가 필요하면 JavaScript를 더한다. 바쁜 QA 팀에게 탄탄한 선택이다.