Feature overview
Ghost Vault is a Postgres-backed service for durable, retrievable memory with a small surface area: HTTP REST and OpenAPI, MCP for tool hosts, and a gvctl CLI. Below is a concise map; authoritative detail stays in the repository.
Hybrid retrieval
Vector, text, and fusion—not a single monolithic index.
pgvector and full-text search work together with weighted gated fusion so results reflect both semantic and lexical signals. You store once; the pipeline decides how to rank what comes back.
Encryption at rest (optional)
Turn on with GV_ENCRYPTION=on|off—immutable per database.
When enabled, the vault’s encryption mode is fixed for the lifetime of that database, so operators never silently drift between cleartext and encrypted stores. Pick a mode when you create the environment and keep recovery processes aligned.
HTTP tools & MCP
OpenAPI for product integrations; MCP for host apps.
OpenAPI definitions support ChatGPT Actions and Gemini tool wiring (same REST contract as HTTP—set servers[0].url to your public HTTPS API base, then Bearer from unlock). gvmcp exposes the same capabilities over MCP for Cursor, Claude Desktop, and other MCP clients—configure base URL, bearer token, and optional default vault and user scope. Tutorial: OpenAPI & HTTP tools and Anthropic hosted connector.
A single edge entry (for example in Docker) can front /api to the server, /mcp/ to gvmcp, and optional dashboard paths—see the repo’s compose and edge templates.
gvctl & runtime
CLI, Docker, or plain Go for day-to-day use.
gvctl wraps health checks, init, unlock, retrieve, and other flows against the REST API. make up with Docker brings Postgres, the server, MCP, and optional dashboard together; go run ./cmd/gvsvd is there when you only need the API against a local database.
GitS context
Ghost Vault complements the GitS agent stack.
For multi-agent orchestration, worlds, and the Ghost engine, see GitS (Ghost in the Shell). Blog posts and contact for both projects are hosted on the GitS site so (blog, contact) use one site namespace.