nautli

모든 AI 메모리 도구는 저장만 합니다. nautli는 소화합니다.

모든 AI 에이전트를 위한 하나의 로컬 브레인. Claude Code, Cursor 및 기타 MCP 클라이언트가 단일 로컬 메모리를 공유합니다. 사용자가 잠든 사이에 소화 데몬이 중복을 병합하고, 모순을 검토 카드로 바꾸며, 쓰레기를 잊어버립니다. 진실의 원천은 다른 사람의 서버가 아니라 사용자 디스크의 일반 파일입니다.

You, in Claude Code:     "Remember: our API runs on port 4000."
You, in Cursor, later:   "What port does our API use?"
Cursor:                  4000  (recalled from the same local brain)

한국어 문서: README.ko.md

설치

npx nautli dashboard

대시보드는 127.0.0.1에서만 열리며 모든 과정을 안내합니다:

1. 메모리 점검: 이미 보유한 노트(Obsidian 볼트, CLAUDE.md, 에이전트 메모리 파일)를 스캔하고 실제 중복, 모순, 오래된 사실을 바탕으로 건강 점수를 보여줍니다. 미리보기 스캔은 최대 40개 노트를 스캔하며 일반적으로 약 10분이 걸립니다. 발견된 내용을 한 번의 클릭으로 가져오거나, 깨끗한 상태로 시작하세요.

2. Claude Code 연결: 원클릭 MCP 등록(remember / recall / briefing 도구).

3. 습관 지침: CLAUDE.md에 한 블록을 추가하여 AI가 실제로 메모리를 사용하도록 합니다.

4. 야간 소화 데몬: 매일 새벽 3시 30분에 중복이 병합되고 모순이 검토 카드가 됩니다. 한 번의 버튼으로 완전히 제거할 수 있습니다.

요구 사항, 솔직하게

better-sqlite3는 네이티브 모듈입니다. 대부분의 플랫폼은 사전 빌드된 바이너리를 다운로드합니다. 특이한 플랫폼과 Node 조합은 컴파일로 대체되며, 이 경우 python3와 C++ 툴체인이 필요합니다.

현재 작동하는 AI 도구

코딩 에이전트가 설치하도록 하기

이 내용을 Claude Code 또는 모든 코딩 에이전트에 붙여넣으세요. 전체 흐름은 비대화형입니다:

npx nautli setup --yes    # storage + MCP registration + instructions + nightly daemon + one digest run
npx nautli doctor         # verify the install

전역 설치를 선호한다면: npm i -g nautli, 그 다음 nautli dashboard. 기여자: git clone https://github.com/nautli/nautli.git && cd nautli && npm install && node src/cli.js dashboard.

Related MCP server: MCP Memento

왜 또 다른 메모리 도구인가

계속 커지기만 하는 메모리는 잡동사니 서랍이 됩니다: 모든 사실의 사본이 세 개, 그중 두 개는 오래되었고, AI는 그중 하나를 무작위로 선택합니다. 대부분의 메모리 도구는 저장하고 검색합니다. nautli는 메모리를 소화해야 하는 무언가로 취급합니다:

• 축적이 아닌 소화. 야간 데몬이 중복을 병합하고 안전하게 해결할 수 있는 것을 처리합니다.

• 조용한 수정이 아닌 검토 카드. 모호한 판단은 절대 자동 적용되지 않습니다. 모순은 아침에 한 번의 클릭으로 답하는 카드가 되고, 답변은 새로운 사실이 됩니다.

• 설계상 무손실. 자동 파이프라인은 사실을 절대 삭제하지 않습니다. 대체되거나 무효화된 사실은 전체 이력과 함께 보관되며, rebuild는 언제든지 파일에서 인덱스를 복원합니다. (nautli purge는 유일한 명시적 사용자 호출 예외입니다 — 사용자가 지정한 사실을 영구 삭제합니다.)

• 이중 시간적 사실. 모든 사실은 언제 사실이었는지와 언제 기록되었는지를 알고 있으므로 "포트 3000에서 4000으로 이전했다"는 충돌이 아닌 이력이 됩니다.

• 로컬 우선. 메모리는 ~/.nautli/의 파일입니다. AI 도구를 바꿔도 브레인은 유지됩니다.

지금까지 측정된 품질

아래 수치는 내부 평가에서 나온 것입니다: 자체 볼트에 대한 4,000개 이상 원자 실행과 세 명의 외부 테스터 볼트에 대한 홀드아웃 실행. 레이블이 지정된 평가 세트와 방법론 문서는 이 저장소에 게시될 예정입니다. 그때까지는 작성자 보고 수치로 간주하세요.

• 잘못된 자동 병합: 지금까지 내부 및 홀드아웃 실행에서 관찰된 사례 없음. 표본이 아직 작으므로 사전 등록된 평가 세트가 포함된 공개 벤치마크가 출시될 때까지 원시 수치를 공개하지 않습니다(이 저장소에 계획됨).

