Novyx Vault

Novyx Vault

Open-source second brain with AI memory that actually persists. Most note AIs retrieve context. Vault also builds memory that persists.

Try it free  ·  Website  ·  Discord  ·  Contributing  ·  Changelog

---

The problem

Many AI note tools and Obsidian plugins mostly search your notes when you ask a question (RAG). Without a durable memory layer, a new session has to reconstruct context from scratch.

Novyx Vault is different. Your AI builds persistent memory from your notes and conversations — memory that survives sessions, consolidates over time, and can be rolled back when it goes wrong. The longer you use it, the smarter it gets.

What makes it different

| | Novyx Vault | Obsidian | |---|---|---| | AI remembers across sessions | With Novyx memory configured | No native equivalent | | Memory rollback & audit trail | Built in | No | | AI discovers hidden connections | Built in (Ghost Connections) | No | | Bring your own AI provider | Built in | Plugin-dependent | | Open source | MIT | Source-available | | Desktop-local files | Yes (Tauri desktop) | Yes | | Markdown files | Yes | Yes | | Knowledge graph | Yes | Yes |

Quick start

Use it now (no install)

vault.novyxlabs.com — sign in with GitHub or Google. Free.

Self-host (3 commands)

git clone https://github.com/novyxlabs/novyx-vault.git
cd novyx-vault
npm install && npm run dev

Open http://localhost:3000. Notes, wiki-links, and the knowledge graph work immediately. AI chat and persistent memory require your AI provider and Novyx memory keys.

Requires Node.js 20.9.0 or newer.

Add persistent AI memory (optional):

echo "NOVYX_MEMORY_API_KEY=your_key" > .env.local

Add a Novyx API key from novyxlabs.com to unlock cross-session memory, rollback, ghost connections, and cortex insights.

Docker (one command)

docker run -p 3000:3000 ghcr.io/novyxlabs/novyx-vault

Desktop app (Tauri)

npm run tauri:dev    # development with hot reload
npm run tauri:build  # production build

Requires Rust.

---

Features

Persistent AI memory

The core differentiator. Powered by Novyx Core.

• Cross-session memory — Your AI remembers projects, preferences, and decisions from every past session. Ask about something from last month and it responds with full context.
• Ghost Connections — AI discovers hidden relationships between notes without shared keywords or explicit links.
• Memory timeline & rollback — See what your AI learned and when. Roll back to any point in time.
• Cortex insights — AI surfaces emerging themes and patterns from your accumulated knowledge.
• Entity extraction — People, projects, and concepts extracted into a semantic knowledge graph.
• Audit trail — Every memory operation logged with hash-chain verification.

Notes & editor

• Markdown editor — CodeMirror 6 with live preview, syntax highlighting, keyboard shortcuts. Plain .md files, no lock-in.
• Wiki-links & backlinks — [[wiki-links]] with automatic bidirectional backlinks.
• Knowledge graph — Interactive force-directed graph of your entire vault.
• Folders, tags & search — Nested folders, inline tags, full-text search, pinned favorites.

AI writing tools

• Voice capture — Record and transcribe on-device or via cloud. AI structures transcripts into clean notes.
• Brain dump — Paste raw thoughts, get structured notes back.
• Clip remix — Paste web content, get it rewritten in your voice.
• Slash commands — Inline AI anywhere in the editor.
• Weekly review — Automated summary of your writing activity.
• Writing coach — AI feedback on clarity, structure, and tone.

AI providers (BYOK)

Vault ships 21 hosted and local provider presets: OpenAI, Anthropic, Google Gemini, Moonshot/Kimi Global, Moonshot/Kimi China, MiniMax, Groq, Together, Mistral, xAI Grok, Perplexity, Cohere, Nvidia NIM, Hyperbolic, Ollama, LM Studio, DeepSeek, Cerebras, SambaNova, OpenRouter, and Fireworks.

Keys are encrypted at rest in cloud mode and stay on your device in desktop mode. Switch providers without losing memory or notes.

