Vestige

---

name: vestige description: Cognitive memory system using FSRS-6 spaced repetition. Memories fade naturally like human memory. Use for persistent recall across sessions.

---

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)