Stellavault

Drop anything. It compiles itself into knowledge. Claude remembers everything you know.

Self-compiling Zettelkasten MCP server. Ingest PDFs, YouTube, documents — auto-organized into linked wiki. Claude accesses your entire knowledge base. Your vault files are never modified.

Your vault as a neural network. Local-first, no cloud required.

Two Core Ideas

1. "Drop it and forget it" (Inspired by Karpathy's Self-Compiling Knowledge)

Any input → auto-classify → raw/ → compile → wiki → connected knowledge

PDF, DOCX, PPTX, XLSX, YouTube (with transcript), URL, text — everything goes through the same pipeline. You never manually organize.

2. "Claude remembers what you know" (MCP Integration)

claude mcp add stellavault -- stellavault serve

Claude searches, asks, drafts from your vault directly. Local-first — no data leaves your machine.

5-Minute Setup

npm install -g stellavault
stellavault init          # Interactive setup + vault indexing
stellavault graph         # Launch 3D graph + API server

Prerequisites: Node.js 20+

Upgrading from 0.4.x / 0.5.0 / 0.5.1 / 0.5.2 / 0.5.3? Earlier releases had three showstopper packaging bugs: the stellavault bin shim wasn't created after install (0.4.x–0.5.1), the 3D graph UI wasn't bundled (0.4.x–0.5.2), and the SPA fallback was hijacking /sw.js and /manifest.json causing PWA install errors (0.5.3). v0.5.4 fixes all of these and is verified end-to-end with Playwright (9/9 checks) — install, bin link, graph UI, node click, federation toggle, PWA assets, zero console errors. Reinstall: npm i -g stellavault@latest.

The Pipeline

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

stellavault ingest <anything>     # PDF, DOCX, URL, YouTube, text
  → auto-extract text             # unpdf, mammoth, yt-dlp
  → raw/ (fleeting)               # Zettelkasten inbox
  → compile → _wiki/              # Auto: concepts + backlinks
  → stellavault draft "topic"     # Blog, report, or outline

Ingest Anything

Express: Get Knowledge Out

stellavault draft "AI"                    # Rule-based scaffold (free)
stellavault draft "AI" --ai               # Claude API writes full draft ($0.03)
stellavault draft "AI" --format report    # Formal report format
stellavault draft --format outline        # All-knowledge outline

Or in Claude Code: "Write a blog post about machine learning from my notes" — Claude uses MCP generate-draft tool (free, no API key).

Self-Evolving Memory (Karpathy's Compounding Loop)

Session → session-save → daily-log → flush → wiki
  ↑                                            ↓
  └──── Claude reads wiki via MCP (20 tools) ←─┘

Every conversation makes your knowledge base smarter:

# Auto-capture session summary to daily log
echo "Decided to use JWT. Lesson: never store tokens in localStorage" | stellavault session-save

# Flush daily logs → extract concepts → rebuild wiki
stellavault flush

# Or set up Claude Code hooks for full automation
# See: docs/hooks-setup.md

Daily Commands

stellavault ask "What did I learn about X?"   # Q&A from vault
stellavault brief                              # Morning knowledge briefing
stellavault decay                              # What's fading from memory?
stellavault lint                               # Health score (0-100)
stellavault learn                              # AI learning path
stellavault flush                              # Daily logs → wiki compilation
stellavault digest --visual                    # Weekly Mermaid chart report

MCP Tools (21)

Self-Evolving Commands

stellavault session-save              # Capture session summary to daily log
stellavault flush                     # Daily logs → wiki (Karpathy compile)
stellavault promote note.md --to lit  # Upgrade note stage
stellavault autopilot                 # Full cycle: inbox → compile → lint → archive

Zettelkasten (Luhmann + Karpathy)

stellavault fleeting "raw idea"                # → raw/
stellavault ingest report.pdf                  # → auto text extract → raw/
stellavault compile                            # → raw/ → _wiki/ (concepts + backlinks)
stellavault promote note.md --to permanent     # Upgrade stage
stellavault autopilot                          # Full cycle: inbox → compile → lint → archive

• 3-stage flow: fleeting → literature → permanent
• Luhmann index codes: auto-assigned (1A → 1A1)
• Frontmatter-first scanning: 10x token reduction
• Configurable folders: override raw/_wiki/_literature/ in .stellavault.json

{
  "vaultPath": "/path/to/vault",
  "folders": {
    "fleeting": "01-Inbox",
    "literature": "02-Reading",
    "permanent": "03-Notes",
    "wiki": "04-Wiki"
  }
}

Intelligence

3D Visualization

• Neural graph with cluster coloring
• Constellation view (MST star patterns)
• Heatmap overlay (activity score)
• Timeline slider (creation/modification filter)
• Decay overlay (fading knowledge)
• Multiverse view — your vault as a universe in a P2P network
• Dark/Light theme
• Mobile responsive + PWA installable

Multiverse — P2P Knowledge Federation

"Your universe floats alone — for now."

Your vault is a universe. Connect with others through P2P federation.

From the web UI (easiest): open stellavault graph, then click the Offline · Join badge in the top-left header. Live peer count, one-click disconnect, and a popover showing connected peers.

From the CLI:

stellavault federate join    # Connect to the Stella Network
stellavault federate status  # See connected peers

How it works:

• Hyperswarm P2P — NAT-traversal mesh networking, no central server
• Embeddings only — your original text never leaves your machine
• Differential privacy — mathematical privacy guarantees
• Trust & reputation — good knowledge earns credits
• Federated search — search across connected vaults via MCP

The Multiverse view shows your universe and connected peers as neighboring constellations in 3D. Click to explore their shared knowledge.

Tech Stack

Full Feature List

Security

Your vault files are never modified. Stellavault is local-first — no data leaves your machine unless you explicitly use --ai (Anthropic API).

See SECURITY.md for full details.

License

MIT — full source code available for audit.

Links

• Landing Page
• Obsidian Plugin
• npm
• GitHub Releases
• Security Policy