# Novyx Vault > Local-first markdown workspace with AI memory, rollback, audit trails, knowledge graph, and desktop/cloud modes. - **Type:** MCP server - **Install:** `agentstack add mcp-novyxlabs-novyx-vault` - **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior - **Seller:** [novyxlabs](https://agentstack.voostack.com/s/novyxlabs) - **Installs:** 0 - **Category:** [Databases](https://agentstack.voostack.com/c/databases) - **Latest version:** 0.1.0 - **License:** MIT - **Upstream author:** [novyxlabs](https://github.com/novyxlabs) - **Source:** https://github.com/novyxlabs/novyx-vault - **Website:** https://vault.novyxlabs.com ## Install ```sh agentstack add mcp-novyxlabs-novyx-vault ``` Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent. ## About 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](https://vault.novyxlabs.com)** — sign in with GitHub or Google. Free. ### Self-host (3 commands) ```bash git clone https://github.com/novyxlabs/novyx-vault.git cd novyx-vault npm install && npm run dev ``` Open [http://localhost:3000](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):** ```bash echo "NOVYX_MEMORY_API_KEY=your_key" > .env.local ``` Add a Novyx API key from [novyxlabs.com](https://novyxlabs.com) to unlock cross-session memory, rollback, ghost connections, and cortex insights. ### Docker (one command) ```bash docker run -p 3000:3000 ghcr.io/novyxlabs/novyx-vault ``` ### Desktop app (Tauri) ```bash npm run tauri:dev # development with hot reload npm run tauri:build # production build ``` Requires [Rust](https://rustup.rs/). --- ## Features ### Persistent AI memory The core differentiator. Powered by [Novyx Core](https://novyxlabs.com). - **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. ```bash 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 ```bash npm run build ``` Or connect to [Vercel](https://vercel.com) 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). ```bash 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](https://github.com/novyxlabs) - **Source:** [novyxlabs/novyx-vault](https://github.com/novyxlabs/novyx-vault) - **License:** MIT - **Homepage:** https://vault.novyxlabs.com Install and usage instructions live in the source repository linked above. ## Pricing - **Free** — Free ## Security capabilities Automated source analysis of v0.1.0 — what this tool can access: - **Network access:** no - **Filesystem access:** no - **Shell / process execution:** no - **Environment & secrets:** yes - **Dynamic code execution:** no *"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.* ## Versions - **0.1.0** — security scan: passed — Imported from the upstream source. ## Links - Listing page: https://agentstack.voostack.com/l/mcp-novyxlabs-novyx-vault - Seller: https://agentstack.voostack.com/s/novyxlabs - Browse the marketplace: https://agentstack.voostack.com/browse --- Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.