Remnic: AI agent에 로컬 퍼스트 공유 기억 저장소 장착하기

누구에게 적합한가

• AI 어시스턴트가 세션을 넘어, 여러 agent에 걸쳐 공유되는 기억을 갖기를 원하는 개인 개발자에게 적합합니다. 기억은 YAML frontmatter가 붙은 일반 markdown 파일로 사용자 자신의 디스크에 저장되며, 검색 인덱스는 이 파일들로부터 재구축할 수 있어 외부 데이터베이스 서비스가 필요 없습니다. MIT 오픈 소스, 로컬 퍼스트입니다.
• 여러 agent를 동시에 사용하면서 "하나의 기억 저장소를 모든 agent가 함께 사용"하기를 원하는 시나리오에 적합합니다. 저장과 회상 외에도 MCP 도구 세트에는 엔티티 조회, 기억 수정, 시간 기반 회상, X-ray 출처 추적, 데일리 브리핑, 작업 보드, 연속성(continuity) 도구가 포함됩니다.
• 적합하지 않은 경우: Node.js 22.12 이상이 필요하므로 구버전 환경에서는 사용할 수 없습니다. 원격 배포(docker, 호스팅 서비스 등)를 어느 정도 지원하는지는 근거 자료에 명시되어 있지 않으므로, 이런 요구가 있다면 먼저 직접 확인하시기 바랍니다.

3분 만에 첫 시도하기

권장 기본 경로는 공식 CLI 전체 과정입니다:

1. 사전 요건: Node.js 22.12 이상 설치(nodejs.org).
2. 설치 및 초기화:

npm install -g @remnic/cli
remnic init

remnic init은 remnic.config.json 설정 파일을 작성합니다(로컬 상태 기록이며, 정상적인 초기화 단계입니다). 전역 설치 시 remnic 명령과 함께 레거시 engram 포워더 명령도 설치됩니다.

1. 시작 및 확인:

remnic daemon start
remnic status

remnic status가 정상적으로 반환되면 성공 신호이며, 백그라운드 서비스가 실행 중이라는 뜻이므로 클라이언트를 연결할 수 있습니다. 독립 실행 방식에서 daemon은 MCP 도구를 노출하는 HTTP 엔드포인트로 동작할 수 있습니다(공식에서는 @remnic/server 실행 방식도 차선책으로 제공합니다). 첫 검증 시에는 remnic status 같은 상태 확인 동작만 수행한 뒤 실제 저장을 진행하는 것을 권장합니다.

구분에 주의: remnic init과 이후의 기억 쓰기는 모두 로컬 디스크에 기록하는 동작이며, 읽기 전용 작업이 아닙니다. remnic status는 실행 상태를 확인하는 저위험 확인 동작입니다.

사용 사례

• 사례: 기억을 하나 저장한 뒤 회상하기. daemon이 실행된 상태에서 사실 하나를 기억 저장소에 넣고, MCP 호출을 통해 회상 기능으로 이를 조회합니다. 기억 레코드는 디스크에 있는 YAML frontmatter가 붙은 markdown 파일(예: category: decision 같은 구조)이며, 성공하면 로컬 파일에서 이 레코드를 직접 확인할 수 있고 agent 쪽에서 회상할 수 있습니다. 근거 자료에 store/recall 도구의 정확한 호출 파라미터 예시는 제공되지 않았으므로, 구체적인 파라미터는 MCP 클라이언트에 표시되는 도구 설명을 기준으로 하시기 바랍니다.
• 사례: 데일리 브리핑/연속성 도구로 어제 작업 이어가기. MCP 엔드포인트에 연결하면 클라이언트에 Remnic의 도구 세트가 표시되며, 여기에는 daily briefing(데일리 브리핑), work-board(작업 보드), continuity(연속성) 도구가 포함됩니다. 브리핑류 도구를 호출하면 기존 기억을 바탕으로 현재 상태 개요를 얻을 수 있습니다. 도구 이름의 정확한 표기는 클라이언트에 표시되는 도구 목록을 기준으로 하며, 근거 자료에 하나하나 나열되어 있지는 않습니다.

사용 시 주의 사항

• Remnic은 로컬 읽기·쓰기 시스템입니다. 기억을 저장하면 markdown 파일이 디스크에 기록되고, 기억을 수정하면 기존 내용이 변경됩니다. 근거 자료에 내장된 실행 취소/롤백 경로는 명시되어 있지 않으므로 자동으로 되돌릴 수 있는 것으로 간주해서는 안 됩니다. 삭제와 백업은 사용자의 로컬 파일 관리에 의존합니다.
• 기억은 일반 텍스트 markdown으로 로컬 디스크에 저장되므로 민감한 정보는 신중하게 저장하시기 바랍니다. README의 프라이버시 및 마스킹 정책에 대한 구체적 설명은 근거 자료에서 확인되지 않아 알 수 없습니다.
• 서비스는 Node.js ≥ 22.12를 요구합니다. 클라이언트 연결 포트, 인증 등 세부 사항은 근거 자료에 공개되어 있지 않으므로, 네트워크 노출이 필요하다면 먼저 공식 문서에서 확인하시기 바랍니다.
• 미확인 항목(프라이버시 정책, 도구의 전체 파라미터, 원격 배포)은 모두 공식 저장소의 최신 README를 기준으로 합니다.