Veritas Vault
Local-first AI knowledge retention engine. Passively captures sessions from Antigravity and other AI tools, stores them in SQLite with RAG, and provides morning briefs, action items, and searchable memory.
Ask AI about Veritas Vault
Powered by Claude Β· Grounded in docs
I know everything about Veritas Vault. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
VERITAS VAULT v3.0
High-assurance AI knowledge engine that auto-captures, organizes, and intelligences your developer work across Antigravity, ChatGPT, and Gemini sessions.
Architecture
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β ELECTRON MAIN PROCESS β
β β
β main.js βββ Orchestrator (791L) β
β βββ db.js βββ SQLite CAS + MiniSearch (332L) β
β βββ archivist.js βββ Ingest Pipeline (297L) β
β βββ journal.js βββ Digest Engine (~2400L) β
β βββ vault-ai.js βββ 19 AI Ops via Ollama (829L) β
β βββ vault-rag.js βββ RAG Chat Engine (575L) β
β βββ capture-server.js βββ HTTP Relay (292L) β
β βββ followup-engine.js βββ Smart Alerts (305L) β
β βββ watcher.js βββ FS Watcher (81L) β
β βββ clipboard-monitor.js βββ Polling (68L) β
β βββ vault-logger.js βββ Structured Logging (~100L) β
β β
β preload.js βββ Secure IPC Bridge (55+ methods) β
β β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β RENDERER PROCESS β
β β
β renderer/index.html βββ 7 Panels + 4 Modals (343L) β
β renderer/app.js βββ Full UI Logic (~2500L) β
β renderer/styles/vault.css βββ Design System (71KB) β
β β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β BROWSER EXTENSION β
β β
β extension/content.js βββ DOM Scraper (14KB) β
β extension/background.js βββ HTTP Relay (9KB) β
β extension/popup.html/js βββ Config UI (13KB) β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
Features
Core Engine
- SQLite Content-Addressed Storage β WASM-based (sql.js), atomic write-temp-rename for crash safety
- MiniSearch Full-Text Index β Sub-millisecond fuzzy search with prefix matching
- SHA-256 Dedup β Content hashing on all ingested files, captures, and clipboard
- Incremental Corpus Scan β Only processes files modified since last scan
- 7-Day Auto-Backup β Daily timestamped DB backups with automatic rotation
AI Intelligence (Ollama qwen2.5:7b)
- 19 AI functions: summarize, classify, quality score, cluster, prioritize, enrich, extract actions
- Keyword/heuristic fallback when Ollama offline
- Learning loop with accept/reject feedback bias adjustment
- Auto-ingest pipeline: background FIFO queue for non-blocking capture processing
- Intelligence Sweep: 4-phase auto-orchestrator (re-summarize β enrich KIs β extract actions β auto-link)
RAG Chat
- Dual-mode: semantic (nomic-embed-text 768d vectors) + keyword fallback
- Crash-resilient indexing with checkpoint/resume
- Memory-efficient Float32Array embedding storage
- Cosine similarity retrieval β Top-8 chunks β Context injection β qwen2.5:7b synthesis
Capture Pipeline
- Chrome extension captures ChatGPT, Gemini, and Claude sessions
- Local HTTP server on 127.0.0.1:47831 with bearer token auth
- Rate limiting (30 req/min) + CORS restricted to chrome-extension:// origins
- Clipboard monitor: 2s polling with SHA-256 dedup and rate limiting
- Filesystem watcher: chokidar deep watch with 10-level depth
Smart Follow-Ups
- 5 proactive detectors: stale audits, abandoned tasks, unlinked captures, stale KIs, continuity gaps
- Dismissal persistence via SQLite
- Priority sorting (HIGH β MEDIUM β LOW)
Journal Engine
- Daily digest builder with session aggregation
- AI-powered morning brief with resume context and action items
- Activity momentum heatmap
- Pinned sessions with notes
- Quick notes per date
- Tamper-evident audit chain (SHA-256 hash chain)
UI (7 Panels)
- Journal β Morning brief, momentum heatmap, pinned sessions, daily timeline
- Search β Full-text fuzzy search with highlighted snippets
- Threads β Knowledge Item threads with KI Health Dashboard
- Tasks β Open task.md tracking with finalize/archive
- Intelligence β AI dashboard with auto-organize, clusters, priorities
- Ask β RAG chat with source citations and suggested queries
- Settings β Profile, capture config, AI model info, keyboard shortcuts
Stack
| Component | Technology |
|---|---|
| Runtime | Electron 34 |
| Database | sql.js (SQLite WASM) |
| AI | Ollama (qwen2.5:7b + nomic-embed-text) |
| Search | MiniSearch 7.x |
| FS Watch | Chokidar 4.x |
| Markdown | Marked 17.x + Highlight.js 11.x |
Security
- Context isolation + no node integration in renderer
- CSP:
default-src 'self'; script-src 'self' - 32-byte random bearer token auth on capture server
- Localhost-only server binding
- Atomic DB writes (temp β rename)
- Single instance lock
- 5MB request body limit
Installation
# Clone
git clone https://github.com/VrtxOmega/veritas-vault.git
cd veritas-vault
# Install dependencies
npm install
# Ensure Ollama is running with qwen2.5
ollama pull qwen2.5:7b
# Start the vault
npm start
Usage
Veritas Vault runs as an Electron desktop application. Once started:
- Dashboard β View session summaries, knowledge entries, and daily briefs
- RAG Chat β Query your captured knowledge with semantic search
- Journal β Browse auto-generated digest entries
- Watcher β Monitors filesystem changes and captures context
- Clipboard Monitor β Auto-captures copied text for knowledge retention
The vault passively captures your work sessions, indexes them with MiniSearch FTS and Ollama embeddings, and generates morning briefs with actionable intelligence.
π Read the master narrative: Why Sovereign AI?
π VERITAS Omega Ecosystem
This project is part of the VERITAS Omega Universe β a sovereign AI infrastructure stack.
- VERITAS-Omega-CODE β Deterministic verification spec (10-gate pipeline)
- omega-brain-mcp β Governance MCP server (Triple-A rated on Glama)
- Gravity-Omega β Desktop AI operator platform
- Ollama-Omega β Ollama MCP bridge for any IDE
- OmegaWallet β Desktop Ethereum wallet (renderer-cannot-sign)
- veritas-vault β Local-first AI knowledge engine
- sovereign-arcade β 8-game arcade with VERITAS design system
- SSWP β Deterministic build attestation protocol
License
BSL-1.1
