@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