riponcm/projectmem

projectmem – AI 코딩 에이전트를 위한 로컬 우선 메모리

기능 – projectmem는 각 저장소에 작은 자체 포함 데이터베이스(숨겨진 .projectmem/ 폴더)를 만듭니다. AI 지원 개발자가 코드를 작업하는 동안 발생하는 문제, 시도, 결정, 메모와 같은 유형화된 이벤트를 기록합니다. 그런 다음 로컬 MCP(Multi‑Client Protocol) 서버가 17개의 도구를 공개하여 인기 있는 코딩 에이전트——Claude Desktop/Code, Cursor, Antigravity, Codex 등——이 해당 기록을 읽고 새 작업을 기록할 수 있게 합니다. 목표는 에이전트가 매 세션을 처음부터 시작하지 않도록 하고, 알려진 막다른 길을 반복하지 않으며, 토큰 사용량을 줄이는 것입니다.

주요 구성 요소

• pjm CLI – 주요 사용자 인터페이스(pjm init, pjm doctor, pjm precheck, pjm dashboard 등). 프로젝트를 등록하고, git 훅(커밋 전 경고, 커밋 후 분류, 병합 후 추적)을 설치하고, MCP 서버를 시작하고, 시각적 대시보드를 생성합니다.
• MCP 서버 – 모든 등록된 프로젝트를 제공하는 단일 Python 프로세스. 클라이언트는 AI 도구 설정에서 한 번만 구성합니다(mcpServers.projectmem.command 등). 서버는 log_issue, precheck_file, get_context 등의 호출에 응답합니다.
• 이벤트 저장소 – 일반 텍스트 events.jsonl과 파생된 summary.md. 이벤트는 유형화되어 있으며(문제, 시도, 수정, 결정, 메모) 관련된 소스 파일에 연결됩니다.
• 대시보드 – HTML 시각화(pjm visualize, pjm dashboard)로 "메모리 카드", 실패 히트맵, ROI, 케이스 파일, 여러 프로젝트에 걸친 전역 보기를 표시합니다.
• 커밋 전 경고 – 커밋 전에 이벤트 로그를 확인하고 변경 사항이 이전의 실패한 접근 방식을 반복하는 경우 경고하는 git 훅.

사용 방법

1. pip install -U projectmem.
2. pjm doctor를 실행하여 기존 저장소를 검색하고 누락된 저장소를 등록합니다.
3. 생성된 MCP 구성 블록을 AI 코딩 도구(Claude, Cursor 등)에 추가합니다.
4. 저장소 내에서 pjm init가 .projectmem/를 생성하고, git 훅을 설치하고, 감시자를 시작합니다.
5. 그 후 AI는 세션 시작 시 저장된 이벤트를 읽고 새 이벤트를 자동으로 기록합니다. 수동으로 pjm precheck를 호출할 수도 있습니다.

새로운 내용(v0.3.4)

• 요약이 간결하게 유지되도록 상한이 설정되었습니다(토큰 수 약 60% 감소).
• 커밋이 수정하는 실제 소스 파일 아래에 분류되어 오래된 경고 버그를 수정했습니다.
• 오래된 경고의 시간대 처리가 UTC 기반이 되어 전 세계적으로 신뢰할 수 있습니다.
• MCP 문서의 도구 서명이 수정되었고, 이제 모든 공개 호출을 검증하는 테스트가 있습니다.
• Windows, Python 3.13/3.14 및 업그레이드 경로 처리에 대한 사소한 안정성 수정.

중요한 이유 AI 코딩 어시스턴트는 상태가 없습니다. 외부 메모리가 없으면 전체 코드베이스를 반복해서 다시 읽고 실패한 수정을 다시 탐색하여 토큰과 개발자 시간을 낭비합니다. projectmem는 로컬 우선이고 개인 정보를 보호하는 메모리 레이어를 제공하여 코드 변경 뒤에 있는 "이유"를 지속시킴으로써 에이전트가 빈 상태에서 시작하는 대신 경험을 바탕으로 행동할 수 있게 합니다.

더 알아보기

• 전체 웹 가이드: https://projectmem.dev/guide
• 데모 비디오: https://youtu.be/pELGdXHj_Ls
• 연구 논문(arXiv 2606.12329)은 설계와 207개 이벤트 연구를 설명합니다.
• 소스 코드와 문서는 GitHub에, 패키지는 PyPI에 있습니다.