@smara/paperclip-plugin-memory

@smara/paperclip-plugin-memory

Persistent, decay-aware memory for Paperclip agents — powered by the Smara Memory API.

What it does

Every Paperclip agent gets persistent memory across sessions. Store facts, search by meaning, and recall context — powered by Temporal Memory Scoring™ that makes recent, important memories surface first while stale ones fade naturally.

Install

# From the Paperclip UI
POST /api/plugins/install
{ "packageName": "@smara/paperclip-plugin-memory" }

# Or local development
POST /api/plugins/install
{ "packageName": "/path/to/paperclip-plugin", "isLocalPath": true }

Configuration

In the Paperclip plugin settings:

Setting	Required	Description
smaraApiKeyRef	Yes	Secret reference for your Smara API key
smaraApiUrl	No	API URL (default: https://api.smara.io)
defaultUserId	No	Default user ID when agents don't specify one

Get a free API key at smara.io — 10,000 memories, no credit card.

Tools Available to Agents

Tool	Description
memory-store	Store a fact with importance scoring (0-1)
memory-search	Semantic search with decay-aware ranking
memory-context	Pre-formatted context for agent prompts
memory-delete	Delete a specific memory
memory-usage	Check plan limits and memory count

How Scoring Works

Smara uses Temporal Memory Scoring™ — a proprietary ranking system that balances:

• Semantic relevance — Voyage AI vector embeddings, cosine similarity
• Temporal decay — memories fade over time, modulated by importance
• Access patterns — frequently recalled memories stay stronger
• Contradiction detection — conflicting facts are auto-detected and resolved

License

MIT