Skip to content

Z-Ghostshell/GhostVault

Repository files navigation

Ghost Vault

local memory for your models
Ghost Vault

Your memory, your machine — the durable record of your work lives in a layer you govern, not as a retention feature in someone else’s account. Ghost Vault is a user-held memory service: connect the same vault to Claude, ChatGPT, Gemini, Cursor, and the rest through open, swappable interfaces (OpenAPI, Model Context Protocol) so the model sees your ground truth. Switching tools should not mean starting from zero.

ghostvault.bizs.app — product overview, tutorial (including the Anthropic remote MCP), and blog

What it is: a small Go service plus Postgres (vectors + full-text), hybrid retrieval, and optional encryption at rest (ciphertext on disk until you unlock). Integrations: docs/integration/ (MCP, ChatGPT Actions, Gemini, and similar).

Run it

  1. make setup — creates .env from .env.example if needed; set API keys and DATABASE_URL as documented there.
  2. make up — brings up Postgres, the vault API (gvsvd), an edge reverse proxy on :8989, and (by default) the MCP sidecar and dashboard. Use make to see all targets; details live in docs/deploy.md and docs/README.md.

Dashboard: after make up (dashboard profile on by default), open http://127.0.0.1:8989/dashboard/ — the edge serves /api, /mcp/, and proxies /dashboard/ to the dashboard container (internal :80). For a local Vite UI with hot reload instead, run make dashboard-dev (default :5177, set DASHBOARD_DEV_PORT if needed) and point GHOSTVAULT_BASE_URL / GHOSTVAULT_PROXY_URL at your gvsvd (see .env.example). With make up Dashboard=disable, use dashboard-dev the same way.

Without Docker: copy .env, set DATABASE_URL, go run ./cmd/gvsvd. MCP / IDE setup: docs/integration/Claude-mcp.md.

Product and threat-model depth: docs/OVERVIEW.md · openapi/openapi.yaml. Related (GitS / Ghost): ../gis/docs/design.md.

About

Local memory for the models you already use: hybrid search, encrypted at rest, unlock to work. Only what you send each turn goes out—Claude (MCP), ChatGPT (Actions), same vault.

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages