cat, grep, git으로 다룰 수 있는 Claude 메모리.
Claude 및 모든 MCP 인지 에이전트를 위한 마크다운 네이티브 메모리 아키텍처. 어시스턴트의 메모리는 당신이 소유한 디렉터리에 일반 .md 파일로 존재합니다 — 텍스트 편집기에서 검사 가능하고, git에서 버전 관리되며, 기기 간에 이식 가능합니다 — 불투명한 벡터 데이터베이스 어딘가에 있는 것이 아닙니다.
다섯 가지 구성 가능한 패턴이 동일한 볼트 위에 얹혀 있습니다:
Weave Core MCP — 모든 마크다운 디렉터리 위의 5-동사 메모리 도구
PPR 부트 검색기 — 미리 구운 덤프가 아닌 쿼리 기반 Personalized PageRank
이중 시간 해석기 — 사실에는 valid_from / superseded_by가 있으며, 시간 이동 쿼리가 내장되어 있습니다
수면 시간 통합기 — 최근 활동이 엔티티 파일에 다시 패치되고, 반영 합성이 학습 로그 위에서 실행됩니다
쓰기 시간 충돌 해석기 — k-NN + LLM 판정이 UPDATE가 올바를 때 ADD 중복을 거부합니다
기반은 마크다운과 YAML frontmatter뿐입니다. 서비스도, 임베딩 DB도, Ollama도 없습니다. 5-동사 도구는 인프라 제로로 제공되며, 더 풍부한 패턴은 동일한 파일 위에 계층화됩니다.
v0.4.0의 새로운 기능:
레인 방화벽(fail-closed) — lane_map.yaml을 통해 노트를 검색 레인으로 라우팅합니다. 교차 레인 누출은 모든 이음새(밀집 검색, PPR 시딩, 리콜)에서 차단되며, 두 어휘 목록 모두와 일치하는 브리지 파일은 사람이 판정할 때까지 빌드를 중단시키고, 레인 구성 해시 게이트는 오래된 캐시를 거부합니다.
Cortex 읽기 경로 강화 — 잘못된 노트 하나는 해당 노트만 저하시키고, 오류는 숨겨지지 않고 보고되며, 격리된 파일은 어떤 레인에서도 검색 불가능합니다.
weave lint — 기계 판독 가능한 --paths 출력을 제공하는 볼트 린트 동사.
결정적 충돌 사전 필터 — 무관한 쓰기는 LLM 판정을 완전히 건너뜁니다.
자문 쓰기 게이트 — MCP 쓰기 동사가 자문 충돌 제안을 추가합니다(fail-open, WEAVE_WRITE_GATE=0 킬 스위치).
Windows 지원(베타) — Windows(베타) 참조.
git clone https://github.com/TheWeaveSC/theweave.git ~/theweave
cd ~/theweave
pip install -e .
# verify the install end-to-end
weave-cli doctor
# try the included demo vault
weave-cli demo boot "ACME cutover with Marcus"
weave-cli demo current entity-ACME --as-of 2026-01-01 # time-travel
weave-cli demo consolidate --today 2026-05-23 # dry-run정상적인 설치 상태는 다음과 같습니다:
🪶 Weave 2.0 Doctor
[Engine]
✓ Python 3.11.15 (≥3.11 required)
✓ Dependencies importable
mcp 1.27.1, networkx 3.6.1, frontmatter 1.3.0, click 8.4.1, ...
✓ CLI + MCP entry points importable
ℹ theweave 0.4.0
[Vault]
✓ Vault root resolves: ~/theweave/seed-vault
✓ Layout: flat (seed-vault style)
✓ 18 notes total — entities 6, sessions 7, signals 1, other 4
✓ Frontmatter parses on all notes
✓ Pattern 4 will scan 7 session(s)
✓ Pattern 2 graph: 18 nodes, 71 edges, 0 isolates (0%)
✓ Bi-temporal coverage: 6/6 entities (100%)
[Environment]
✓ Obsidian.app detected in /Applications/
ℹ ANTHROPIC_API_KEY not set — Pattern 4/5 will run in mock mode
All checks passed.Python ≥ 3.11 필요. 클론 없는 설치 경로(GitHub 인증 불필요)는 설치를 참조하세요.
Related MCP server: Mneme Memory MCP
TheWeave는 볼트 네이티브입니다. 어시스턴트의 정체성 — 말투, 작업 스타일, 구축해 온 관계 — 그 자체가 볼트 안의 마크다운일 뿐입니다. 페르소나 메모리는 모든 세션에서 로드되고, 사실적 메모리는 요청 시 검색됩니다. 동일한 프리미티브, 동일한 파일, 다른 로딩 규율.
즉, 페르소나는 포크할 수 있는 스타터 볼트입니다:
# clone a starter vault and verify the engine sees it
cp -R personas/sonnet ~/my-vault
weave-cli doctor --vault ~/my-vault --check-mcp
$EDITOR ~/my-vault/entities/entity-user.md # personalize the user identity이 저장소에 포함된 스타터 볼트:
seed-vault/ — 중립적인 가상 스타터(ACME / FOO 엔티티). 다섯 가지 패턴을 시험해 보기에 가장 좋습니다.
personas/sonnet/ — 간결하고 감사 규율을 따르는 Claude 협업자를 중심으로 구축된 스타터. 말투, 작업 스타일, 관계 스캐폴딩이 사전 연결되어 있습니다. 레이아웃 및 포크 지침은 personas/sonnet/README.md를 참조하세요.
또는 스타터를 건너뛰고 TheWeave를 기존 마크다운 디렉터리 — Obsidian, 노트 저장소, dotfiles — 어디든 가리키세요. 엔진은 당신이 가진 어떤 레이아웃에도 적응합니다.
TheWeave | 벡터 DB 메모리 레이어 | |
저장소 | 파일 시스템의 일반 | 벤더 DB / Pinecone / pgvector |
검사 |
| API 쿼리 또는 관리 UI |
버전 관리 |
| 스냅샷/내보내기 도구 |
스키마 | 개방형 YAML frontmatter | 벤더 DB 스키마 |
실패 모드 | 손으로 편집할 수 있는 잘못된 마크다운 파일 | 쿼리로 제거해야 하는 잘못된 행 |
벤더 종속 | 없음 — 폴더일 뿐 | 마이그레이션 도구 필요 |
TheWeave는 채팅 메모리 애드온이 아닙니다. 데이터를 당신의 머신, 당신의 파일 시스템, 읽을 수 있는 형식으로 원할 때 Claude를 위한 메모리 레이어입니다.
┌──────────────────────────────────────┐
│ TheWeave — two-tier design │
└──────────────────────────────────────┘
╔════════════════════════════════════════════════════════════════════╗
║ WEAVE CORE (zero-infra, drop-in MCP server) ║
║ ║
║ ┌─────────────────────────────────────────────────────────────┐ ║
║ │ MCP server — 5 verbs over any markdown vault │ ║
║ │ view • create • str_replace • insert • delete │ ║
║ └─────────────────────────────────────────────────────────────┘ ║
║ │ ║
║ ▼ ║
║ ┌─────────────────────────────────────────────────────────────┐ ║
║ │ Vault (markdown + YAML frontmatter) │ ║
║ │ entities/ sessions/ wiki/ LearningLayer/ │ ║
║ └─────────────────────────────────────────────────────────────┘ ║
╚════════════════════════════════════════════════════════════════════╝
│
▼ (same vault, richer engine)
╔════════════════════════════════════════════════════════════════════╗
║ WEAVE PRO (Python engine on your machine) ║
║ ║
║ Pattern 2 — Query → entity-extract → Personalized PageRank → ║
║ top-N notes (bi-temporal-aware) ║
║ ║
║ Pattern 3 — Bi-temporal frontmatter (valid_from / valid_until / ║
║ superseded_by) + chain resolver ║
║ ║
║ Pattern 4 — Sleep-time consolidator: ║
║ recent sessions → per-entity activity patch ║
║ LearningLayer signals → reflect synthesis ║
║ (dry-run by default; --apply with _archive/ backup) ║
║ ║
║ Pattern 5 — Write-time: ║
║ TF-IDF k-NN candidates → LLM (or mock) → ║
║ ADD / UPDATE / DELETE / NOOP verdict ║
║ ║
║ ┌──────────────┐ ┌─────────────────┐ ║
║ │ mock_llm │ ◄─────► │ anthropic_llm │ ║
║ │ (offline) │ env │ (live Claude) │ ║
║ └──────────────┘ var └─────────────────┘ ║
╚════════════════════════════════════════════════════════════════════╝두 계층 모두 하나의 볼트를 공유합니다. Core는 인프라 제로로 제공되며(claude_desktop_config.json의 MCP 항목 하나면 끝), Pro는 데이터 형식을 변경하지 않고 더 풍부한 엔진을 추가합니다.
# | 패턴 | 구현 | LLM 의존성 |
1 | Weave Core MCP | 안정 — 5개 동사, 경로 이스케이프 보호 | 없음 |
2 | PPR 부트 검색 | 안정 — NetworkX, frontmatter 인지 wikilink, 이중 시간 시드 해석 | 없음 |
3 | 이중 시간 해석기 | 안정 — | 없음 |
4 | 수면 시간 통합기 | 안정적인 스캔 + 패치. 반영 합성은 기본적으로 모의 휴리스틱 사용, | 선택 사항 |
5 | 쓰기 시간 충돌 해석기 | 안정적인 TF-IDF + 판정 파이프라인. 기본적으로 모의 분류기, | 선택 사항 |
모든 영속성은 일반 마크다운입니다. ChromaDB도, Ollama도, 서비스도 없습니다. 5-동사 기반이 아키텍처의 약 80%를 담당하며, 패턴 4와 5의 분류기 단계만 LLM이 필요합니다.
git clone https://github.com/TheWeaveSC/theweave.git ~/theweave
cd ~/theweave
pip install -e .
weave-cli doctorcurl -sSL https://github.com/TheWeaveSC/theweave/releases/latest/download/install-weave.sh | bash태그된 릴리스 tarball을 다운로드하고, ~/theweave/venv/에 Python venv를 설정하고, 패키지를 설치하고, ~/.local/bin/이 PATH에 있으면 weave-cli를 심링크합니다. 성공 신호로 weave-cli doctor를 실행합니다. GitHub 인증이 필요 없습니다 — tarball은 공개 릴리스 엔드포인트에서 가져옵니다.
환경 변수로 재정의 가능: WEAVE_VERSION, WEAVE_HOME, PYTHON. install-weave.sh 참조.
v0.4.0은 Windows 지원을 추가합니다: 플랫폼 인지 Claude Desktop 구성 경로 해석(%APPDATA%\Claude\claude_desktop_config.json), 플랫폼 네이티브 cortex 캐시 위치(%LOCALAPPDATA%\theweave\cache), PowerShell 설치 프로그램:
irm https://github.com/TheWeaveSC/theweave/releases/latest/download/install-weave.ps1 | iex솔직한 라벨: Windows 경로는 구현되었고 코드 검토를 거쳤지만, 아직 Windows 하드웨어에서 현장 테스트되지 않았습니다. 실행한다면 이슈를 통해 좋든 나쁘든 겪은 것을 보고해 주세요. 알려진 범위 제한: cortex install-nightly는 macOS 전용(launchd)입니다. 대신 Task Scheduler를 사용하여 weave-cli cortex dream을 매일 밤 실행하세요.
docs/claude-desktop-config.snippet.json을 Claude Desktop 구성의 mcpServers 아래에 복사하세요 — macOS: ~/Library/Application Support/Claude/claude_desktop_config.json, Windows: %APPDATA%\Claude\claude_desktop_config.json, Linux: ~/.config/Claude/claude_desktop_config.json. Claude Desktop을 다시 시작하세요. 5개 동사가 weave-core/view, weave-core/create 등으로 사용 가능해집니다.
패턴 4와 5는 기본적으로 결정적 모의 구현을 사용합니다. 실시간으로 전환하려면:
pip install anthropic
export ANTHROPIC_API_KEY=...
export WEAVE_CLAUDE_MODEL=claude-sonnet-4-6 # optional
weave-cli demo consolidate # reflect step now uses Claude
weave-cli demo write /tmp/foo.md # verdict now uses Claudeweave/pro/llm.py 선택기는 ANTHROPIC_API_KEY가 설정될 때마다 anthropic_llm을 선택하고, 그 외에는 mock_llm으로 대체합니다. 코드 경로는 동일하며 분류기만 교체됩니다.
계층 | 무엇 | 필수? |
엔진 런타임 | Python ≥ 3.11; | 예 |
AI ↔ 볼트 |
| 예 |
인간 ↔ 볼트 | 모든 마크다운 편집기. 네이티브 wikilink + 백링크 그래프 UX를 위해 Obsidian을 권장하지만 필수는 아닙니다. | 권장 |
패턴 4 & 5 실시간 모드 |
| 선택 사항 |
설치 후 weave-cli doctor가 전체 스택 — 엔진, 볼트, 환경, 그리고 선택적으로 --check-mcp로 Claude Desktop MCP 연결 — 을 검증합니다.
거친 부분에 대한 솔직한 목록:
충돌 해석기의 TF-IDF는 짧은 문서에 취약합니다. 짧은 후보 노트는 개념적으로 동일해도 유사도 점수가 낮습니다. 이름 일치 우회가 대부분을 커버하며, 실제 임베딩(예: nomic-embed-text)이 프로덕션 경로가 될 것입니다.
PPR은 쿼리당 전체 그래프에서 실행되며 캐시되지 않습니다. 약 1,000개 노트 미만의 볼트에는 적합하며, 더 큰 볼트는 사전 계산 및 캐시가 필요합니다.
통합기의 모의 반영 단계는 키워드 버케팅입니다. 솔직한 스텁이지 실시간 Claude 반영 패스의 대체재가 아닙니다.
실시간 LLM 모드는 Claude 전용입니다. OpenAI / Gemini / Ollama 백엔드 없음 — 기여를 환영합니다.
공개적으로 활발히 실행 중인 반증 가능한 질문들. 사전 등록 프로토콜과 복제 시도를 환영합니다 — 이슈를 열어 주세요.
# | 질문 | 지금까지의 증거 | 상태 |
1 | 충돌 사전 필터 패러프레이즈 블라인드니스 — TF-IDF 사전 필터가 패러프레이즈 근접 중복을 놓칩니다. 밀집 임베딩 판정 점수가 이를 해결할까요? | 두 장치 증거: 패러프레이즈 근접 중복은 0.35 임계값에 대해 0.28–0.38의 유사도를 기록하므로 실제 중복이 사전 필터를 통과합니다 | 공개 — 사전 등록 프로토콜 환영 |
docs/architecture.md — 더 깊은 기술 문서
docs/v2-switchover-guide.md — v1에서 마이그레이션
CHANGELOG.md — 릴리스 기록
This server cannot be deployed
One memory, every AI. A shared, user-owned markdown memory your AI clients read and write over MCP.
Persistent memory for AI agents across Claude, ChatGPT and any MCP client.
Token-efficient MCP memory for Markdown vaults. Tiered search, GraphRAG, AI memories.
Persistent AI memory shared across Claude, ChatGPT, coding agents, and compatible MCP clients.
