Vestige Memory Skill
Cognitive memory system based on 130 years of memory research. FSRS-6 spaced repetition, spreading activation, synaptic tagging—all running 100% local.
Binary Location
~/bin/vestige-mcp
~/bin/vestige
~/bin/vestige-restore
When to Use
- Persistent memory across sessions
- User preferences ("I prefer TypeScript", "I always use dark mode")
- Bug fixes and solutions worth remembering
- Project patterns and architectural decisions
- Reminders and future triggers
Quick Commands
Search Memory
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'
Save Memory (Smart Ingest)
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'
Simple Ingest
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'
Check Stats
~/bin/vestige stats
Health Check
~/bin/vestige health
MCP Tools Available
| 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) |
Trigger Words
| 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 |
Session Start Routine
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'
Helper Script
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
Data Location
- macOS:
~/Library/Application Support/com.vestige.core/ - Linux:
~/.local/share/vestige/ - Embedding cache:
~/Library/Caches/com.vestige.core/fastembed/
Integration Notes
Vestige complements the existing memory/ folder system:
- memory/*.md = Human-readable daily logs
- MEMORY.md = Curated long-term notes
- Vestige = Semantic search + automatic decay + spaced repetition
Use Vestige for:
- Things you want to recall semantically (not just keyword search)
- Preferences that should persist indefinitely
- Solutions worth remembering (with automatic decay if unused)