• 모순 감지 재현율: 레이블 세트에서 100%

• 잘못된 자동 적용 작업: 0. 정책상 모호한 것은 모두 검토 카드로 가기 때문

• 솔직한 약점: 쓰레기 필터링. 자체 데이터에서는 한 자릿수 쓰레기, 초기 테스트에서 외부 볼트에서는 훨씬 더 나쁨. 3단계 필터가 진행 중이며, 어느 쪽이든 수치는 공개될 예정

데이터 경계

• 메모리, 이벤트 로그, 보고서는 ~/.nautli/ 아래의 로컬 파일입니다. 노트와 메모리 콘텐츠는 어디에도 업로드되지 않습니다.

• 판단 프롬프트(중복 및 모순 검사)는 사용자 본인의 Claude 구독을 통해 Anthropic으로 전송됩니다. 노트 텍스트가 사용자 머신을 떠나는 유일한 경로입니다.

• 익명 사용 원격 측정(카드 수, 판단/라우팅 통계, 설치 UUID — 노트나 메모리 콘텐츠는 절대 아님)은 기본적으로 켜져 있으며 nautli의 원격 측정 엔드포인트로 전송됩니다. 언제든지 끌 수 있습니다: nautli telemetry off.

• 자동 파이프라인은 사실을 절대 DELETE하지 않으며, 소프트 보관만 합니다. npx nautli rebuild는 소스 파일에서 모든 것을 재구성합니다. nautli purge는 유일한 명시적 예외입니다: 사용자가 지정한 사실을 영구 삭제합니다.

CLI

npx nautli init                                              # create ~/.nautli
npx nautli remember "our API port is 4000" --scope project:myapp
npx nautli recall "port" --scope project:myapp
npx nautli daemon-run                                        # run one digestion manually
npx nautli rebuild                                           # rebuild the index from source files

이식성 / export --verify

nautli export --verify --out nautli-memory.json
nautli import nautli-memory.json --home /path/to/empty/nautli-home

export --verify는 내보내기 파일의 형식, 사실 스키마, 개수, 사실+이벤트 체크섬을 별도로 확인한 다음 임시 홈 디렉토리에서 검증된 왕복(round-trip)을 수행합니다. 왕복은 모든 논리적 사실 행(대체 체인 및 출처 포함)을 비교하고, 원래 논리적 순서대로 다시 작성된 이벤트를 확인하며, 대표 recall 쿼리가 동일한 사실 ID를 동일한 순서로 반환하는지 확인합니다.

이는 메모리 이식성 검사입니다. 백업 무결성 증명이 아니며 다른 복사본이나 저장소에서의 삭제를 증명하지 않습니다.

보류 중인 검토 큐(미해결 모순/검토 카드)는 nautli-export/1 minor: 1 형식부터 내보내기에 포함되며 가져오기 시 복원됩니다. 이보다 이전의 내보내기 파일(review 필드가 없는)도 정상적으로 가져옵니다.

수동 MCP 등록:

claude mcp add -s user nautli -- npx nautli mcp

아키텍처

src/core 저장소, 쓰기 게이트, recall / src/mcp stdio 서버 / src/cli.js / src/daemon 쌍, judge, apply, report, render / src/dashboard 로컬 대시보드 / src/onboard 설정 및 점검. 전체 사양: SPEC.md.

불변 조건(위반은 버그이며 테스트로 고정됨): 사용자 파일이 진실의 원천(rebuild 왕복) / 사실에 대한 자동 DELETE 없음(purge는 명시적 사용자 호출 예외) / 단일 패스 쓰기, 정리는 데몬에서만 / 데몬이 죽어도 코어는 작동 / recall에 승격 주입 없음 / 의심스러우면 무작동(잘못된 병합의 비대칭 비용).

알려진 제한 사항

• npm 12는 기본적으로 네이티브 설치 스크립트를 차단하므로, 사용자가 better-sqlite3의 설치 스크립트를 승인(npm install-scripts approve)하고 재빌드할 때까지 새 npx nautli는 실패합니다. 2026-07-24 측정. 전체 재현 및 복구 절차는 docs/research/npm12-native-build.md에 있습니다. 라이프사이클 없는 설치 경로가 검토 중입니다.

• t_valid는 날짜 단위입니다. 같은 날짜의 모순은 기록된 시간과 맥락에서 판단됩니다

• LLM judge 비결정성은 네 가지 방식으로 방어됩니다: 격리된 cwd, 형식 예시, 제로 파싱 재시도, 실패한 배치는 무작동이 됨

• 아직 임베딩 없음(FTS 접두사 검색만), v1.1 계획됨

• 병합 방향은 t_valid 기반입니다. 부분 집합 사실이 상위 집합보다 최신이면 상위 집합이 접힐 수 있습니다. judge keep 필드를 통한 수정 계획됨