Cognitive memory system using FSRS-6 spaced repetition. Memories fade naturally like human memory. Use for persistent recall across sessions.
Cognitive memory system based on 130 years of memory research. FSRS-6 spaced repetition, spreading activation, synaptic tagging—all running 100% local.
~/bin/vestige-mcp
~/bin/vestige
~/bin/vestige-restore
echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search","arguments":{"query":"user preferences"}}}' | ~/bin/vestige-mcp 2>/dev/null | jq -r '.result.content[0].text // .error.message'
echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"smart_ingest","arguments":{"content":"User prefers Swiss Modern design style for presentations","tags":["preference","design"]}}}' | ~/bin/vestige-mcp 2>/dev/null | jq -r '.result.content[0].text // .error.message'
echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ingest","arguments":{"content":"TKPay Offline project: POC 2 months, MVP 2 months, budget 250K DH","tags":["project","tkpay"]}}}' | ~/bin/vestige-mcp 2>/dev/null | jq -r '.result.content[0].text // .error.message'
~/bin/vestige stats
~/bin/vestige health
| Tool | Description |
|---|---|
search | Unified search (keyword + semantic + hybrid) |
smart_ingest | Intelligent ingestion with duplicate detection |
ingest | Simple memory storage |
memory | Get, delete, or check memory state |
codebase | Remember patterns and architectural decisions |
intention | Set reminders and future triggers |
promote_memory | Mark memory as helpful (strengthens) |
demote_memory | Mark memory as wrong (weakens) |
| User Says | Action |
|---|---|
| "Remember this" | smart_ingest immediately |
| "Don't forget" | smart_ingest with high priority |
| "I always..." / "I never..." | Save as preference |
| "I prefer..." / "I like..." | Save as preference |
| "This is important" | smart_ingest + promote_memory |
| "Remind me..." | Create intention |
At the start of conversations, search for relevant context:
# Search user preferences
echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search","arguments":{"query":"user preferences instructions"}}}' | ~/bin/vestige-mcp 2>/dev/null | jq -r '.result.content[0].text'
# Search project context
echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search","arguments":{"query":"current project context"}}}' | ~/bin/vestige-mcp 2>/dev/null | jq -r '.result.content[0].text'
For easier usage, create ~/bin/vmem:
#!/bin/bash
# Vestige Memory Helper
ACTION=$1
shift
case $ACTION in
search)
echo "{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\"params\":{\"name\":\"search\",\"arguments\":{\"query\":\"$*\"}}}" | ~/bin/vestige-mcp 2>/dev/null | jq -r '.result.content[0].text // .error.message'
;;
save)
echo "{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\"params\":{\"name\":\"smart_ingest\",\"arguments\":{\"content\":\"$*\"}}}" | ~/bin/vestige-mcp 2>/dev/null | jq -r '.result.content[0].text // .error.message'
;;
stats)
~/bin/vestige stats
;;
*)
echo "Usage: vmem [search|save|stats] [content]"
;;
esac
~/Library/Application Support/com.vestige.core/~/.local/share/vestige/~/Library/Caches/com.vestige.core/fastembed/Vestige complements the existing memory/ folder system:
Use Vestige for: