AgentVault

Local-first knowledge operating system for notes, decisions, and agent-readable context.

Visit live site ↗ github.com/dporkka/agentvault

◇ Problem

Notes, decisions, research, and tasks live in silos — some in Notion, some in markdown files, some in chat history. AI assistants can't see any of it without manual copy-paste.

◆ Solution

AgentVault keeps knowledge in plain Markdown with YAML frontmatter, indexed by SQLite for fast full-text and semantic search. A single API contract powers CLI, desktop, web, browser extension, and mobile clients — and exposes the vault to AI agents via MCP tools.

◇ Role

Solo founder — system architecture, Go core, TypeScript clients, MCP server, CI/CD, and documentation.

◆ Metrics

Multi-client: CLI, desktop, web, extension, mobile
Structured note types with YAML frontmatter templates
Full-text + vector hybrid search
MCP server for AI agent integration

Impact

Built a local-first knowledge OS that treats Markdown as the durable source of truth and SQLite as a rebuildable cache, making personal knowledge agent-readable without lock-in.

System design

Go core indexes Markdown → SQLite with FTS5 + optional embeddings. A shared API contract keeps CLI, HTTP API, MCP server, and all TypeScript clients (desktop, web, extension, mobile) in sync. AI layer retrieves relevant notes first, then answers with citations.

Highlights

Markdown-native vault — no lock-in, full git-friendly
Full-text, vector, and hybrid search via SQLite FTS5 + embeddings
Structured note types: note, decision, task, meeting, source, project
Source-grounded AI with citations via `agentvault ask`
Multi-client: CLI, desktop (Wails), web, browser extension (MV3), mobile (Expo)
Local-first — everything runs on your machine by default

Stack

GoTypeScriptReactWailsSQLiteMCPOllama

Browse project vault

Other projects

View all →

PRJ-001LIVE

AgentVault

Other projects

Adacavo

Chão Bom · Cape Verde

Tramote

O-Chem Shop

Boardzie

Nulango