AI 코딩 에이전트의 영속 메모리 시스템 Engram

핵심 요약

• AI 코딩 에이전트가 세션 종료 후 모든 정보를 잃는 문제를 해결하기 위해 Go 바이너리로 만들어진 영속 메모리 시스템이다.
• SQLite + FTS5 전문 검색, CLI, HTTP API, MCP 서버, 터미널 UI로 구성되며 의존성이 없는 단일 바이너리로 제공된다.
• Claude Code, OpenCode, Gemini CLI, Codex, VS Code Copilot, Windsurf 등 14개의 MCP 호환 에이전트와 연동할 수 있다.
• 프로젝트 인식 메모리로, 현재 디렉토리를 자동 감지하거나 명시적으로 프로젝트를 지정할 수 있으며 Git Sync로 다른 머신 간 공유가 가능하다.
• 메모리는 로컬 SQLite에 저장되어 로컬 우선이며, 선택적으로 Engram Cloud를 통해 클라우드 복제와 공유 접근을 지원한다.
• TUI는 j/k로 네비게이션, Enter로 상세 조회, c로 클립보드 복사, /로 검색, Esc로 뒤로 가기 기능을 제공한다.
• 26개의 MCP 도구, HTTP API 엔드포인트, 진단용 Doctor 명령, 관련 메모리 충돌 표시, 플러그인, 팀 사용 규칙을 포함한다.
• 에이전트는 메모리를 담금질 시간 기록 및 검색으로 사용해야 하며, 쓰기 전 mem_current_project로 프로젝트를 확인하고 mem_context/mem_search로 기존 기록을 복구해야 한다.
• 완료된 버그 수정, 결정, 발견, 설정 변경 같은 중요한 지식을 mem_save로 저장하되 원본 도구 출력이나 모든 대화 턴을 캡처하면 안 된다.
• Git 초기화가 감지 프로젝트를 변경할 때는 project_transition_conflict로 중단되어 사용자가 의도한 범위를 명시적으로 선택할 수 있다.
• 설치는 GitHub Releases에서 최신 안정 버전을 받으며, Homebrew도 지원하고 Windows, Linux, 소스 빌드는 별도 문서에 설명되어 있다.
• 구성 후 해당 에이전트를 재시작하면 되며, Claude Code는 engram setup claude-code 실행으로 마켓플레이스와 플러그인 업데이트를 함께 처리한다.