ctxvault

Overview

CtxVault is a local memory infrastructure that organizes knowledge into isolated vaults with explicit types. It offers semantic vaults for document storage and retrieval, and skill vaults for procedural memory. The system provides structural isolation and access control, ensuring agents only access designated memory spaces. CtxVault integrates through CLI, HTTP API, and MCP server interfaces, supporting persistent memory across sessions and human observability.

Try asking AI

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

• list_vaults

  List all available vaults

  Try:Show me all my vaultsTry:List available vaults
• query

  Query a vault semantically for relevant content

  Try:Query my vault for information about transformer architectureTry:Search in financial-vault for budget constraints
• write

  Write content to a vault as a new document

  Try:Write this session notes to my vaultTry:Store this information in the project vault
• list_docs

  List all documents in a vault

  Try:Show all documents in my vaultTry:What files are stored in research-vault?
• init

  Initialize a new vault

  Try:Create a new vault called project-notesTry:Initialize a semantic vault for my research
• attach

  Attach an agent to a vault, granting access

  Try:Allow agent-alpha to access shared-vaultTry:Attach my agent to the restricted vault

Comparable tools

Installation

pip install ctxvault

git clone https://github.com/Filippo-Venturini/ctxvault
cd ctxvault
uv sync            # creates .venv and installs all dependencies
uv run ctxvault    # run the CLI

{
  "mcpServers": {
    "ctxvault": {
      "command": "ctxvault-mcp"
    }
  }
}

FAQ

What makes CtxVault different from traditional vector databases?

CtxVault provides structural isolation between vaults, typed memory (semantic vs procedural), access control, and human observability through a simple file system interface.

Can I use CtxVault with any AI client?

Yes, CtxVault provides MCP server integration for seamless use with Claude Desktop, Cursor, and any other MCP-compatible client.

Compare ctxvault with