Communitygithub.com

VRIL-LABS/portable-agent-memory

🧠 고급 이식형 에이전트 메모리 시스템으로, 모든 에이전트에서 사용할 수 있도록 조정되어 개발자가 코드 품질을 향상시킬 수 있습니다. 보조 또는 독립형 메모리 시스템으로 사용할 수 있습니다.

portable-agent-memory란 무엇인가요?

Portable Agent Memory는 에이전트가 프로젝트별 메모리를 파일 기반으로 영속화할 수 있는 이식형 메모리 시스템입니다. `<project_root>/memories/` 디렉토리에 마크다운 파일로 메모리를 저장하며, `scripts/memory <cmd>` 명령어를 통해 조작합니다. JSON 형식의 stdout을 제공하며, `read` 명령으로 디스크 상태를 확인할 수 있습니다. v1.1.0부터는 SQLite + FTS5 기반의 `<project_root>/.memsys-db` 인덱스를 추가하여 검색 기능을 제공하지만, 마크다운 파일이 여전히 진실 공급원(source of truth)입니다. Claude Code, Cursor, Codex 등 다양한 에이전트 플랫폼에서 보조 메모리 시스템으로 사용할 수 있으며, 기존 메모리 메커니즘을 대체하지 않고 추가 레이어로 동작합니다. 복잡한 워크플로우(ingest → retrieve → reason → reflect → execute → package)를 지원하며, 보안 스캔, 200줄 제한, 메모리 디렉토리 외부 쓰기 금지 등의 하드 규칙이 적용되어 있습니다.

지원 대상✓Claude Code~Codex CLI✓Cursor✓Gemini CLI✓Windsurf
npx skills add VRIL-LABS/portable-agent-memory

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

메모리 시스템

이 스킬은 <project_root>/memories/에 프로젝트-로컬 메모리를 위한 영속성 계층을 제공하며, scripts/memory <cmd>를 통해 접근합니다(이 계층의 결정적 진실 공급원인 references/memory_tool에 의해 뒷받침됩니다 — 절대 그 출력을 수정하거나 재구현하지 마십시오). 호스트에 다른 메모리 메커니즘이 없다고 가정하지 않습니다. 만약 존재한다면, 이 레이어를 그 옆에 추가적인 파일 기반 레이어로 취급하십시오. stdout은 JSON입니다. 디스크 상태를 확인하려면 read를 다시 사용하십시오.

1.1.0부터 init은 숨겨진 <project_root>/.memsys-db(SQLite + FTS5, journal_mode=DELETE, 단일 파일, -wal/-shm 없음)를 생성합니다 — 재생성 가능한 인덱스 및 검색 계층입니다. 마크다운이 진실 공급원으로 남습니다.

여기서부터 순서대로 시작하십시오:

  1. references/protocol.md — 전체 수집 → 검색 → 추론 → 반영 → 실행 → 패키징 워크플로우와 명령어 및 빠른 시작 호출.
  2. references/layout.md — 저장소 레이아웃과 특정 질의에 대해 로드할 내용.
  3. references/when-to-save.md — 분류: 스킬 대 인덱스 대 주제 대 거부, 스킬-메모리 라우팅.
  4. references/constitution.md — 하드 규칙(비밀 스캔 절대 건너뛰지 않음, 200줄 초과 금지, memories/ 외부 쓰기 금지, bash를 통한 열거 금지, 원장 WAL 금지).
  5. references/memsys-db.md — .memsys-db 원장 계약: 스키마, search/reindex/forget, DB가 마크다운보다 우선하지 않는 이유.
  6. references/examples.md — 작업 예제: 정상 경로, 비밀 거부, 덮어쓰기 복구.

첫 사용 전에 scripts/memory selftest로 설치를 확인하십시오.

관련 스킬