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
CODEBLOCK0
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
CODEBLOCK1
Save Memory (Smart Ingest)
CODEBLOCK2
Simple Ingest
CODEBLOCK3
Check Stats
CODEBLOCK4
Health Check
CODEBLOCK5
MCP Tools Available
| Tool | Description |
|---|
| INLINECODE0 | Unified search (keyword + semantic + hybrid) |
| INLINECODE1 |
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" | INLINECODE8 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:
CODEBLOCK6
Helper Script
For easier usage, create ~/bin/vmem:
CODEBLOCK7
Data Location
- - macOS: INLINECODE14
- Linux: INLINECODE15
- Embedding cache: INLINECODE16
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 记忆技能
基于130年记忆研究的认知记忆系统。FSRS-6间隔重复、扩散激活、突触标记——全部100%本地运行。
二进制位置
~/bin/vestige-mcp
~/bin/vestige
~/bin/vestige-restore
使用时机
- - 跨会话持久记忆
- 用户偏好(我更喜欢TypeScript、我一直使用深色模式)
- 值得记住的Bug修复和解决方案
- 项目模式和架构决策
- 提醒事项和未来触发器
快速命令
搜索记忆
bash
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
保存记忆(智能摄入)
bash
echo {jsonrpc:2.0,id:1,method:tools/call,params:{name:smart_ingest,arguments:{content:用户偏好瑞士现代设计风格用于演示文稿,tags:[preference,design]}}} | ~/bin/vestige-mcp 2>/dev/null | jq -r .result.content[0].text // .error.message
简单摄入
bash
echo {jsonrpc:2.0,id:1,method:tools/call,params:{name:ingest,arguments:{content:TKPay离线项目:概念验证2个月,最小可行产品2个月,预算25万迪拉姆,tags:[project,tkpay]}}} | ~/bin/vestige-mcp 2>/dev/null | jq -r .result.content[0].text // .error.message
检查统计
bash
~/bin/vestige stats
健康检查
bash
~/bin/vestige health
可用MCP工具
| 工具 | 描述 |
|---|
| search | 统一搜索(关键词+语义+混合) |
| smart_ingest |
带重复检测的智能摄入 |
| ingest | 简单记忆存储 |
| memory | 获取、删除或检查记忆状态 |
| codebase | 记住模式和架构决策 |
| intention | 设置提醒和未来触发器 |
| promote_memory | 标记记忆为有用(强化) |
| demote_memory | 标记记忆为错误(弱化) |
触发词
| 用户说 | 操作 |
|---|
| 记住这个 | 立即执行smartingest |
| 别忘了 |
高优先级执行smartingest |
| 我一直... / 我从不... | 保存为偏好 |
| 我更喜欢... / 我喜欢... | 保存为偏好 |
| 这很重要 | 执行smart
ingest + promotememory |
| 提醒我... | 创建intention |
会话启动流程
在对话开始时,搜索相关上下文:
bash
搜索用户偏好
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
搜索项目上下文
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
辅助脚本
为方便使用,创建~/bin/vmem:
bash
#!/bin/bash
Vestige 记忆助手
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 用法: vmem [search|save|stats] [内容]
;;
esac
数据位置
- - macOS: ~/Library/Application Support/com.vestige.core/
- Linux: ~/.local/share/vestige/
- 嵌入缓存: ~/Library/Caches/com.vestige.core/fastembed/
集成说明
Vestige 补充了现有的 memory/ 文件夹系统:
- - memory/*.md = 人类可读的日常日志
- MEMORY.md = 精选的长期笔记
- Vestige = 语义搜索 + 自动衰减 + 间隔重复
使用 Vestige 存储:
- - 你想通过语义(而不仅仅是关键词搜索)回忆的内容
- 应永久保留的偏好
- 值得记住的解决方案(未使用时自动衰减)