stellavault

Claude が記憶する、ローカルファーストのセカンドブレイン。
Karpathy の自己コンパイル型 Wiki × Zettelkasten — 完全ローカルで、Vault を安全に保ち、MCP ネイティブです。

English · 한국어 · 日本語 · 简体中文

🤖 Claude / Cursor に追加 · ⬇ デスクトップアプリ · ⚡ クイックスタート · 🌐 ライブデモ

コマンドひとつで Claude が Vault を読めるようにできます：

npx -y stellavault setup    # MCP サーバーを Claude Code / Desktop、Cursor、Windsurf、または VS Code に接続します

Claude Code をお使いですか？ 代わりにプラグインをインストールしてください。MCP サーバーに加え、/vault-ask、/vault-review、/vault-decision のスキルを2つのコマンドで利用できます：

/plugin marketplace add Evanciel/stellavault
/plugin install stellavault@stellavault

それ自体がコンパイルされるセカンドブレイン。 Stellavault は、知識をどう保存し、成長させるべきかという2つの考え方を融合します：

• 🧠 Karpathy の自己コンパイル型 Wiki — PDF、YouTube リンク、ふと思いついた考えなど、何でも追加すると、自動的に raw/ に抽出され、整理された概念とバックリンクからなる _wiki/ に コンパイル されます。フォルダーの中で知識が劣化するのではなく、増えるにつれて知識自体が再コンパイルされます。
• 🕸️ Zettelkasten — アトミックノート、[[wikilinks]]、そして自然に生まれるつながりによって、フォルダーツリーではなく、アイデアの網 が思考の実際の構造になります。

その結果、ローカルファーストの知識ツールがひとつにまとまりました。フル機能の Markdown エディター、3D ニューラルグラフ、ハイブリッド AI 検索、間隔反復による記憶の減衰を備え、デスクトップアプリ、CLI、Obsidian プラグイン、そして Claude が Vault 全体を読めるようにする MCP サーバー として提供されます。クラウドも API キーも不要で、元のファイルが変更されることもありません。

ニューラルネットワークとして表示した Vault。ローカルファーストで、クラウドは不要です。

目次

主な機能 · Stellavault を選ぶ理由 · インストール · エディター · パイプライン · インテリジェンス · 検索とランキング · MCP 連携 · 3D 可視化 · 設定 · パフォーマンス · 技術スタック · セキュリティ · トラブルシューティング

主な特長

• 🧠 自分自身をコンパイルします。 PDF、YouTube のリンク、まとまりきっていないアイデアを追加するだけで、Stellavault が raw/ に抽出し、概念とバックリンクを備えた整理済みの _wiki/ を コンパイル します。知識が増えるほど、自ら整理されていきます。
• 🔍 本当に見つかる検索。 セマンティックな意味、正確なキーワード（BM25）、独自の [[wikilinks]] / #tags を 重み付き RRF で融合してハイブリッド検索を行い、FSRS メモリーモデルで再ランキングすることで、実際に 利用している情報が再び見つかるようにします。50 以上の言語に対応し、完全ローカルで、API キーは不要です。
• 🌌 3D で見るあなたの思考。 リアルタイムのニューラルグラフ（React Three Fiber）を備えています。フォルダーを掘り下げられるクラスタービュー、ノートごとのローカルグラフ、タグのオーバーレイ、そして あなた自身の wikilink と AI が推定した類似性を視覚的に区別する 2 種類のエッジを利用できます。ノートが 1 万 7,000 件ある保管庫にも対応します。知っていることの形を 見る ための方法です。
• 🤖 Claude が保管庫全体を読み込みます。 本格的な MCP サーバー（21 個のツール）を備えており、Claude は Claude Code、Claude Desktop、Cursor、Windsurf、または VS Code から、あなたの知識を検索、質問、草案作成、 lint、分析できます。
• ⏳ 気付かないうちに忘れることはありません。 FSRS の記憶減衰により、忘れかけている実際のノートを提示します。さらに、保管庫全体を対象に、情報の欠落、矛盾、重複も検出します。
• 🔒 ローカルファースト。保管庫を安全に保護。キー不要。 ローカル埋め込み、デバイス上のベクトルストアを使用し、元のファイルは 決して変更されません。オプトインしない限り、データがマシンの外部に送信されることはありません。

