swarmvault

Overview

SwarmVault follows Andrej Karpathy's three-layer architecture pattern to create a local-first knowledge management system. It transforms raw documents into a structured wiki and knowledge graph that can be queried, visualized, and used by AI agents. The system supports 30+ input formats, works offline with optional cloud integration, and includes features like contradiction detection, approval workflows, and automated graph visualization.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• queryquery <query-string>

  Query the knowledge base for information

  Try:What are the key concepts?Try:What is the auth flow?
• graphgraph <subcommand>

  Interact with the knowledge graph

  Try:Show me the graphTry:Explain the connections between concepts
• ingestingest <source-path>

  Add documents to the knowledge vault

  Try:Ingest meeting transcriptTry:Add documentation from source files
• compilecompile

  Compile the wiki and graph from ingested sources

  Try:Compile all sourcesTry:Compile with conflict checking
• nextnext

  Show the best next action for the vault

  Try:What should I do next?Try:Check vault status
• exportexport <format> --out <output-path>

  Export knowledge in different formats

  Try:Export for AI agentsTry:Export to Neo4j
• contextcontext build <task> --target <path> --budget <tokens>

  Build bounded agent context for specific tasks

  Try:Build context for auth refactorTry:Create context for feature implementation
• tasktask start <description> --target <path> --agent <agent>

  Record task history for the vault

  Try:Start implementing auth refactorTry:Begin code review process
• chatchat <query>

  Keep a conversation about the vault

  Try:How should the next agent use this vault?Try:Explain this concept
• sourcesource <subcommand>

  Manage registered sources

  Try:Add a new sourceTry:List all registered sources
• doctordoctor

  Check vault health and repair issues

  Try:Check vault healthTry:Repair inconsistencies
• lintlint <options>

  Audit the vault for issues

  Try:Check for contradictionsTry:Lint the entire vault

Note: Tools extracted from explicit CLI command documentation in the README

Comparable tools

Installation

npm install -g @swarmvaultai/cli

{
  "mcpServers": {
    "swarmvault": {
      "command": "npx",
      "args": ["@swarmvaultai/cli", "mcp"]
    }
  }
}

FAQ

Is SwarmVault truly offline-capable?

Yes, SwarmVault includes a built-in heuristic provider that works fully offline without API keys. Cloud providers are optional enhancements.

How does SwarmVault handle hallucinations?

SwarmVault tags each edge as 'extracted', 'inferred', or 'ambiguous', includes contradiction detection flags, and provides approval queues for review before compilation.

Compare swarmvault with