mirror of https://github.com/samvallad33/vestige.git synced 2026-04-25 00:36:22 +02:00

Sam Valladares eb16d684fc fix: use platform cache dir for fastembed models

Previously, fastembed created .fastembed_cache in the current working
directory, polluting project folders with symlinks.

Now uses platform-appropriate cache directories:
- macOS: ~/Library/Caches/com.vestige.core/fastembed
- Linux: ~/.cache/vestige/fastembed
- Windows: %LOCALAPPDATA%\vestige\cache\fastembed

Can still be overridden with FASTEMBED_CACHE_PATH env var.

Fixes user feedback about .fastembed_cache appearing in random folders.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

2026-01-27 02:32:23 -06:00

5.2 KiB

Raw Blame History

Vestige

Memory that fades like yours does.

The only MCP memory server built on cognitive science. FSRS-6 spaced repetition, spreading activation, synaptic tagging—all running 100% local.

Quick Start

1. Download

macOS (Apple Silicon):

curl -L https://github.com/samvallad33/vestige/releases/latest/download/vestige-mcp-aarch64-apple-darwin.tar.gz | tar -xz
sudo mv vestige-mcp vestige vestige-restore /usr/local/bin/

Other platforms

macOS (Intel):

curl -L https://github.com/samvallad33/vestige/releases/latest/download/vestige-mcp-x86_64-apple-darwin.tar.gz | tar -xz
sudo mv vestige-mcp vestige vestige-restore /usr/local/bin/

Linux:

curl -L https://github.com/samvallad33/vestige/releases/latest/download/vestige-mcp-x86_64-unknown-linux-gnu.tar.gz | tar -xz
sudo mv vestige-mcp vestige vestige-restore /usr/local/bin/

Windows: Download from Releases

Build from source:

git clone https://github.com/samvallad33/vestige && cd vestige
cargo build --release
sudo cp target/release/vestige-mcp /usr/local/bin/

2. Connect to Claude

claude mcp add vestige vestige-mcp -s user

3. Restart & Test

Restart Claude, then:

"Remember that I prefer TypeScript over JavaScript"

New session:

"What are my coding preferences?"

It remembers.

Why Vestige?

Problem	Solution
AI forgets between sessions	Persistent memory with intelligent retrieval
RAG dumps irrelevant context	Prediction Error Gating auto-decides CREATE/UPDATE/SUPERSEDE
Memory bloat eats tokens	FSRS-6 decay naturally fades unused memories
No idea what AI "knows"	`search` tool lets you query anytime
Privacy concerns	100% local after initial setup

Tools

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)

Make Claude Use Vestige Automatically

Add this to your CLAUDE.md:

## Vestige Memory System

At the start of every conversation, check Vestige for context:
1. Recall user preferences and instructions
2. Recall relevant project context
3. Operate in proactive memory mode - save important info without being asked

Trigger Words

User Says	Claude Does
"Remember this"	`smart_ingest` immediately
"I prefer..." / "I always..."	Save as preference
"Remind me..."	Create `intention`
"This is important"	`smart_ingest` + `promote_memory`

Full CLAUDE.md templates →

Troubleshooting

"Command not found" after installation

Ensure vestige-mcp is in PATH:

which vestige-mcp

Or use full path in Claude config:

claude mcp add vestige /full/path/to/vestige-mcp -s user

Model cache location

The embedding model (~130MB) is cached in platform-specific directories:

macOS: ~/Library/Caches/com.vestige.core/fastembed
Linux: ~/.cache/vestige/fastembed
Windows: %LOCALAPPDATA%\vestige\cache\fastembed

Override with: export FASTEMBED_CACHE_PATH=/custom/path

Model download fails

First run requires internet (~130MB). If behind proxy:

export HTTPS_PROXY=your-proxy:port

More troubleshooting →

Documentation

Document	Contents
FAQ	30+ answers to common questions
How It Works	FSRS-6, dual-strength memory, the neuroscience
Storage Modes	Global, per-project, multi-Claude setup
CLAUDE.md Setup	Templates for proactive memory use
Configuration	CLI commands, environment variables
Changelog	Version history

CLI Commands

vestige stats              # Memory statistics
vestige health             # System health check
vestige consolidate        # Run memory maintenance
vestige restore <file>     # Restore from backup

Contributing

Issues and PRs welcome! See CONTRIBUTING.md.

License

MIT OR Apache-2.0 (dual-licensed)

Built by @samvallad33

5.2 KiB Raw Blame History