dsh-memory-vault

Usage Tips

• What to store: project decisions and their reasons, pitfalls hit, user preferences, common commands and conventions, experiment conclusions
• When to retrieve: at the start of a new session, when a task arrives with insufficient context, when a historical topic comes up
• Don't over-store: stable engineering rules belong in AGENTS.md-style documents; memory is meant to hold "context that grew out of real work"

Configuration

The config file defaults to /config.json (JSON); VAULT_* environment variables can override it; command-line arguments take the highest precedence. A full example is in config.example.json.

Section	Key	Default	Description
database	dir	~/.memory-vault	data directory
embedding	provider	local	local (built-in hash) / sentence (sentence-transformers) / api (OpenAI-compatible)
embedding	model	per provider	sentence defaults to all-MiniLM-L6-v2; api defaults to text-embedding-3-small
embedding	dims	128	local embedding dimensions
embedding	api_url / api_key / api_model	empty	api provider endpoint; keys support env://VAR, file:///path forms
search	keyword_weight / semantic_weight	0.4 / 0.6	dual-channel fusion weights (auto-clamped to 0~1)
search	recency_days	180	time-decay half-life (days), 0 disables
search	top_k	8	default number of results
curation	dedup_threshold	0.92	write-time dedup similarity threshold
curation	dedup_mode	merge	merge into the existing record / skip keeping the original
curation	cluster_threshold	0.78	tidy clustering threshold
curation	min_cluster	2	minimum cluster size
curation	digest_member_chars	600	characters retained per member record in the summary
web	host / port	127.0.0.1 / 8988	web interface listen address
web	token	empty	when set, all /api/* requests must carry Authorization: Bearer (the UI prompts and remembers it on first request; ?token= query param also supported)

Environment variables: VAULT_DIR, VAULT_CONFIG, VAULT_EMBED_PROVIDER, VAULT_EMBED_MODEL, VAULT_EMBED_DIMS, VAULT_EMBED_API_URL, VAULT_EMBED_API_KEY, VAULT_EMBED_API_MODEL, VAULT_KW_WEIGHT, VAULT_SEM_WEIGHT, VAULT_RECENCY_DAYS, VAULT_TOP_K, VAULT_DEDUP_THRESHOLD, VAULT_DEDUP_MODE, VAULT_CLUSTER_THRESHOLD, VAULT_MIN_CLUSTER, VAULT_DIGEST_MEMBER_CHARS, VAULT_WEB_HOST, VAULT_WEB_PORT, VAULT_WEB_TOKEN.