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)

Vestige