memory-forge

MemoryForge

Persistent memory engine for AI agents. 10 MCP tools + 5 auto-engines. Free tier runs locally. Pro tier adds Shelby decentralized cloud sync.

Install

npx memory-forge setup

Auto-configures Claude Code hooks (SessionStart / Stop / PreCompact) and imports existing rules as memories.

Free tier has no external service dependencies. Pro tier requires a SHELBY_API_KEY for Shelby cloud sync.

Core Capabilities

10 MCP Tools (invoked by agent directly):

Tool	Description
memory_store	Store memories with auto-embedding, naming, and dedup merge
memory_search	Semantic search (vector + keyword dual-mode)
memory_recall	Exact recall by memory ID
memory_list	List memories with category/tag filtering + local timezone
memory_forget	Delete a memory (local + Shelby tombstone)
memory_context	Load current session context
memory_export	Export as JSON or Markdown
memory_share	Package a memory for teammate import
memory_update	Update existing memory with re-embedding
memory_model_info	Show embedding model status, dims, and health

5 Auto-Engines (zero user awareness):

Engine	Description
autoName	Extract name from content automatically
autoMerge	Detect >80% overlap and merge duplicates
autoPriority	Priority scoring via access frequency + recency (Ebbinghaus curve)
autoDecay	Auto-archive at 90 days of inactivity
autoCapture	Session-end priority recalc + PreCompact save reminders

Pricing

Tier	Description
Free	9 tools, local storage, unlimited memories
Pro	+ Shelby decentralized cloud sync, cross-device

Pro is currently on Shelbynet testnet.

Tech Stack

• MCP Protocol: @modelcontextprotocol/sdk (stdio transport)
• Embeddings: Transformers.js / Xenova all-MiniLM-L6-v2 (23MB, local, auto-fallback to keyword)
• Cloud (Pro): @shelby-protocol/sdk (Shelbynet / Aptos)
• Runtime: Node.js 18+, TypeScript

Docs

Document	Content
TECHNICAL.md	API reference, data model, architecture, security
TUTORIAL.md	Install guide, daily use, Pro setup, troubleshooting
SPEC.md	Product specification and roadmap
ARCHITECTURE.md	System architecture and data flow
MARKET.md	Competitive analysis

Security

• Free tier is fully local — zero network requests (except one-time 23MB model download)
• Pro tier uploads to Shelby blockchain storage with Aptos transaction proofs
• API key via environment variable; secrets never stored in plaintext
• GDPR right-to-erasure via memory_forget (local + on-chain tombstone)

Tests

npm test   # 319 tests, 31 files, 100% pass