Stellavault を選ぶ理由

ほとんどのツールでは、執筆、検索、記憶 のいずれかを選ばなければなりません。Stellavault はこの 3 つすべてをローカルで実現し、Claude が読み取れるようにします。

メモ

どちらか一方を選ぶ必要はありません。Stellavault は プラグイン として Obsidian 内でも 動作します。エディターはそのまま使い、頭脳を追加しましょう。

インストール

デスクトップアプリ（推奨 — ワンクリック）

ヒント

ダウンロード → 解凍 → stellavault.exe（Windows）または stellavault（Linux）を実行 → ノートフォルダーを選択 → 完了。

CLI（開発者向け）

npm install -g stellavault    # or: npx stellavault
stellavault init              # Interactive setup (3 min): index vault + connect AI clients
stellavault setup             # Connect to Claude Code/Desktop, Cursor, Windsurf, VS Code (one command)
stellavault graph             # Launch 3D graph in browser

Node.js 20 以降が必要です。問題を診断するには stellavault doctor を実行してください。

Obsidian プラグイン

1. stellavault-obsidian のリリースから main.js + manifest.json + styles.css をダウンロードします
2. .obsidian/plugins/stellavault/ に配置します
3. 設定 → コミュニティプラグインで有効にします
4. 保管庫のフォルダーで npx stellavault graph を実行し、API を起動します

エディター

Obsidianに匹敵する、フル機能のMarkdownエディターです。

パイプライン

Capture ──→ Organize ──→ Distill ──→ Express

Drop anything → auto-extract → raw/ → compile → _wiki/ → draft

Karpathyの自己コンパイル型ナレッジアーキテクチャに着想を得ています。

14種類の形式を取り込み

Express：ナレッジを取り出す

stellavault draft "AI" --format blog      # Blog post from your vault
stellavault draft "AI" --format outline   # Structured outline
stellavault draft "AI" --ai              # Claude API enhanced ($0.03)

または、デスクトップアプリのExpressタブを使います。トピックを入力し、形式を選ぶと、ボルトの内容に基づいたドラフトを生成できます。_drafts/ に保存し、インラインで編集できます。

インテリジェンス（Stellavaultならではの機能）

これらの機能は、プラグインを使ってもObsidianにはありません。

検索とランキング

複数のシグナルを**重み付き逆順位融合（RRF）**で統合するハイブリッド検索です。個人用ナレッジ保管庫向けに調整されており、完全ローカルで動作し、API キーは不要です。

• エンティティマッチングでは、ファジー部分文字列マッチングと句読点を正規化したマッチングによって自然言語クエリを解決します（韓国語／CJK に対応）。さらに、1 つの大きなノートが上位結果を埋め尽くさないよう、ドキュメントごとの多様性上限を設けています。
• 新しさには、生のファイル更新日時ではなく、減衰エンジンと同じ FSRS メモリモデルを再利用します。忘れかけているノートは再び表示され、よく身についた長期保存向けのノートは、古いというだけで埋もれません。
• 適応型再ランキング（長時間稼働する MCP サーバー）では、現在のセッションコンテキスト（最近のタグ／パス）に応じて結果をさらに上位表示します。
• すべての重みは、保管庫ごと、または環境変数で調整可能です。設定をご覧ください。

MCP 統合（21 個のツール）

stellavault setup            # one command → Claude Code, Claude Desktop, Cursor, Windsurf, VS Code
# or, for Claude Code only:
claude mcp add stellavault -- stellavault serve

{
  "mcpServers": {
    "stellavault": {
      "command": "npx",
      "args": ["-y", "stellavault", "serve"]
    }
  }
}

Claude は、保管庫を直接検索し、質問し、下書きを作成し、Lint を実行し、分析できます。検索では、セマンティック検索、BM25、エンティティリンクを対象とした重み付き RRFに加え、FSRS の新しさとセッション適応型の再ランキングを含む、ハイブリッド検索パイプライン全体が実行されます（検索とランキングをご覧ください）。

3D ビジュアライゼーション

