The local-first second brain that Claude remembers. Karpathy's self-compiling wiki × Zettelkasten — fully local, vault-safe, and MCP-native.
Agenten stärken
Der eigene Befehl des Herausgebers. Kein PlugMCP-Endpunkt.
Host a copy with our keys and logs.
npx -y [email protected]Claude Code hat keinen Installationslink für einen lokalen Befehl. Kopieren Sie den Befehl unten und führen Sie ihn in einem Terminal aus.
STELLAVAULT_DB_PATH=<value> claude mcp add io.github.evanciel-stellavault -- npx -y stellavault@0.9.0In einem Terminal ausführen.
{ "mcpServers": { "io.github.evanciel-stellavault": { "command": "npx", "args": [ "-y", "[email protected]" ], "env": { "STELLAVAULT_DB_PATH": "<value>" } } }}claude_desktop_config.json
Remote-URL oder ein Befehl auf Ihrem Rechner? Worin sich die beiden Installationen unterscheiden
Auf PlugMCP ausführen
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
StartenOne command to let Claude read your vault:
npx -y stellavault setup # wires the MCP server into Claude Code / Desktop, Cursor, Windsurf, or VS CodeClaude Code user? Install the plugin instead — the MCP server plus
/vault-ask,/vault-review,/vault-decisionskills, in two commands:/plugin marketplace add Evanciel/stellavault /plugin install stellavault@stellavault
A second brain that compiles itself. Stellavault fuses two ideas about how knowledge should live and grow:
raw/, then compiled into a clean _wiki/ of concepts and backlinks. Your knowledge re-compiles itself as it grows, instead of rotting in a folder.[[wikilinks]], and emergent connections, so a web of ideas (not a folder tree) becomes the real structure of how you think.The result is one local-first knowledge tool — a full markdown editor, a 3D neural graph, hybrid AI search, and spaced-repetition memory decay — shipped as a desktop app, CLI, Obsidian plugin, and MCP server that lets Claude read your entire vault. No cloud, no API keys, and your original files are never modified.
Highlights · Why Stellavault? · Install · Editor · Pipeline · Intelligence · Search & Ranking · MCP Integration · 3D Visualization · Configuration · Performance · Tech Stack · Security · Troubleshooting
raw/, then compiles a clean _wiki/ with concepts and backlinks. Knowledge that organizes itself as it grows.[[wikilinks]] / #tags with weighted RRF, then re-ranks by an FSRS memory model so what you're actually using resurfaces. 50+ languages, fully local, zero API keys.Most tools make you choose between writing, searching, and remembering. Stellavault does all three — locally, and in a way Claude can read.
[!NOTE] Not either/or — Stellavault even runs inside Obsidian as a plugin. Keep your editor; add a brain.
[!TIP] Download → Unzip → Run
stellavault.exe(Windows) orstellavault(Linux) → Pick your notes folder → Done.
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
Requires Node.js 20+. Run
stellavault doctorto diagnose issues.
main.js + manifest.json + styles.css from stellavault-obsidian releases.obsidian/plugins/stellavault/npx stellavault graph in your vault folderFull-featured markdown editor — on par with Obsidian.
Capture ──→ Organize ──→ Distill ──→ Express
Drop anything → auto-extract → raw/ → compile → _wiki/ → draft
Inspired by Karpathy's self-compiling knowledge architecture.
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)
Or use the Express tab in the desktop app — enter a topic, pick a format, and generate a draft grounded in your vault. Save to _drafts/ and edit inline.
These features do not exist in Obsidian — even with plugins.
Hybrid retrieval that fuses multiple signals with weighted Reciprocal Rank Fusion (RRF) — tuned for a personal knowledge vault, fully local, zero API keys:
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"]
}
}
}
Listed on the MCP registry as io.github.Evanciel/stellavault (also discoverable via Glama, Smithery, and mcp.so).
Claude can search, ask, draft, lint, and analyze your vault directly. Search runs the full hybrid pipeline — weighted RRF over semantic + BM25 + entity-linking, plus FSRS recency and session-adaptive reranking (see Search & Ranking).
[Cluster | All nodes] toggle switches to the dense raw view
without reload, and clicking a super-node drills into that cluster's membersThe 3D graph renderer is bounded by two environment knobs (set them in the environment
before launching stellavault graph):
Why the caps matter. Edge construction is an inline O(n²) all-pairs cosine loop —
n·(n-1)/2 pairs, each over 384 dims (see packages/core/src/api/graph-data.ts, the
neighbors loop). At cap=3000 that is ~4.5M pairs (the multi-second build the 5-minute
server cache absorbs); raising toward 13000 is ~84M pairs = minutes of build plus a
multi-GB intermediate array that freezes the single-threaded Express handler (there is no
worker). The raw "All nodes" path is the expensive direction (it runs the full cap), so the
server clamps the requested ?cap per view (raw ≤ 4000, cluster ≤ 6000, rounded) to bound
both build cost and cache cardinality.
Even the default cluster view is cheap to RENDER, not to BUILD. The first uncached fetch of either view runs the scoped-embedding load + the O(n²) cosine pass + k-means + a force settle on a single thread, stalling the handler for seconds. The viewer shows a loading state on the toggle so the tap isn't silently swallowed during that cold build.
npx stellavault index --vault ./examples/demo-vault # Index 10 sample notes
npx stellavault search "vector database" # Semantic search
npx stellavault graph # 3D graph visualization
The demo vault includes interconnected notes about Vector Databases, Knowledge Graphs, Spaced Repetition, RAG, MCP, and more — perfect for exploring all features instantly.
Ctrl+P for quick file switchingnpm 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 reads ./.stellavault.json (or ~/.stellavault.json). Search ranking is fully tunable — sensible defaults work out of the box:
{
"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)
}
}
Environment variables override config (parsed with guards):
Note: cross-lingual recall (e.g. a Korean query finding English notes) is handled automatically by the multilingual embedding model —
entityAliasesis an optional precision boost for the curated entity graph (tags / wikilinks) and abbreviations.
Tested on synthetic vaults — all operations under 1 second for typical use cases:
Run your own benchmarks:
node tests/stress.mjs 500 # Test with 500 synthetic documents
Key optimizations:
--aiX-Stellavault-Token). Token endpoint is same-origin-onlylocalhost / 127.0.0.1 only by default; MCP HTTP transport opt-inPeer-to-peer semantic search is shipped as an opt-in experimental feature. The default install does not join any swarm and never shares data.
Enable explicitly:
# PowerShell
$env:STELLAVAULT_FEDERATION_EXPERIMENTAL = "1"
# bash / zsh
export STELLAVAULT_FEDERATION_EXPERIMENTAL=1
stellavault federate join
When enabled, federation uses Ed25519 identities with signed envelopes, mutual challenge-response handshake, per-envelope replay nonces, handshake timeout, per-peer rate limiting, and a receive-only sharing default (myNodeLevel=0). Run set-level 1+ in the federation prompt to actually share titles/snippets with peers.
[!WARNING] Upgrade note (v0.7.4) — federation wire format bumped from v2.0 to v2.1 (envelope-level nonce). v0.7.3 federation nodes are not compatible. Existing
~/.stellavault/federation/sharing.jsonfiles are not auto-downgraded to the safer defaults; review yourmyNodeLevelif you previously opted in.
See SECURITY.md for full details.
stellavault doctor # Check config, vault, DB, model, Node version
Common issues:
npm i -g stellavault@latestnpx stellavault graphstellavault indexIssues and pull requests are welcome. See CONTRIBUTING.md to get started, and SECURITY.md to report a vulnerability responsibly.
MIT — full source code available for audit.
Found this useful? ⭐ Star Stellavault — it genuinely helps the project reach more people who think in connected notes.
Built with ✦ for second-brain builders. · Download · Connect Claude · Report an issue
Local-first MCP server: Claude searches, asks & drafts from your Obsidian vault. 21 tools, no keys.
{ "mcpServers": { "io.github.evanciel-stellavault": { "command": "npx", "args": [ "-y", "[email protected]" ], "env": { "STELLAVAULT_DB_PATH": "<value>" } } }}Tools
Noch keine Tool-Liste. Remote-Server erhalten eine nach dem ersten Health-Check.
FAQ
Kopieren Sie auf dieser Seite die stdio-Konfiguration für Cursor, Claude Desktop, Claude Code oder VS Code. Sie nutzt die Installation des Herausgebers, keinen PlugMCP-Proxy.
Der Herausgeber nennt diese Umgebungsvariablen: STELLAVAULT_DB_PATH.
Stellavault läuft lokal über stdio.
Zuletzt geprüft: 2026-11-09. Local-first MCP server: Claude searches, asks & drafts from your Obsidian vault. 21 tools, no keys.