About SwarmVault
SwarmVault is a local-first tool that ingests documents, code, transcripts, notes and URLs and compiles them into a durable markdown wiki plus a machine-readable knowledge graph. It follows a pattern described by Andrej Karpathy for LLM-maintained wikis and is positioned as an Obsidian alternative for personal knowledge management and as a persistent memory store for coding agents such as Claude Code and Codex.
A vault on disk holds immutable raw sources, generated wiki pages, graph reports, a graph data file and a local search index. The quickstart command initializes a vault, ingests a file, directory or public GitHub repository, builds the wiki and graph, and opens a local graph viewer. A built-in heuristic provider runs offline without API keys for the first run, MCP server support lets agents query the vault, and context packs and review workflows are available for deeper use.
SwarmVault is a TypeScript project released under the MIT license, with documentation in English first and README translations in Chinese and Japanese. Since everything lives in files on your own machine, it is self-hosted by design.
Key features
- Ingests documents, code, transcripts and URLs
- Generates a markdown wiki from sources
- Builds a queryable local knowledge graph
- Local search index for retrieval
- Offline heuristic provider needs no API keys
- MCP server integration for AI agents
- Graph viewer and shareable summary cards
Good fit for
- →Personal knowledge management
- →Persistent memory for coding agents
- →RAG knowledge base over project docs
- Built with
- TypeScript
- Tags
- knowledge-graph
- local-first
- llm-wiki
- rag
- pkm
- mcp
- agent-memory
- markdown
SwarmVault: questions and answers
- What is SwarmVault used for?
- SwarmVault is a local-first, MIT-licensed knowledge base that turns documents, code and URLs into a markdown wiki and graph for people and AI agents. It is a good fit for personal knowledge management, persistent memory for coding agents and RAG knowledge base over project docs.
- Is SwarmVault open source?
- Yes. SwarmVault is open source under the MIT licence. Its source code is on GitHub at swarmclawai/swarmvault and is written mainly in TypeScript.
- Is SwarmVault free?
- Yes. SwarmVault is open source, so the software itself is free to use.
- Can I self-host SwarmVault?
- Yes. SwarmVault can be self-hosted on your own server or infrastructure.
- What is SwarmVault an alternative to?
- SwarmVault is an open-source alternative to Obsidian. Other open-source alternatives to Obsidian include NoteGen, Logseq and IWE.
- Is SwarmVault actively maintained?
- The most recent commit to SwarmVault was on 30 June 2026, and the latest release is v3.20.0, published on 12 June 2026. The project has 708 stars on GitHub.
Open-source alternatives to SwarmVault
See all
NoteGen
Note Taking
Capture first. Organize later. A local-first Markdown app that turns scattered records int
GPL-3.0vs Mem★ 13k
Logseq
Note Taking
A privacy-first, open-source platform for knowledge management and collaboration. Download
AGPL-3.0vs Notion★ 45k
IWE
Note Taking
Markdown knowledge graph — LSP for your editor, CLI + MCP memory for your AI agents
Apache-2.0vs Obsidian★ 1.7k
Foam
Note Taking
A personal knowledge management and sharing system for VSCode
OSSvs Roam Research★ 17k
Lumen
Note Taking
A free, open-source note-taking app that syncs with markdown files in your GitHub reposito
MITvs Obsidian★ 721
SiYuan
Note Taking
思源笔记 - 隐私优先的个人知识管理系统,支持 Markdown 排版、块级引用和双向链接
AGPL-3.0vs Notion★ 47k
SaaS alternatives to SwarmVault
See all
Obsidian
Note Taking
Obsidian is a free, flexible note-taking app for private notes, with plugins, linked notes and optional paid Sync and Publish services.
SaaS
Bear
Note Taking
Markdown notes app for Apple devices with tags and nested organization
SaaS
Capacities
Note Taking
Object-based notes where pages are typed items linked into a graph
SaaS
iA Writer
Note Taking
Minimal markdown writing app with focus mode and cross-device sync
SaaS
Inkdrop
Note Taking
Markdown note app with a plugin ecosystem aimed at developers
SaaS
NotePlan
Note Taking
Markdown notes, tasks and calendar app for Apple devices built around daily notes
SaaS