• クラスター別に色分けされたニューラルグラフ（React Three Fiber）
• クラスター表示（デフォルト） — 大規模な保管庫を、ラベル付きクラスターの小さな銀河として表示します。ビュー内の [Cluster | All nodes] 切り替えで、再読み込みせずに密な生データ表示へ切り替えられ、スーパーノードをクリックすると、そのクラスターのメンバーを詳しく表示します。
• 星座表示（MST の星形パターン）
• ヒートマップのオーバーレイ＋タイムラインスライダー＋減衰オーバーレイ
• マルチバース表示 — P2P ネットワーク上の宇宙として保管庫を表示
• ダーク／ライトテーマ

グラフビューアーのスケーリング

3D グラフレンダラーは、2 つの環境変数で上限が設定されています（stellavault graph を起動する前に環境変数を設定してください）。

上限が重要な理由。 エッジの構築はインラインの O(n²) 全ペアコサイン類似度ループです。n·(n-1)/2 個のペアそれぞれに対し、384 次元を処理します（packages/core/src/api/graph-data.ts の neighbors ループを参照）。cap=3000 では約 450 万ペアになり、数秒かかる構築処理を 5 分間のサーバーキャッシュが吸収します。上限を 13000 近くまで引き上げると約 8400 万ペアになり、数分の構築時間に加え、複数 GB の中間配列が発生して、シングルスレッドの Express ハンドラーがフリーズします（ワーカーはありません）。生データの「すべてのノード」経路は、上限いっぱいまで処理するため負荷が高くなります。そのためサーバーは、構築コストとキャッシュの種類数を抑えるため、ビューごとに指定された ?cap を上限（生データ ≤ 4000、クラスター ≤ 6000、端数は丸め）で制限します。

デフォルトのクラスター表示も、構築ではなくレンダリングのコストが低いだけです。 どちらのビューでも、キャッシュされていない状態で最初に取得すると、対象範囲の埋め込みの読み込み、O(n²) のコサイン類似度計算、k-means、単一スレッドでのフォースレイアウトの収束が実行され、ハンドラーが数秒間停止します。ビューアーは切り替え時に読み込み状態を表示するため、初回構築中にタップが無言で無視されることはありません。

ヒートマップ — クラスター間の接続密度	タイムライン — 時間とともにボルトが成長する様子を確認
検索 — セマンティック検索の一致箇所をグラフ内でハイライト	マルチバース — 軌道を周回する宇宙として表示される連合ボルト

今すぐ試す（デモボルト）

npx stellavault index --vault ./examples/demo-vault   # Index 10 sample notes
npx stellavault search "vector database"               # Semantic search
npx stellavault graph                                  # 3D graph visualization

デモボルトには、ベクターデータベース、ナレッジグラフ、間隔反復、RAG、MCP などに関する相互につながったノートが含まれており、すべての機能をすぐに試すのに最適です。

はじめ方ガイド

デスクトップアプリ

1. ダウンロード → 解凍 → 起動
2. 初回起動時に、ノートのフォルダーを選択します
3. ノートがサイドバーに表示されます。クリックして開きます
4. Ctrl+P を押すと、ファイルをすばやく切り替えられます
5. タイトルバーの ✦ をクリックすると、AI パネル（セマンティック検索、統計、下書き）が開きます
6. ◉ をクリックすると、3D グラフが開きます

CLI

npm install -g stellavault
stellavault init                          # Setup wizard
stellavault search "machine learning"     # Semantic search
stellavault ingest paper.pdf              # Add knowledge
stellavault graph                         # 3D graph in browser
stellavault brief                         # Morning briefing
stellavault decay                         # What are you forgetting?

キーボードショートカット（デスクトップ）

クイックリファレンス

設定

Stellavault は ./.stellavault.json（または ~/.stellavault.json）を読み込みます。検索ランキングは完全に調整可能です。適切なデフォルト設定で、そのまま利用できます。

{
  "search": {
    "rrfK": 60,
    "weights": { "semantic": 1.0, "bm25": 1.0, "entity": 1.5 },
    "recencyWeight": 0.2,                          // FSRS recency strength; 0 = off
    "entityAliases": { "k8s": ["kubernetes"] }     // synonym / cross-lingual groups (exact-only)
  }
}

