nautilus-compass

AI MemoryCLIPython

★ 1,255주당 +275

무엇인가

nautilus-compass는 AI 에이전트의 컨텍스트 앞뒤에 붙는 로컬 데몬 겸 MCP 서버다. 에이전트가 대화 세션을 넘어 기억을 유지하고, 행동 전에 규칙 위반 위험을 판정하게 하는 계층에 속한다. 호스팅 메모리 서비스가 차지하던 자리를 로컬 프로세스로 대체한다.

어떻게 동작하나

기억은 원문 텍스트를 BGE-m3로 로컬 임베딩해 저장한다. 수집 시점에 추출 LLM도, 지식 그래프도 쓰지 않는다. 검색은 질문 유형에 따라 갈린다. 단일 세션·지식 갱신 질문은 턴 윈도 청크로, 나머지는 세션 단위 하이브리드(BM25 + dense RRF)로 라우팅한다. 별도 축인 드리프트 탐지는 실제 실패 패턴 25개(양성)와 35개(음성) 앵커 집합에 프롬프트를 대조해 점수를 매기고, 에이전트가 행동하기 전에 경고한다. Claude Code에는 UserPromptSubmit·PostToolUse·Stop 세 훅이 걸린다.

무엇과 다른가

mem0 같은 추출 기반 메모리 계층은 수집 단계에서 LLM으로 사실을 뽑아 그래프를 만든다. compass는 원문을 그대로 두고 임베딩만 하므로 데이터가 기기 밖으로 나가지 않는다. LongMemEval-S 500문항 동일 질문 대조에서 세 지표 모두 앞선다고 밝히며, 비용은 14배 낮다고 주장한다. LOCOMO-10(n=1986)에서도 0.644/0.890 대 0.592/0.802다. 기억 계층 밖에 판정 계층(NACRE judge 1.7B LoRA, caliber-bench)을 함께 배포하는 구성은 다른 메모리 계층에 없다.

어떻게 쓰나

설치 스크립트가 ~/.claude/settings.json에 세 훅을 기록한다. 슬래시 명령은 /compass-verify, /compass-drift, /compass-recall, /compass-search, /compass-status 다섯 개다. 다른 MCP 클라이언트는 Claude Desktop·Cursor·Cline·Continue.dev·Zed를 자동 감지해 MCP 설정을 패치한다. 호스팅 게이트웨이는 compass.nautilus.social/signup에서 가입한 뒤 웹 콘솔이나 POST /tokens로 범위 토큰을 발급받고, https://compass.nautilus.social/mcp/ 에 Bearer 토큰과 streamable-http로 붙는다.

전제와 한계

기억 계층은 전부 로컬에서 돌고, 판정 산출물은 측정·추론·검증 불가로 라벨링된다. 데몬이 유휴 상태였다면 첫 recall이 최대 90초 걸린다(모델 콜드 로드). MCP 클라이언트가 확장 타임아웃으로 한 번 재시도한다. COMPASS_USE_INOTIFY=0은 새 파일 탐지를 조용히 끄므로 데몬이 WARNING을 남긴다. anchors.json이 없으면 drift가 조용히 '위험 없음'을 반환하지 않고 drift.anchors_error와 should_alert: true를 실어 보낸다. 판정 모델 배포는 fp16만 허용되고 int8(98.28%)은 실패, int4(94.16%)는 금지로 사전 등록돼 있다.

관련 논문 2

유사 도구