Documentation

Context Vault docs

Everything to install Context Vault, connect it to Claude Code, Cursor, Codex or Windsurf, and keep your agent's memory useful.

Start here

One command installs the binary. A second connects it to your clients.

shell
curl -fsSL https://raw.githubusercontent.com/fellanH/context-vault/main/install.sh | sh
context-vault setup
Follow the five-minute guide

Guides

CLI commands

All 23 commands in context-vault 4.0.0, with the descriptions from the CLI's own help. Run context-vault --help for the full list and context-vault <command> --help for flags.

setupRegister the MCP server with AI tools
mcpMCP stdio server: what your client launches
doctorDiagnose the install: db and vault paths, engine health
statusPrint vault status: entry counts, health, resolved paths
statsPrint vault statistics as JSON
reindexRebuild the SQLite index from the markdown vault
vaultManage vaults in the ~/.context-mcp/vaults.json registry
schemaInspect or scaffold the per-vault taxonomy (vault.toml)
saveSave an entry to the vault
getRetrieve an entry by ID
searchHybrid full-text and semantic search
recallRecall hints from a raw signal: prompt text, an error message or a file path
listList all entries with optional filters
deleteDelete an entry by ID
moveMove a file or folder within the vault; never overwrites
ingestIngest from a URL
ingest-projectIngest from a project directory
archiveArchive entries by criteria
restoreRestore an archived entry
summarizeGenerate summaries for entries
tierAnalyze and apply tier reassignments
assembleAssemble context from related entries
session-end / recall-hint / post-tool-callHook targets for your client. Never fail loudly

MCP tools

Your agent calls these. You do not call them directly.

get_contextHybrid full-text and semantic search
save_contextSave or update an entry
list_contextBrowse entries by kind, tags and date
delete_contextRemove an entry by ID
ingest_urlFetch a page and save its readable content
ingest_projectScan a project directory into entries
recallLightweight hints from a prompt, an error message or a file path
session_endSave a session summary and discoveries
create_snapshotCompile entries on a topic into one brief
context_statusVault health, file counts, database size
list_bucketsList entries tagged as buckets

Get help