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

Vestige Memory Skill

Binary Location

When to Use