cat、grep、git できる Claude 用メモリ。
Claude および MCP 対応エージェントのためのマークダウンネイティブなメモリアーキテクチャ。アシスタントのメモリは、あなたが所有するディレクトリ内のプレーンな .md ファイルとして存在します — テキストエディタで閲覧でき、git でバージョン管理でき、マシン間で持ち運べます。不透明なベクターデータベースのどこか別の場所に置かれるわけではありません。
同じボールトの上に、5 つの組み合わせ可能なパターンが重なります:
Weave Core MCP — 任意のマークダウンディレクトリに対する 5 動詞メモリツール
PPR ブート検索 — 事前生成ダンプではなく、クエリ駆動の Personalized PageRank
二時点リゾルバ — 事実には valid_from / superseded_by があり、タイムトラベルクエリが組み込み
スリープ時統合器 — 最近のアクティビティがエンティティファイルにパッチされ、リフレクト合成が学習ログ上で実行される
書き込み時競合リゾルバ — k-NN + LLM 判定が、UPDATE が正しいときに ADD の重複を拒否する
基盤はマークダウンと YAML frontmatter だけです。サービスも、埋め込み DB も、Ollama もありません。5 動詞ツールはゼロインフラで提供され、よりリッチなパターンは同じファイルの上に層として重なります。
v0.4.0 の新機能:
レーン ファイアウォール (フェイルクローズ) — lane_map.yaml を介してノートを検索レーンにルーティング。クロスレーンの漏洩はすべての継ぎ目 (密検索、PPR シード、リコール) でブロックされ、両方の語彙リストに一致するブリッジファイルは人間が裁定するまでビルドを中止し、レーン設定ハッシュゲートが古いキャッシュを拒否します。
Cortex 読み取りパスの堅牢化 — 1 つの不正なノートはそのノートのみを劣化させ、障害は隠蔽されず報告され、隔離されたファイルはどのレーンでも検索不可になります。
weave lint — 機械可読な --paths 出力を持つボールト lint 動詞。
決定的競合事前フィルタ — 無関係な書き込みは LLM 判定を完全にスキップします。
アドバイザリ書き込みゲート — MCP 書き込み動詞がアドバイザリ競合提案を追加します (フェイルオープン、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 エンティティ)。5 つのパターンを試すのに最適です。
personas/sonnet/ — 簡潔で監査規律のある Claude コラボレーターを中心に構築されたスターター。声、仕事のスタイル、関係性の足場が事前に配線されています。レイアウトとフォーク手順については personas/sonnet/README.md を参照してください。
または、スターターをスキップして、既存の任意のマークダウンディレクトリ — Obsidian、ノートリポジトリ、dotfiles — を TheWeave に向けることもできます。エンジンはあなたの既存のレイアウトに適応します。
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 └─────────────────┘ ║
╚════════════════════════════════════════════════════════════════════╝両方のティアが1 つのボールトを共有します。Core はゼロインフラで提供され (claude_desktop_config.json に MCP エントリを追加するだけですぐに使えます)、Pro はデータ形式を変えずにリッチなエンジンを追加します。
# | パターン | 実装 | LLM 依存 |
1 | Weave Core MCP | 安定 — 5 動詞、パスエスケープ保護 | なし |
2 | PPR ブート検索 | 安定 — NetworkX、frontmatter 対応ウィキリンク、二時点シード解決 | なし |
3 | 二時点リゾルバ | 安定 — | なし |
4 | スリープ時統合器 | 安定したスキャン + パッチ。リフレクト合成はデフォルトでモックヒューリスティックを使用。 | オプション |
5 | 書き込み時競合リゾルバ | 安定した TF-IDF + 判定パイプライン。デフォルトでモック分類器。 | オプション |
すべての永続化はプレーンなマークダウンです。ChromaDB も、Ollama も、サービスもありません。5 動詞基盤がアーキテクチャの約 80% を担い、LLM が必要なのはパターン 4 と 5 の分類器ステップだけです。
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 ハードウェアでの実地テストはまだです。実行した場合は、issues で遭遇したことを良いことも悪いことも報告してください。既知のスコープ制限: cortex install-nightly は macOS 専用 (launchd) です。代わりにタスクスケジューラを使用して 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 ↔ ボールト | Claude Desktop、Cowork、または | はい |
人間 ↔ ボールト | 任意のマークダウンエディタ。ネイティブのウィキリンク + バックリンクグラフ 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 バックエンドはありません — 貢献を受け付けています。
私たちが公開で積極的に実行している反証可能な問い。事前登録プロトコルと再現試行を歓迎します — issue を開いてください。
# | 問い | これまでの証拠 | ステータス |
1 | 競合事前フィルタの言い換え盲点 — TF-IDF 事前フィルタは言い換えのニアデュープリケートを見逃します。密埋め込み判定スコアリングはこれを修正しますか? | 2 リグの証拠: 言い換えのニアデュープリケートは 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.