Desktop-local & open source

• Desktop app — Native via Tauri (macOS, Windows, Linux). Notes stored as plain markdown in ~/SecondBrain/. Core note editing works offline.
• Cloud mode — Optional Supabase-powered hosted mode with auth, sharing, and publishing.
• MIT licensed — Inspect, contribute, or self-host.

---

Importing from Obsidian

Already have an Obsidian vault? Vault imports your notes, preserves wiki-links, and adds persistent AI memory on top.

Settings → Import → Obsidian → Select your vault folder

---

MCP integration

The same Novyx memory works across Vault, Claude Code, Cursor, and any MCP-compatible tool.

pip install novyx-mcp
claude mcp add novyx-memory -- python -m novyx_mcp

Memories created in Claude Code appear in Vault. Memories from Vault are available to your coding agent. One API key, one memory, everywhere.

---

Cloud deployment

Cloud mode adds auth, account-backed storage, sharing, and publishing via Supabase.

Environment variables

| Variable | Required | Description | |----------|----------|-------------| | STORAGE_MODE | Cloud only | Set to supabase for cloud mode | | NEXT_PUBLIC_SUPABASE_URL | Cloud only | Supabase project URL | | NEXT_PUBLIC_SUPABASE_ANON_KEY | Cloud only | Supabase anonymous key | | SUPABASE_SERVICE_ROLE_KEY | Cloud only | Server-side key. Never expose to client. | | NOVYX_MEMORY_API_KEY | Desktop | Personal Novyx API key | | NOVYX_ADMIN_KEY | Cloud only | Admin key for per-user provisioning | | UPSTASH_REDIS_REST_URL | Production | Redis for rate limiting. Production fails closed without this. | | UPSTASH_REDIS_REST_TOKEN | Production | Redis auth token. Production fails closed without this. | | NEXT_PUBLIC_SENTRY_DSN | Optional | Enables Sentry runtime error capture | | SENTRY_UPLOAD_SOURCEMAPS, SENTRY_ORG, SENTRY_PROJECT, SENTRY_AUTH_TOKEN | Optional | Set SENTRY_UPLOAD_SOURCEMAPS=1 with the other Sentry values to upload production source maps |

Deploy

npm run build

Or connect to Vercel for automatic deployments.

---

Scripts

| Command | Description | |---------|-------------| | npm run dev | Development server | | npm run build | Production build | | npm run start | Production server | | npm run lint | ESLint | | npm run test | Playwright E2E tests | | npm run test:unit | Vitest unit tests | | npm run test:cloud-smoke | Opt-in Playwright smoke test against a deployed cloud URL | | npm run tauri:dev | Tauri desktop dev | | npm run tauri:build | Tauri desktop build |

npm run test:cloud-smoke requires CLOUD_SMOKE_BASE_URL, CLOUD_SMOKE_EMAIL, and CLOUD_SMOKE_PASSWORD. Use a disposable cloud account because the suite creates, publishes, unpublishes, deletes, and purges a note under Smoke Tests/.

Tech stack

Next.js 16 · React 19 · TypeScript · Tailwind CSS 4 · CodeMirror 6 · Novyx SDK · Supabase · Tauri v2

51 components · 72 API routes · 21 AI provider presets

Project structure

app/              Next.js app router (pages + API routes)
components/       React components
lib/              Storage adapters, Novyx client, providers, transcription
public/           Static assets
src-tauri/        Tauri desktop app (Rust)
tests/            Playwright E2E + Vitest unit tests

---

Contributing

Contributions welcome! See [CONTRIBUTING.md](CONTRIBUTING.md).

git clone https://github.com/novyxlabs/novyx-vault.git
cd novyx-vault
npm install
npm run dev

License

[MIT](LICENSE)

---

Built by Novyx Labs

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: novyxlabs
• Source: novyxlabs/novyx-vault
• License: MIT
• Homepage: https://vault.novyxlabs.com

Install and usage instructions live in the source repository linked above.