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
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 734 stars on GitHub, with 22 added in the last 30 days.
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★ 46k
IWE
Note Taking
Markdown knowledge graph — LSP for your editor, CLI + MCP memory for your AI agents
Apache-2.0vs Obsidian★ 1.8k
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★ 722
SoloMD
Note Taking
A markdown editor — and the bridge to your LLM. Local-first, MIT, ~15 MB. Bundled MCP serv
MITvs Typora★ 1.6k
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
Knotpad
Note Taking
Turns plain notes into managed tasks and doubles as a self-documenting project knowledge base
SaaS
mdedit.ai
Note Taking
AI-powered, offline-first Markdown editor for developers, students, researchers and technical writers
SaaS
Agenda
Note Taking
Date-focused notes app that links notes to calendar events and projects
SaaS
Amplenote
Note Taking
Notes and tasks app with backlinks and calendar scheduling
SaaS
Bear
Note Taking
Markdown notes app for Apple devices with tags and nested organization
SaaS

