Context Vault — Open Source

Create a local context vault any AI agent can use. Local-first, no account required. Optional cloud login connects to a hosted Metis workspace.

npm i -g contextvault
cv init                      # create a vault on this machine (no cloud, no login)
cv push ./notes.md notes     # add a document
cv ls                        # browse it
cv agent register "My Bot"   # mint a scoped key for a local agent
cv mcp                       # expose the vault over MCP for Claude/Cursor/etc.

What it is

A content-addressed graph filesystem for context: every artifact (docs, code, decisions) is versioned, permissioned, and linked by typed edges, with append-only provenance. Agents get a typed API; you get a normal vault.

• Local-first. cv init runs a daemon on 127.0.0.1 with SQLite storage — your data never leaves the machine.
• Any AI agent. cv mcp starts an MCP server (stdio) so Claude Desktop / Claude Code, Cursor, and any MCP client connect natively. Non-MCP agents can use the HTTP API with a cv_ token.
• Governed agents. Agent keys default to create + revise-own — they can add documents and revise their own work, but can't edit yours, delete, or move. Tune per-agent with cv agent perms.
• Optional cloud. cv login connects to a hosted Context Vault workspace; cv use switches between local and cloud profiles.

Commands

| Command | What it does | |---------|--------------| | cv init [path] | Create + start a local vault | | cv ls [path] · cv cat <uri> | Browse / read | | cv push <file> [dest] | Add a document | | cv watch <dir> --to <path> | Live-sync a folder (also watch list/stop, --background) | | cv agent register <name> | Mint a local agent key | | cv agent perms <id> | View / edit an agent's capabilities | | cv mcp | Start the MCP server (stdio) | | cv local status\|stop\|logs | Manage the background local daemon | | cv login / cv use <id> | Connect to / switch to a cloud workspace |

All commands accept --json and --quiet for agent/script use (or set CONTEXTVAULT_JSON=1 / CONTEXTVAULT_QUIET=1).

License

Apache-2.0.