環境変数は設定を上書きします（ガードを使って解析されます）。

注：多言語間の再現率（例：韓国語のクエリで英語のノートを見つけること）は、多言語埋め込みモデルによって自動的に処理されます。entityAliases は、キュレーションされたエンティティグラフ（タグ／ウィキリンク）や略語の精度を高めるためのオプションです。

パフォーマンス

合成した Vault でテスト済みです。一般的なユースケースでは、すべての操作が 1 秒未満で完了します。

独自のベンチマークを実行するには：

node tests/stress.mjs 500     # Test with 500 synthetic documents

主な最適化：

• HNSW グラフの構築 — 200 件以上のドキュメントでは sqlite-vec KNN を使用（O(n·K·log n) 対 O(n²)）
• 正規化済みベクトル：コサイン類似度を単一の内積で計算
• 埋め込みのバッチ読み込み（1 バッチあたり 500 件、RAM のオーバーフローを防止）
• 小規模な Vault（200 件未満）では、上三角行列を使った総当たり計算
• 型付き配列を使った O(n) の K-Means 重心更新

技術スタック

セキュリティ

• ローカル優先 — --ai を使用しない限り、データがマシンの外部に送信されることはありません
• Vault ファイルは変更されません — SQLite にインデックスを作成し、元ファイルには手を加えません
• Electron サンドボックスを有効化 — レンダラーの OS 権限を制限して実行します
• IPC パスの検証 — すべてのファイル操作は Vault のルート内で行われます
• API 認証トークン — セッションごとに発行され、ヘッダーのみで送信（X-Stellavault-Token）。トークンエンドポイントへのアクセスは同一オリジンに限定されます
• CORS 許可リスト — デフォルトでは localhost / 127.0.0.1 のみ。MCP HTTP トランスポートはオプトイン
• SSRF 対策 — URL の取り込み時にプライベート IP をブロック
• エンドツーエンド暗号化 — クラウド同期に AES-256-GCM を使用

フェデレーション（実験的機能、デフォルトでは無効）

ピアツーピアのセマンティック検索は、オプトインの実験的機能として提供されています。デフォルトのインストールでは、いかなるスウォームにも参加せず、データを共有することもありません。

明示的に有効にするには：

# PowerShell
$env:STELLAVAULT_FEDERATION_EXPERIMENTAL = "1"

# bash / zsh
export STELLAVAULT_FEDERATION_EXPERIMENTAL=1

stellavault federate join

有効にすると、フェデレーションでは、署名付きエンベロープを使った Ed25519 ID、相互チャレンジ・レスポンスハンドシェイク、エンベロープごとのリプレイ防止ノンス、ハンドシェイクのタイムアウト、ピアごとのレート制限、および受信のみの共有設定（myNodeLevel=0）が使用されます。ピアとタイトル／スニペットを実際に共有するには、フェデレーションプロンプトで set-level 1+ を実行してください。

警告

アップグレードに関する注意（v0.7.4） — フェデレーションのワイヤ形式が v2.0 から v2.1 に更新されました（エンベロープレベルのノンス）。v0.7.3 のフェデレーションノードとの互換性はありません。既存の ~/.stellavault/federation/sharing.json ファイルは、より安全なデフォルト設定に自動的にはダウングレードされません。以前にオプトインした場合は、myNodeLevel を確認してください。

詳しくは SECURITY.md をご覧ください。

トラブルシューティング

stellavault doctor    # Check config, vault, DB, model, Node version

よくある問題：

• 「コマンドが見つかりません」 → npm i -g stellavault@latest
• 「API サーバーが見つかりません」 → npx stellavault graph
• グラフが空です → stellavault index
• 初回の実行が遅い → AI モデルを一度だけダウンロードします（約30MB）

コントリビューション

Issue とプルリクエストを歓迎します。始めるにはCONTRIBUTING.mdをご覧ください。脆弱性を責任を持って報告するには、SECURITY.mdをご覧ください。

ライセンス

MIT — 監査用にソースコード全体を公開しています。

リンク

• ⬇ デスクトップアプリをダウンロード
• ランディングページ
• Obsidian プラグイン
• npm
• GitHub リリース
• セキュリティポリシー